Terminally closes the socket, resolving once it has been fully torn down. If the socket is already closed, this is a no-op.

Receives a single datagram from the peer, resolving to a ConstBuf view of its data. Resolves to a null ConstBuf when the socket is closed.

Only one Read operation may be pended at a time. Pending a second ReadFuture while one is active will assert.

Warning

The returned ConstBuf is a view into memory provided by the transport and should be processed and destroyed as quickly as reasonably possible to avoid potential head-of-line blocking or exhaustion of transport buffers.

Requests to write a datagram of size at least min_size_bytes, waiting for space to become available.

Resolves to a std::optional<WriteReservation> that allows writing to that buffer, or std::nullopt if the socket has closed.

Multiple reservations or reservation requests can be outstanding at once. If multiple pending requests exist, the order in which they are resolved is not specified.

Warning

Active reservations and pending requests consume transport resources. They should be committed, or canceled as quickly as possible to avoid buffer starvation and transmission stalls.

An empty datagram can be sent by requesting a size of 0. Requesting larger than max_write_message_size_bytes will assert.

Synchronously attempts to reserve space for writing a datagram of at least min_size_bytes.

Returns std::nullopt if space is not immediately available or if the socket is closed.

Warning

Active reservations and pending requests consume transport resources. They should be committed, or canceled as quickly as possible to avoid buffer starvation and transmission stalls.

An empty datagram can be sent by requesting a size of 0. Requesting larger than max_write_message_size_bytes will assert.

Returns a future that resolves when the socket is terminally closed or disconnected.