`TcpStream::set_nonblocking` docs mention non-existent methods

[Imberflur]

Location

rust/library/std/src/net/tcp.rs

Line 564 in a460185

/// This will result in `read`, `write`, `recv` and `send` operations

Summary

The docs mention:

This will result in read, write, recv and send operations becoming nonblocking

However, I can't find any recv or send methods on TcpStream (nor in the traits it implements). Do these operations refer to something else?

[bjorn3]

It is likely referring to the underlying syscalls on UNIX systems.

[the8472]

BSD socket APIs are defined in POSIX, also referenced and extended in various IETF RFCs. Windows also adopted it. So it's pretty much the universal API describing how to interact with various kinds of network sockets.

But at least read does appear in the documentation.
https://doc.rust-lang.org/nightly/std/net/struct.TcpStream.html#method.read-1

[Imberflur]

It is likely referring to the underlying syscalls on UNIX systems.

Oh I see. Thank you for helping with my confusion. I'm happy to close this then (but also fine with keeping it open if it seems worth clarifying this in docs).

[rufevean]

do we just have to add comments to clarfiy better or is there any docs file that we have to change too?