rust/library/std
Patiga adb22b92dd Improve UdpSocket documentation
I tried working with `UdpSocket` and ran into `EINVAL` errors with no
clear indication of what causes the error. Also, it was uncharacteristically
hard to figure this module out, compared to other Rust `std` modules.

1. `send` and `send_to` return a `usize`
This one is just clarity. Usually, returned `usize`s indicate that the
buffer might have only been sent partially. This is not the case with
UDP. Since that `usize` must always be `buffer.len()`, I have documented
that.

2. `bind` limits `connect` and `send_to`
When you bind to a limited address space like localhost, you can only
`connect` to addresses in that same address space. Error kind:
`AddrNotAvailable`.

3. `connect`ing to localhost locks you to localhost
On Linux, if you first `connect` to localhost, subsequent `connect`s to
non-localhost addresses fail. Error kind: `InvalidInput`.

Co-authored-by: Jubilee <46493976+workingjubilee@users.noreply.github.com>
2023-08-22 18:19:49 +02:00
..
benches mv std libs to library/ 2020-07-27 19:51:13 -05:00
primitive_docs Add primitive documentation to libcore 2021-09-12 02:23:08 +00:00
src Improve UdpSocket documentation 2023-08-22 18:19:49 +02:00
tests std: mark common functions in test crate pub(crate) 2023-05-25 08:15:04 -07:00
build.rs wip: Support Apple tvOS in libstd 2023-06-21 14:59:37 -07:00
Cargo.toml use latest version of hermit-abi 2023-07-12 13:15:09 +02:00