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

…

primitive_docs

…

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