From 2dce6fcd89d7735561ce2cae5ce94969d398cd51 Mon Sep 17 00:00:00 2001 From: Weidong Cui Date: Sat, 14 Nov 2026 10:57:59 -0800 Subject: [PATCH 1/4] Check UDP destinations before pending errors A UDP send took the socket's pending error before checking its destination, so a send that its destination fails, such as a broadcast or a policy-denied one, reported and lost the error. Linux checks the destination and route first, and keeps the error. Check them first, and refuse the broadcast address with PolicyDenied (EACCES, as Linux without SO_BROADCAST) rather than InvalidArgument, for sends and connects. Check a broadcast sendto and connect in udp_broker.c in place of the port-0 sendto, which the shim refuses before the broker. Drop the unit check of a failed send while the error is with the transport, which the new order makes no different. Rebuild the Windows runner's udp_broker. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: f5406de6-bab4-4f3b-b232-ae238032c2c2 --- litebox_broker_core/src/socket.rs | 102 +++++++++++------- litebox_broker_protocol/src/socket.rs | 3 +- .../src/socket/tests/udp.rs | 43 +------- .../tests/test-bins/udp_broker | Bin 847136 -> 847136 bytes .../tests/udp_broker.c | 25 +++-- 5 files changed, 83 insertions(+), 90 deletions(-) diff --git a/litebox_broker_core/src/socket.rs b/litebox_broker_core/src/socket.rs index 0cacb892ef..b11b499e31 100644 --- a/litebox_broker_core/src/socket.rs +++ b/litebox_broker_core/src/socket.rs @@ -752,6 +752,9 @@ pub fn create( /// fails every later attempt the same way. UDP connects complete /// synchronously, and a failed attempt preserves the previous peer. Policy /// denial is also a [`SocketOutcome::Failed`] that preserves existing state. +/// A UDP connect to the broadcast address, to which the broker sends no +/// datagrams, is denied so, with `PolicyDenied`, as Linux fails one without +/// `SO_BROADCAST` with `EACCES`. pub fn connect( process: &BrokerProcess, handle: ObjectHandle, @@ -822,6 +825,9 @@ fn connect_datagram( if is_unaddressable(address) { return Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)); } + if is_broadcast(address) { + return Ok(SocketOutcome::Failed(SocketError::PolicyDenied)); + } Ok(match transport_connect(process, object, address)? { SocketOutcome::Completed(SocketConnectionStatus::Failed(error)) => { SocketOutcome::Failed(error) @@ -835,6 +841,12 @@ fn is_unaddressable(address: SocketAddrV4) -> bool { address.port() == 0 || address.ip().is_unspecified() } +/// Returns whether `address` is the broadcast address, to which the broker +/// sends no datagrams, whatever a socket's `Broadcast` option. +fn is_broadcast(address: SocketAddrV4) -> bool { + *address.ip() == Ipv4Addr::BROADCAST +} + /// Reports the progress of a connection attempt. /// /// A connected stream is reported connected, so a later [`connect`] fails @@ -1403,14 +1415,17 @@ fn transport_send( /// Sends `data` as one complete datagram without waiting for readiness. /// -/// A pending error fails the send and is consumed, and a socket shut down for -/// writing fails with `Shutdown`. Without `destination`, an unconnected -/// socket fails with `DestinationAddressRequired`. The first valid send with -/// an explicit destination on an unbound datagram socket reserves and binds a -/// guest-visible local endpoint before invoking the platform. A temporarily -/// full socket fails with a pending error if there is one, and otherwise with -/// [`BrokerError::WouldBlock`], or with [`BrokerError::NonBlockingWouldBlock`] -/// if the socket is non-blocking. +/// The destination is checked first, as on Linux, so a send that it fails +/// leaves any pending error: without `destination`, an unconnected socket +/// fails with `DestinationAddressRequired`, and a send to the broadcast +/// address, to which the broker sends no datagrams, fails with `PolicyDenied`, +/// as Linux fails one without `SO_BROADCAST` with `EACCES`. The first valid +/// send with an explicit destination on an unbound datagram socket reserves +/// and binds a guest-visible local endpoint. Then a pending error fails the +/// send and is consumed, and a socket shut down for writing fails with +/// `Shutdown`. A temporarily full socket fails with a pending error if there +/// is one, and otherwise with [`BrokerError::WouldBlock`], or with +/// [`BrokerError::NonBlockingWouldBlock`] if the socket is non-blocking. pub fn send_to( process: &BrokerProcess, handle: ObjectHandle, @@ -1437,23 +1452,19 @@ fn send_datagram( if !read_socket(object, |socket| is_udp(socket.create_request))? { return Ok(SocketOutcome::Failed(SocketError::InvalidArgument)); } + let destination = match route_datagram(process, object, destination)? { + SocketOutcome::Completed(destination) => destination, + SocketOutcome::Failed(error) => return Ok(SocketOutcome::Failed(error)), + }; + // Linux takes the pending error, and then refuses a socket shut down for + // writing, as it allocates the datagram, after routing it. if let Some(error) = take_pending_error(object) { return Ok(SocketOutcome::Failed(error)); } - let (write_shutdown, view) = - read_socket(object, |socket| (socket.write_shutdown, socket.view()))?; - if write_shutdown { + if read_socket(object, |socket| socket.write_shutdown)? { return Ok(SocketOutcome::Failed(SocketError::Shutdown)); } - if destination.is_none() && view != SocketConnectionStatus::Connected { - return Ok(SocketOutcome::Failed( - SocketError::DestinationAddressRequired, - )); - } - finish_datagram_transfer( - object, - transport_send_to(process, object, data, flags, destination), - ) + finish_datagram_transfer(object, transport_send_to(object, data, flags, destination)) } /// Reports a datagram transfer's pending error in place of a would-block @@ -1477,25 +1488,32 @@ fn finish_datagram_transfer( } } -/// Sends one datagram, first binding an unbound socket. -fn transport_send_to( +/// Checks a datagram's destination, and that the socket has a source for it, +/// first binding an unbound socket, and returns the normalized destination. +fn route_datagram( process: &BrokerProcess, object: &RwLock, - data: &dyn WriteBuffer, - flags: SendFlags, destination: Option, -) -> Result> { - let length = data.len(); - let create_request = read_socket(object, |socket| socket.create_request)?; +) -> Result>> { + let (create_request, view) = + read_socket(object, |socket| (socket.create_request, socket.view()))?; let destination = match destination { + None if view != SocketConnectionStatus::Connected => { + return Ok(SocketOutcome::Failed( + SocketError::DestinationAddressRequired, + )); + } + None => None, Some(destination) if destination.port() == 0 => { return Ok(SocketOutcome::Failed(SocketError::InvalidArgument)); } + Some(destination) if is_broadcast(destination) => { + return Ok(SocketOutcome::Failed(SocketError::PolicyDenied)); + } Some(destination) => match normalize_socket_destination(destination) { Ok(destination) => Some(destination), Err(error) => return Ok(SocketOutcome::Failed(error)), }, - None => None, }; if let Some(destination) = destination { match process.core.policy.authorize_socket_connect( @@ -1510,7 +1528,7 @@ fn transport_send_to( Err(error) => return Err(error), } } - let (resource, needs_bind, nonblocking) = { + let (resource, needs_bind) = { let mut object = object.write(); let ObjectEntry::Socket(socket) = &mut *object else { return Err(BrokerError::InvalidRights); @@ -1531,11 +1549,7 @@ fn transport_send_to( } socket.configuration_in_flight = true; } - ( - Arc::clone(&socket.resource), - needs_bind, - socket.status.nonblocking(), - ) + (Arc::clone(&socket.resource), needs_bind) }; if needs_bind { match reserve_and_bind(process, create_request, &resource, DEFAULT_LOCAL_ADDRESS) { @@ -1564,10 +1578,26 @@ fn transport_send_to( }) { return Ok(SocketOutcome::Failed(SocketError::InvalidArgument)); } - let outcome = resource + Ok(SocketOutcome::Completed(destination)) +} + +/// Sends one datagram to a destination [`route_datagram`] returned. +fn transport_send_to( + object: &RwLock, + data: &dyn WriteBuffer, + flags: SendFlags, + destination: Option, +) -> Result> { + let length = data.len(); + let state = socket_state(object)?; + if state.resource_retired { + return Ok(SocketOutcome::Failed(SocketError::NotConnected)); + } + let outcome = state + .resource .platform_socket .send_to(data, flags, destination) - .map_err(|error| would_block_error(error, nonblocking))?; + .map_err(|error| would_block_error(error, state.nonblocking))?; if let SocketOutcome::Completed(sent) = outcome && sent != length { diff --git a/litebox_broker_protocol/src/socket.rs b/litebox_broker_protocol/src/socket.rs index 7b2ac1229d..1c04a4230b 100644 --- a/litebox_broker_protocol/src/socket.rs +++ b/litebox_broker_protocol/src/socket.rs @@ -290,7 +290,8 @@ pub enum SocketError { /// An argument or socket state is invalid for the operation. #[error("invalid socket operation argument")] InvalidArgument, - /// The policy engine refused the destination. + /// The destination is refused: the policy engine denied it, or it is a + /// broadcast address, to which brokers send no datagrams. #[error("socket policy denied the operation")] PolicyDenied, /// The host stack failed in a way this protocol does not distinguish. diff --git a/litebox_broker_userland/src/socket/tests/udp.rs b/litebox_broker_userland/src/socket/tests/udp.rs index 1d22dfb7d8..d1251b299a 100644 --- a/litebox_broker_userland/src/socket/tests/udp.rs +++ b/litebox_broker_userland/src/socket/tests/udp.rs @@ -1233,11 +1233,11 @@ fn provider_preserves_udp_datagram_semantics() { send_datagram( &process, handle, - b"invalid", + b"broadcast", SendFlags::NONE, Some(SocketAddrV4::new(Ipv4Addr::BROADCAST, 9)), ), - Ok(SocketOutcome::Failed(SocketError::InvalidArgument)) + Ok(SocketOutcome::Failed(SocketError::PolicyDenied)) ); assert_eq!( litebox_broker_core::socket::status(&process, handle) @@ -1352,7 +1352,7 @@ fn provider_preserves_udp_datagram_semantics() { handle, SocketAddrV4::new(Ipv4Addr::BROADCAST, 9), ), - Ok(SocketOutcome::Failed(SocketError::InvalidArgument)) + Ok(SocketOutcome::Failed(SocketError::PolicyDenied)) ); assert_eq!( send_datagram(&process, handle, b"old peer", SendFlags::NONE, None), @@ -1362,43 +1362,6 @@ fn provider_preserves_udp_datagram_semantics() { assert_eq!(&packet[..received], b"old peer"); assert_eq!(socket_address_v4(preserved_source), source); - let (_refusing, refused_address) = crate::test_support::refusing_udp_address(); - assert_eq!( - litebox_broker_core::socket::connect(&process, handle, gateway_address(refused_address)), - Ok(SocketOutcome::Completed(SocketConnectionStatus::Connected)) - ); - assert_eq!( - send_datagram(&process, handle, b"refused", SendFlags::NONE, None,), - Ok(SocketOutcome::Completed(7)) - ); - // Leave the error with the transport so that the failed send queues it. - // A guest cannot arrange this: waiting for the error queues it. - wait_for_readiness_publication(&publications, handle, ReadinessFlags::ERROR); - assert_eq!( - send_datagram( - &process, - handle, - b"broadcast", - SendFlags::NONE, - Some(SocketAddrV4::new(Ipv4Addr::BROADCAST, 9)), - ), - Ok(SocketOutcome::Failed(SocketError::InvalidArgument)) - ); - assert_eq!( - litebox_broker_core::socket::take_error(&process, handle), - Ok(Some(SocketError::ConnectionRefused)) - ); - assert!( - !process - .check_readiness(handle) - .unwrap() - .contains(ReadinessFlags::ERROR) - ); - assert_eq!( - litebox_broker_core::socket::connect(&process, handle, server_address), - Ok(SocketOutcome::Completed(SocketConnectionStatus::Connected)) - ); - assert_eq!( litebox_broker_core::socket::shutdown(&process, handle, ShutdownMode::Write), Ok(SocketOutcome::Completed(())) diff --git a/litebox_runner_linux_on_windows_userland/tests/test-bins/udp_broker b/litebox_runner_linux_on_windows_userland/tests/test-bins/udp_broker index 8a0353f68b533e4ca9c1b171b645ff3b30306882..97844edbe978c6f43e5a818791f2b98ab97be924 100755 GIT binary patch delta 118722 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
    RcdeJ?~=8knJTg6YmSmKz8K< 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

    &bZxJN6%es}Cb%;Wg5 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 KhVJuxk@p`a2xl1p delta 118702 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 Date: Sat, 14 Nov 2026 12:58:47 -0800 Subject: [PATCH 2/4] Let senders choose whether to report pending errors A UDP send took the socket's pending error once its destination was checked, which is one guest OS's rule; others report it at another point or only on receive. Make datagram sends leave pending errors pending unless the new SendFlags::REPORT_PENDING_ERROR asks for one to be reported in place of sending, once the destination is checked and before a write shutdown is. The rule binds the socket providers too: the userland and smoltcp ones take their own cached errors only with the flag, and where a host send takes the host socket's error, as a Linux host's does, the userland one takes it first and keeps it. Stream sends, which have no destination to check first, reject the flag. The Linux shim sets it on UDP sends, so Linux guests see no change. Check that sends without the flag leave the error for a take or a receive, in the core and in both providers. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: f5406de6-bab4-4f3b-b232-ae238032c2c2 --- litebox/src/inet_socket/mod.rs | 16 +- litebox/src/inet_socket/tcp.rs | 15 +- litebox/src/inet_socket/udp.rs | 3 +- litebox_broker_core/src/socket.rs | 61 ++++-- litebox_broker_core/src/socket/tests.rs | 37 +++- litebox_broker_host/src/lib.rs | 6 +- litebox_broker_protocol/src/socket.rs | 22 +- litebox_broker_protocol/src/wire.rs | 9 +- litebox_broker_smoltcp/src/socket.rs | 5 +- litebox_broker_smoltcp/src/tests.rs | 32 ++- litebox_broker_smoltcp/src/udp.rs | 6 +- litebox_broker_userland/src/socket.rs | 21 +- litebox_broker_userland/src/socket/host.rs | 16 +- .../src/socket/host/linux.rs | 11 + .../src/socket/host/windows.rs | 4 + .../src/socket/tests/udp.rs | 199 +++++++++++++++++- litebox_broker_userland/src/socket/udp.rs | 98 +++++++-- litebox_shim_linux/src/syscalls/inet.rs | 8 +- 18 files changed, 482 insertions(+), 87 deletions(-) diff --git a/litebox/src/inet_socket/mod.rs b/litebox/src/inet_socket/mod.rs index a9813bf4b8..6b0d21467b 100644 --- a/litebox/src/inet_socket/mod.rs +++ b/litebox/src/inet_socket/mod.rs @@ -16,7 +16,7 @@ use litebox_broker_protocol::{ error::ErrorCode, fs::{FileOpenFlags, FileStatusFlags}, socket::{ - MAX_TCP_LISTEN_BACKLOG, ShutdownMode, SocketConnectionStatus, + MAX_TCP_LISTEN_BACKLOG, SendFlags as BrokerSendFlags, ShutdownMode, SocketConnectionStatus, SocketError as BrokerSocketError, SocketOptionName, SocketOptionValue, SocketOutcome, SocketType, }, @@ -360,18 +360,22 @@ impl InetSocket { flags: SendFlags, destination: Option, ) -> Result { - if !flags.is_empty() { + if !flags.difference(SendFlags::REPORT_PENDING_ERROR).is_empty() { unimplemented!() } + let mut broker_flags = BrokerSendFlags::NONE; + if flags.contains(SendFlags::REPORT_PENDING_ERROR) { + broker_flags.0 |= BrokerSendFlags::REPORT_PENDING_ERROR.0; + } if let Some(addr) = destination && (addr.port() == 0 || addr.ip().is_unspecified()) { return Err(SocketWriteError::Unaddressable); } if self.is_stream() { - self.write_stream(buf) + self.write_stream(buf, broker_flags) } else { - self.write_datagram(buf, destination) + self.write_datagram(buf, broker_flags, destination) } } @@ -485,6 +489,10 @@ bitflags! { const NOSIGNAL = 0x4000; /// `MSG_OOB`: sends out-of-band data. const OOB = 0x1; + /// Report a pending error in place of sending a datagram, as the + /// broker's [`REPORT_PENDING_ERROR`](BrokerSendFlags::REPORT_PENDING_ERROR) + /// defines. A stream send rejects it. + const REPORT_PENDING_ERROR = 1 << 31; } } diff --git a/litebox/src/inet_socket/tcp.rs b/litebox/src/inet_socket/tcp.rs index 650f6f323f..b82c609613 100644 --- a/litebox/src/inet_socket/tcp.rs +++ b/litebox/src/inet_socket/tcp.rs @@ -134,13 +134,16 @@ impl InetSocket { } /// Writes up to [`MAX_SOCKET_TRANSFER_SIZE`] stream bytes. - pub(super) fn write_stream(&self, buffer: impl WriteBuffer) -> Result { + pub(super) fn write_stream( + &self, + buffer: impl WriteBuffer, + flags: BrokerSendFlags, + ) -> Result { let length = buffer.len().min(MAX_SOCKET_TRANSFER_SIZE as usize); - match self.broker.send_socket( - self.handle, - &buffer.sub_buffer(0, length), - BrokerSendFlags::NONE, - ) { + match self + .broker + .send_socket(self.handle, &buffer.sub_buffer(0, length), flags) + { Ok(SocketOutcome::Completed(sent)) => Ok(sent), Ok(SocketOutcome::Failed(BrokerSocketError::Shutdown)) => { Err(SocketWriteError::WriteShutdown) diff --git a/litebox/src/inet_socket/udp.rs b/litebox/src/inet_socket/udp.rs index 7a7743010c..aff8346c4e 100644 --- a/litebox/src/inet_socket/udp.rs +++ b/litebox/src/inet_socket/udp.rs @@ -63,6 +63,7 @@ impl InetSocket { pub(super) fn write_datagram( &self, buffer: impl WriteBuffer, + flags: BrokerSendFlags, destination: Option, ) -> Result { if buffer.len() > MAX_UDP_DATAGRAM_SIZE as usize { @@ -75,7 +76,7 @@ impl InetSocket { }; match self .broker - .send_to_socket(self.handle, &buffer, BrokerSendFlags::NONE, destination) + .send_to_socket(self.handle, &buffer, flags, destination) { Ok(SocketOutcome::Completed(sent)) => Ok(sent), Ok(SocketOutcome::Failed(BrokerSocketError::Shutdown)) => { diff --git a/litebox_broker_core/src/socket.rs b/litebox_broker_core/src/socket.rs index b11b499e31..2c7aca0e7d 100644 --- a/litebox_broker_core/src/socket.rs +++ b/litebox_broker_core/src/socket.rs @@ -575,6 +575,12 @@ pub trait PlatformSocket: Send + Sync { /// socket shut down for writing fails with `Shutdown`. Partial successful /// sends are invalid. Resource failures are broker errors rather than /// ordinary socket failures. + /// + /// With [`SendFlags::REPORT_PENDING_ERROR`], a pending error the platform + /// holds fails the send in place of sending, and is taken. Without it, the + /// send neither reports nor takes a pending error, which a later status or + /// receive reports: a platform whose host send would take one takes it + /// first and keeps it. fn send_to( &self, data: &dyn WriteBuffer, @@ -1321,9 +1327,10 @@ pub fn accept( /// Sends TCP stream bytes without waiting for readiness. /// -/// A socket shut down for writing fails with `Shutdown` once any connection -/// attempt has finished, and an unconnected socket fails with `NotConnected`. -/// A temporarily full socket, or one whose connection attempt is still being +/// No send flag applies to a stream, so any flag is rejected. A socket shut +/// down for writing fails with `Shutdown` once any connection attempt has +/// finished, and an unconnected socket fails with `NotConnected`. A +/// temporarily full socket, or one whose connection attempt is still being /// started, fails with [`BrokerError::WouldBlock`], or with /// [`BrokerError::NonBlockingWouldBlock`] if the socket is non-blocking. pub fn send( @@ -1332,7 +1339,7 @@ pub fn send( data: &dyn WriteBuffer, flags: SendFlags, ) -> Result> { - if flags.has_unsupported_bits() || data.len() > MAX_SOCKET_TRANSFER_SIZE as usize { + if flags != SendFlags::NONE || data.len() > MAX_SOCKET_TRANSFER_SIZE as usize { return Err(BrokerError::UnsupportedOperation); } let object = process.authorized_object(handle, ObjectRights::WRITE)?; @@ -1415,17 +1422,20 @@ fn transport_send( /// Sends `data` as one complete datagram without waiting for readiness. /// -/// The destination is checked first, as on Linux, so a send that it fails -/// leaves any pending error: without `destination`, an unconnected socket -/// fails with `DestinationAddressRequired`, and a send to the broadcast -/// address, to which the broker sends no datagrams, fails with `PolicyDenied`, -/// as Linux fails one without `SO_BROADCAST` with `EACCES`. The first valid -/// send with an explicit destination on an unbound datagram socket reserves -/// and binds a guest-visible local endpoint. Then a pending error fails the -/// send and is consumed, and a socket shut down for writing fails with -/// `Shutdown`. A temporarily full socket fails with a pending error if there -/// is one, and otherwise with [`BrokerError::WouldBlock`], or with +/// The destination is checked first: without `destination`, an unconnected +/// socket fails with `DestinationAddressRequired`, and a send to the broadcast +/// address, to which the broker sends no datagrams, fails with `PolicyDenied`. +/// The first valid send with an explicit destination on an unbound datagram +/// socket reserves and binds a guest-visible local endpoint. Then a socket +/// shut down for writing fails with `Shutdown`. A temporarily full socket +/// fails with [`BrokerError::WouldBlock`], or with /// [`BrokerError::NonBlockingWouldBlock`] if the socket is non-blocking. +/// +/// A send leaves pending errors pending unless `flags` has +/// [`SendFlags::REPORT_PENDING_ERROR`]. Then, once the destination is checked, +/// a pending error fails the send and is consumed, before a write shutdown +/// does, and a temporarily full socket fails with a pending error if there is +/// one. pub fn send_to( process: &BrokerProcess, handle: ObjectHandle, @@ -1456,25 +1466,32 @@ fn send_datagram( SocketOutcome::Completed(destination) => destination, SocketOutcome::Failed(error) => return Ok(SocketOutcome::Failed(error)), }; - // Linux takes the pending error, and then refuses a socket shut down for - // writing, as it allocates the datagram, after routing it. - if let Some(error) = take_pending_error(object) { + let report_pending_error = flags.contains(SendFlags::REPORT_PENDING_ERROR); + if report_pending_error && let Some(error) = take_pending_error(object) { return Ok(SocketOutcome::Failed(error)); } if read_socket(object, |socket| socket.write_shutdown)? { return Ok(SocketOutcome::Failed(SocketError::Shutdown)); } - finish_datagram_transfer(object, transport_send_to(object, data, flags, destination)) + finish_datagram_transfer( + object, + transport_send_to(object, data, flags, destination), + report_pending_error, + ) } -/// Reports a datagram transfer's pending error in place of a would-block -/// failure, and records any error that follows a failed transfer. +/// Records any error that follows a failed datagram transfer, and, with +/// `report_pending_error`, reports a pending error in place of a would-block +/// failure. fn finish_datagram_transfer( object: &RwLock, result: Result>, + report_pending_error: bool, ) -> Result> { match result { - Err(error @ (BrokerError::WouldBlock | BrokerError::NonBlockingWouldBlock)) => { + Err(error @ (BrokerError::WouldBlock | BrokerError::NonBlockingWouldBlock)) + if report_pending_error => + { match take_pending_error(object) { Some(error) => Ok(SocketOutcome::Failed(error)), None => Err(error), @@ -1785,7 +1802,7 @@ fn receive_datagram( { Ok(SocketOutcome::Failed(SocketError::Shutdown)) } - result => finish_datagram_transfer(object, result), + result => finish_datagram_transfer(object, result, true), } } diff --git a/litebox_broker_core/src/socket/tests.rs b/litebox_broker_core/src/socket/tests.rs index c4fdd7ab3e..ec47ce155f 100644 --- a/litebox_broker_core/src/socket/tests.rs +++ b/litebox_broker_core/src/socket/tests.rs @@ -2751,7 +2751,7 @@ fn check_socket_operations_and_policy(broker: &TestBroker, provider: &TestSocket Ok(SocketOutcome::Completed(())) ); assert_eq!( - send(&process, handle, &[], SendFlags(1)), + send(&process, handle, &[], SendFlags::REPORT_PENDING_ERROR), Err(BrokerError::UnsupportedOperation) ); let in_flight = socket_resource(&process, handle, ObjectRights::WAIT).unwrap(); @@ -3097,7 +3097,7 @@ fn check_udp_socket_operations(broker: &TestBroker, provider: &TestSocketProvide &process, handle, b"udp", - SendFlags(1), + SendFlags(1 << 1), Some(SocketAddrV4::new(Ipv4Addr::LOCALHOST, 53)), ), Err(BrokerError::UnsupportedOperation) @@ -4746,7 +4746,9 @@ fn check_pending_errors_and_readiness(broker: &TestBroker, provider: &TestSocket ); process.close_object_reference(reported).unwrap(); - // A datagram transfer reports a set error before a queued one. + // Without REPORT_PENDING_ERROR, a datagram send leaves pending errors for + // a take or a receive to report, set before queued ones; with it, the + // send reports one in place of sending. let datagram = new_socket(create_udp_request()); assert_eq!( connect(&process, datagram, loopback_address()), @@ -4763,14 +4765,39 @@ fn check_pending_errors_and_readiness(broker: &TestBroker, provider: &TestSocket set_error(&process, datagram, SocketError::ConnectionRefused).unwrap(); assert_eq!( send_to(&process, datagram, &[1], SendFlags::NONE, None), - Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) + Ok(SocketOutcome::Completed(1)) + ); + assert_eq!( + take_error(&process, datagram), + Ok(Some(SocketError::ConnectionRefused)) + ); + assert_eq!( + send_to(&process, datagram, &[1], SendFlags::NONE, None), + Ok(SocketOutcome::Completed(1)) ); assert_eq!( receive_data_from(&process, datagram, 2, ReceiveFromFlags::NONE), Ok(SocketOutcome::Failed(SocketError::NetworkUnreachable)) ); + set_error(&process, datagram, SocketError::ConnectionRefused).unwrap(); + assert_eq!( + send_to( + &process, + datagram, + &[1], + SendFlags::REPORT_PENDING_ERROR, + None + ), + Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) + ); assert_eq!( - send_to(&process, datagram, &[1], SendFlags::NONE, None), + send_to( + &process, + datagram, + &[1], + SendFlags::REPORT_PENDING_ERROR, + None + ), Ok(SocketOutcome::Completed(1)) ); process.close_object_reference(datagram).unwrap(); diff --git a/litebox_broker_host/src/lib.rs b/litebox_broker_host/src/lib.rs index c8cd130091..81aef2b295 100644 --- a/litebox_broker_host/src/lib.rs +++ b/litebox_broker_host/src/lib.rs @@ -74,7 +74,7 @@ use litebox_broker_protocol::socket::{ AcceptSocketResponse, BindSocketResponse, ConnectSocketResponse, CreateSocketResponse, ListenSocketResponse, MAX_SOCKET_PEEK_SIZE, MAX_SOCKET_TRANSFER_SIZE, MAX_TCP_LISTEN_BACKLOG, MAX_UDP_DATAGRAM_SIZE, ReceiveFlags, ReceiveFromSocketResponse, ReceiveSocketResponse, - SendSocketResponse, SendToSocketResponse, SocketOutcome, + SendFlags, SendSocketResponse, SendToSocketResponse, SocketOutcome, }; use litebox_broker_protocol::timer::{ CreateTimerResponse, GetTimerResponse, ReadTimerResponse, SetTimerResponse, @@ -1456,7 +1456,7 @@ fn handle_socket_request( } } SocketRequest::Send(request) => { - if request.flags.has_unsupported_bits() + if request.flags != SendFlags::NONE || request.buffer.length() > MAX_SOCKET_TRANSFER_SIZE { return Err(RequestFailure::Abort(ErrorCode::MalformedRequest)); @@ -1708,7 +1708,7 @@ fn handle_vsock_socket_request( }, ), VsockSocketRequest::Send(request) => { - if request.flags.has_unsupported_bits() { + if request.flags != SendFlags::NONE { return Err(RequestFailure::Abort(ErrorCode::MalformedRequest)); } let data = shared_buffer(shared_buffers, request.buffer, MAX_SOCKET_TRANSFER_SIZE)?; diff --git a/litebox_broker_protocol/src/socket.rs b/litebox_broker_protocol/src/socket.rs index 1c04a4230b..4771da0075 100644 --- a/litebox_broker_protocol/src/socket.rs +++ b/litebox_broker_protocol/src/socket.rs @@ -165,7 +165,7 @@ pub struct Port(pub u16); /// rejects anything outside it rather than masking it away, which would silently /// perform an operation the caller did not ask for. /// -/// No send flag is supported yet, so any nonzero value is rejected. +/// A stream send takes no flag, and rejects any nonzero value. /// /// [`ReadinessFlags`]: crate::readiness::ReadinessFlags #[repr(transparent)] @@ -175,15 +175,33 @@ pub struct SendFlags(pub u32); impl SendFlags { /// No flags. pub const NONE: Self = Self(0); + /// Makes a datagram send report a pending error in place of sending. + /// + /// The send checks its destination first, binding an unbound socket, and + /// then, before checking for a write shutdown, fails with the socket's + /// pending error if it has one, taking it. A send that would block also + /// fails with a pending error if there is one. Without this flag, a + /// datagram send leaves pending errors pending. + /// + /// A stream send rejects it: with no destination to check first, the + /// flag would only take a pending error before sending, which a sender + /// can do itself. + pub const REPORT_PENDING_ERROR: Self = Self(1 << 0); /// Every send flag this protocol version defines. - pub const SUPPORTED: Self = Self(0); + pub const SUPPORTED: Self = Self(Self::REPORT_PENDING_ERROR.0); /// Returns whether any bit outside [`Self::SUPPORTED`] is set. #[must_use] pub const fn has_unsupported_bits(self) -> bool { self.0 & !Self::SUPPORTED.0 != 0 } + + /// Returns whether every flag in `other` is set. + #[must_use] + pub const fn contains(self, other: Self) -> bool { + self.0 & other.0 == other.0 + } } /// Flags for a receive operation. diff --git a/litebox_broker_protocol/src/wire.rs b/litebox_broker_protocol/src/wire.rs index e767b67334..cc94d8c69e 100644 --- a/litebox_broker_protocol/src/wire.rs +++ b/litebox_broker_protocol/src/wire.rs @@ -1573,6 +1573,12 @@ mod tests { buffer, flags: SendFlags(unsupported), })), + BrokerOperation::Socket(SocketRequest::SendTo(SendToSocketRequest { + handle, + buffer, + flags: SendFlags(unsupported), + destination: None, + })), BrokerOperation::Socket(SocketRequest::Receive(ReceiveSocketRequest { handle, buffer, @@ -1598,9 +1604,8 @@ mod tests { assert!(SendFlags(unsupported).has_unsupported_bits()); assert!(ReceiveFlags(unsupported).has_unsupported_bits()); - // No send flag exists yet, so every bit is unsupported there. - assert!(SendFlags(ReceiveFlags::PEEK.0).has_unsupported_bits()); assert!(!SendFlags::NONE.has_unsupported_bits()); + assert!(!SendFlags::REPORT_PENDING_ERROR.has_unsupported_bits()); assert!(!ReceiveFlags::PEEK.has_unsupported_bits()); assert!(ReceiveFlags::PEEK.contains(ReceiveFlags::PEEK)); assert!(!ReceiveFlags::NONE.contains(ReceiveFlags::PEEK)); diff --git a/litebox_broker_smoltcp/src/socket.rs b/litebox_broker_smoltcp/src/socket.rs index 2df6833d4d..bd86084cd0 100644 --- a/litebox_broker_smoltcp/src/socket.rs +++ b/litebox_broker_smoltcp/src/socket.rs @@ -166,12 +166,13 @@ impl PlatformSocket for SmoltcpSocket { fn send_to( &self, data: &dyn WriteBuffer, - _flags: SendFlags, + flags: SendFlags, destination: Option, ) -> BrokerResult> { + let report_pending_error = flags.contains(SendFlags::REPORT_PENDING_ERROR); self.run(|stack| match stack.parts(self.id)?.0 { Kind::Tcp(_) => Ok(invalid()), - Kind::Udp(_) => stack.send_udp(self.id, data, destination), + Kind::Udp(_) => stack.send_udp(self.id, data, destination, report_pending_error), }) } diff --git a/litebox_broker_smoltcp/src/tests.rs b/litebox_broker_smoltcp/src/tests.rs index 42fc06f5a8..255428cc37 100644 --- a/litebox_broker_smoltcp/src/tests.rs +++ b/litebox_broker_smoltcp/src/tests.rs @@ -2193,7 +2193,7 @@ fn a_closing_connection_cannot_be_made_again() { } #[test] -fn a_pending_udp_error_fails_the_next_send() { +fn a_pending_udp_error_fails_only_a_send_that_reports_it() { let wire: &'static Wire = Box::leak(Box::default()); let test = Test::new(Some(wire)); let mut host = Host::new(wire, &test.clock); @@ -2204,22 +2204,36 @@ fn a_pending_udp_error_fails_the_next_send() { core_socket::connect(&process, socket, closed), Ok(SocketOutcome::Completed(SocketConnectionStatus::Connected)) ); - let send = || core_socket::send_to(&process, socket, b"x", SendFlags::NONE, None); + let send = |flags| core_socket::send_to(&process, socket, b"x", flags, None); + let refused = |host: &mut Host| { + pump(&test, host, |_| { + test.published(socket) + .is_some_and(|flags| flags.contains(ReadinessFlags::ERROR)) + }); + }; // Longer than an ICMP error quotes. assert_eq!( core_socket::send_to(&process, socket, &vec![0; 1000], SendFlags::NONE, None), Ok(SocketOutcome::Completed(1000)) ); - pump(&test, &mut host, |_| { - test.published(socket) - .is_some_and(|flags| flags.contains(ReadinessFlags::ERROR)) - }); - // As Linux: the port unreachable fails the next send, once. + refused(&mut host); + // Sends that do not report the port unreachable leave it for a receive. + assert_eq!(send(SendFlags::NONE), Ok(SocketOutcome::Completed(1))); + assert_eq!(send(SendFlags::NONE), Ok(SocketOutcome::Completed(1))); + assert_eq!( + receive_data_from(&process, socket, 100, ReceiveFromFlags::NONE), + Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) + ); + refused(&mut host); + // One that reports it fails with it, once. assert_eq!( - send(), + send(SendFlags::REPORT_PENDING_ERROR), Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) ); - assert_eq!(send(), Ok(SocketOutcome::Completed(1))); + assert_eq!( + send(SendFlags::REPORT_PENDING_ERROR), + Ok(SocketOutcome::Completed(1)) + ); } #[test] diff --git a/litebox_broker_smoltcp/src/udp.rs b/litebox_broker_smoltcp/src/udp.rs index f094526bcb..4cef775909 100644 --- a/litebox_broker_smoltcp/src/udp.rs +++ b/litebox_broker_smoltcp/src/udp.rs @@ -519,11 +519,14 @@ impl Stack { Ok(SocketConnectionStatus::Connected) } + /// Sends a datagram; with `report_pending_error`, a pending error fails + /// the send and is taken, and otherwise it stays pending. pub(super) fn send_udp( &mut self, id: u64, data: &dyn WriteBuffer, destination: Option, + report_pending_error: bool, ) -> BrokerResult> { let process = self.entries.get(&id).ok_or(BrokerError::Internal)?.process; let udp = self.udp_entry(id)?; @@ -541,8 +544,7 @@ impl Stack { Ok(source) => source, Err(error) => return Ok(SocketOutcome::Failed(error)), }; - // As Linux, where allocating the datagram reports it. - if let Some(error) = udp.pending_error.take() { + if report_pending_error && let Some(error) = udp.pending_error.take() { return Ok(SocketOutcome::Failed(error)); } if !is_internal_socket_address(destination) { diff --git a/litebox_broker_userland/src/socket.rs b/litebox_broker_userland/src/socket.rs index 35e2d2167e..272c2b4fdf 100644 --- a/litebox_broker_userland/src/socket.rs +++ b/litebox_broker_userland/src/socket.rs @@ -244,6 +244,8 @@ enum HookPoint { Receiving(u64), /// A TCP receive would block and is about to clear READ. Eagain(u64), + /// A UDP send is about to send through its host socket. + HostSend(u64), /// A socket's host socket refused the guest's TCP options, and the /// socket is about to check whether it may. OptionsRefused(u64), @@ -903,11 +905,12 @@ impl PlatformSocket for UserlandSocket { fn send_to( &self, data: &dyn WriteBuffer, - _flags: SendFlags, + flags: SendFlags, destination: Option, ) -> BrokerResult> { + let report_pending_error = flags.contains(SendFlags::REPORT_PENDING_ERROR); send_from(data, |data| { - self.call(|socket| socket.send_to_socket(data, destination)) + self.call(|socket| socket.send_to_socket(data, destination, report_pending_error)) }) } @@ -1163,15 +1166,18 @@ impl<'a> SocketEntry<'a> { self.bind_tcp_socket(binding, already_bound) } + /// Sends a datagram; with `report_pending_error`, a pending error fails + /// the send and is taken, and otherwise it stays pending. fn send_to_socket( &mut self, data: RawParts<'_>, destination: Option, + report_pending_error: bool, ) -> BrokerResult> { if self.kind() != SocketKind::Udp || data.len() > MAX_UDP_DATAGRAM_SIZE as usize { return Ok(SocketOutcome::Failed(SocketError::InvalidArgument)); } - if let Some(error) = self.take_udp_cached_error() { + if report_pending_error && let Some(error) = self.take_udp_cached_error() { return Ok(SocketOutcome::Failed(error)); } if self.write_shutdown { @@ -1190,9 +1196,12 @@ impl<'a> SocketEntry<'a> { }; match peer { UdpPeer::Internal(destination) => self.send_internal_udp(destination, data), - UdpPeer::External(destination) => { - self.send_to_external_udp(data, destination, authorize_external_reply) - } + UdpPeer::External(destination) => self.send_to_external_udp( + data, + destination, + authorize_external_reply, + report_pending_error, + ), } } diff --git a/litebox_broker_userland/src/socket/host.rs b/litebox_broker_userland/src/socket/host.rs index 6825f4e3d4..02ec4ead44 100644 --- a/litebox_broker_userland/src/socket/host.rs +++ b/litebox_broker_userland/src/socket/host.rs @@ -118,14 +118,20 @@ pub(crate) trait HostErrno: /// A UDP socket reports ICMP errors only while connected, and only those its /// datagrams to its peer cause, a port unreachable as /// [`HostErrno::CONNREFUSED`]. It reports each at most once: a receive that -/// reports one, even a peek, takes it, and so may a send. The rule is the -/// broker's own, whether or not a host's sockets follow it natively. An -/// error that the poller reports on a UDP socket as [`SocketEvents::ERROR`] -/// stays until a call or [`Self::take_error`] takes it, and -/// [`Self::error_pending`] reports it until then. +/// reports one, even a peek, takes it, and so may a send where +/// [`Self::SEND_TAKES_UDP_ERRORS`]. The rule is the broker's own, whether or +/// not a host's sockets follow it natively. An error that the poller reports +/// on a UDP socket as [`SocketEvents::ERROR`] stays until a call or +/// [`Self::take_error`] takes it, and [`Self::error_pending`] reports it +/// until then. pub(crate) trait HostSocket: Sized + Send { type Errno; + /// Whether a UDP send may take the socket's pending error and fail with + /// it. A UDP send fails with [`HostErrno::CONNREFUSED`] only by taking + /// one. + const SEND_TAKES_UDP_ERRORS: bool; + /// Opens a TCP socket. fn tcp() -> Result; diff --git a/litebox_broker_userland/src/socket/host/linux.rs b/litebox_broker_userland/src/socket/host/linux.rs index 9b8cfabbf0..8dc9abdbe6 100644 --- a/litebox_broker_userland/src/socket/host/linux.rs +++ b/litebox_broker_userland/src/socket/host/linux.rs @@ -115,9 +115,20 @@ impl Socket { } } +#[cfg(test)] +impl Socket { + /// Opens another handle to the same host socket. + pub(crate) fn try_clone_udp(&self) -> IoResult { + Ok(self.0.try_clone()?.into()) + } +} + impl HostSocket for Socket { type Errno = Errno; + /// Allocating the datagram takes and reports the socket's pending error. + const SEND_TAKES_UDP_ERRORS: bool = true; + fn tcp() -> Result { Self::open(SocketType::STREAM, ipproto::TCP) } diff --git a/litebox_broker_userland/src/socket/host/windows.rs b/litebox_broker_userland/src/socket/host/windows.rs index a89d1a6378..3366aaa39a 100644 --- a/litebox_broker_userland/src/socket/host/windows.rs +++ b/litebox_broker_userland/src/socket/host/windows.rs @@ -302,6 +302,10 @@ impl Socket { impl HostSocket for Socket { type Errno = Errno; + /// Winsock queues a UDP socket's ICMP errors among its datagrams, for + /// receives to report. + const SEND_TAKES_UDP_ERRORS: bool = false; + fn tcp() -> Result { let socket = open(Type::STREAM, Protocol::TCP)?; Ok(Self::new(Source::Tcp(TcpStream::from_std(socket.into())))) diff --git a/litebox_broker_userland/src/socket/tests/udp.rs b/litebox_broker_userland/src/socket/tests/udp.rs index d1251b299a..c189944ed6 100644 --- a/litebox_broker_userland/src/socket/tests/udp.rs +++ b/litebox_broker_userland/src/socket/tests/udp.rs @@ -749,7 +749,13 @@ fn unmatched_guest_udp_destinations_are_port_unreachable() { ); assert!(has_error()); assert_eq!( - send_datagram(&process, socket, b"blocked", SendFlags::NONE, None), + send_datagram( + &process, + socket, + b"blocked", + SendFlags::REPORT_PENDING_ERROR, + None + ), Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) ); assert!(!has_error()); @@ -783,6 +789,181 @@ fn unmatched_guest_udp_destinations_are_port_unreachable() { ); } +/// Sends that do not report pending errors leave a refusal pending, whether +/// the provider or the host socket holds it, for a later call to report. +#[test] +fn unreported_udp_refusals_stay_pending_across_sends() { + let provider = Arc::new(UserlandSocketProvider::new(3, 3).unwrap()); + let broker = test_broker_core( + PolicyEngine::with_unauthenticated_rights(ObjectRights::all()) + .with_socket_policy(gateway_udp_policy()), + BrokerCoreLimits::new_with_all_limits(6, 0, 3, 3), + provider.clone(), + ) + .unwrap(); + let process = broker + .create_process(CallerCredential::Unauthenticated) + .unwrap(); + let (published, publications) = channel(); + let (retired, _retirements) = channel(); + let readiness = Arc::new(TestReadinessSink { published, retired }); + let send = |socket| send_datagram(&process, socket, b"refused", SendFlags::NONE, None); + + // The provider holds the refusal of a guest port that no socket is bound + // to. Once one is, sends reach it and leave the refusal. + let internal_peer = SocketAddrV4::new(Ipv4Addr::LOCALHOST, 4000); + let internal = create_udp_socket(&process, readiness.clone()); + assert_eq!( + litebox_broker_core::socket::connect(&process, internal, internal_peer), + Ok(SocketOutcome::Completed(SocketConnectionStatus::Connected)) + ); + assert_eq!(send(internal), Ok(SocketOutcome::Completed(7))); + let receiver = create_udp_socket(&process, readiness.clone()); + assert_eq!( + litebox_broker_core::socket::bind(&process, receiver, internal_peer), + Ok(SocketOutcome::Completed(internal_peer)) + ); + for _ in 0..2 { + assert_eq!(send(internal), Ok(SocketOutcome::Completed(7))); + } + assert_eq!( + litebox_broker_core::socket::take_error(&process, internal), + Ok(Some(SocketError::ConnectionRefused)) + ); + for _ in 0..2 { + assert!(matches!( + receive_datagram_into(&process, receiver, &mut [0; 7], ReceiveFromFlags::NONE), + Ok(SocketOutcome::Completed(PlatformDatagramReceive { + received: 7, + .. + })) + )); + } + + // A host port's refusal stays pending too, though a host send could + // take it: a send takes it from the host socket first, so the host send + // meets no refusal. Once a socket is bound to the port, sends reach it + // and leave the refusal. + let (refusing, refused_address) = crate::test_support::refusing_udp_address(); + let external = create_udp_socket(&process, readiness); + assert_eq!( + litebox_broker_core::socket::connect(&process, external, gateway_address(refused_address)), + Ok(SocketOutcome::Completed(SocketConnectionStatus::Connected)) + ); + assert_eq!(send(external), Ok(SocketOutcome::Completed(7))); + wait_for_readiness_publication(&publications, external, ReadinessFlags::ERROR); + drop(refusing); + let host_peer = UdpSocket::bind(refused_address).unwrap(); + host_peer.set_read_timeout(Some(TEST_TIMEOUT)).unwrap(); + let hook = TestHook::install(&provider); + for _ in 0..2 { + assert_eq!(send(external), Ok(SocketOutcome::Completed(7))); + } + assert_eq!(host_sends(&hook), 2); + assert_eq!( + receive_datagram_into(&process, external, &mut [0; 7], ReceiveFromFlags::NONE), + Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) + ); + for _ in 0..2 { + assert_eq!(host_peer.recv(&mut [0; 7]).unwrap(), 7); + } +} + +/// How many host sends UDP sends made since `hook` was installed. +fn host_sends(hook: &TestHook) -> usize { + hook.points + .lock() + .unwrap() + .iter() + .filter(|point| matches!(point, HookPoint::HostSend(_))) + .count() +} + +/// A send that leaves pending errors keeps each refusal that reaches the +/// host socket just before a host send would take it, and still sends. +// Only a Linux host send takes the host socket's error. +#[cfg(target_os = "linux")] +#[test] +fn late_udp_refusals_stay_pending_while_the_datagram_is_sent() { + use rustix::event::{PollFd, PollFlags, Timespec, poll}; + + let provider = Arc::new(UserlandSocketProvider::new(1, 1).unwrap()); + let broker = test_broker_core( + PolicyEngine::with_unauthenticated_rights(ObjectRights::all()) + .with_socket_policy(gateway_udp_policy()), + BrokerCoreLimits::new_with_all_limits(2, 0, 1, 1), + provider.clone(), + ) + .unwrap(); + let process = broker + .create_process(CallerCredential::Unauthenticated) + .unwrap(); + let (published, _publications) = channel(); + let (retired, _retirements) = channel(); + let socket = create_udp_socket(&process, Arc::new(TestReadinessSink { published, retired })); + // Connected to itself, the host peer refuses the guest's datagrams. + let peer = Arc::new(UdpSocket::bind((Ipv4Addr::LOCALHOST, 0)).unwrap()); + let peer_address = socket_address_v4(peer.local_addr().unwrap()); + peer.connect(peer_address).unwrap(); + peer.set_read_timeout(Some(TEST_TIMEOUT)).unwrap(); + assert_eq!( + litebox_broker_core::socket::connect(&process, socket, gateway_address(peer_address)), + Ok(SocketOutcome::Completed(SocketConnectionStatus::Connected)) + ); + let guest_port = litebox_broker_core::socket::status(&process, socket) + .unwrap() + .local_address + .unwrap() + .port(); + let host_socket = provider.core.udp_native_endpoint_handle(guest_port); + let host_source = SocketAddrV4::new( + Ipv4Addr::LOCALHOST, + host_socket.local_addr().unwrap().port(), + ); + + // Before each of the first two host sends, the peer refuses a datagram + // from the same host socket, so the refusal arrives after the send's + // take. Then the peer accepts the host socket's datagrams. + let hook = TestHook::install(&provider); + let accepting_peer = Arc::clone(&peer); + let host_sends_seen = AtomicUsize::new(0); + hook.act(move |_, _, point| { + if !matches!(point, HookPoint::HostSend(_)) { + return; + } + if host_sends_seen.fetch_add(1, Ordering::Relaxed) == 2 { + accepting_peer.connect(host_source).unwrap(); + return; + } + host_socket.send(b"late").unwrap(); + wait_until( + || { + let mut sockets = [PollFd::new(&host_socket, PollFlags::empty())]; + let now = Timespec { + tv_sec: 0, + tv_nsec: 0, + }; + poll(&mut sockets, Some(&now)).unwrap(); + sockets[0].revents().contains(PollFlags::ERR) + }, + "the refusal reached the host socket", + ); + }); + assert_eq!( + send_datagram(&process, socket, b"refused", SendFlags::NONE, None), + Ok(SocketOutcome::Completed(7)) + ); + hook.stop(); + assert_eq!(host_sends(&hook), 3); + let mut payload = [0; 7]; + assert_eq!(peer.recv(&mut payload).unwrap(), 7); + assert_eq!(&payload, b"refused"); + assert_eq!( + receive_datagram_into(&process, socket, &mut [0; 7], ReceiveFromFlags::NONE), + Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) + ); +} + #[test] fn udp_status_republishes_when_another_error_remains_pending() { let provider = Arc::new(UserlandSocketProvider::new(1, 1).unwrap()); @@ -2402,7 +2583,13 @@ fn connected_guest_udp_enforces_barriers_peek_and_peer_addresses() { Ok(SocketOutcome::Completed(4)) ); assert_eq!( - send_datagram(&first_process, first, b"refused", SendFlags::NONE, None), + send_datagram( + &first_process, + first, + b"refused", + SendFlags::REPORT_PENDING_ERROR, + None + ), Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) ); let replacement = create_udp_socket(&second_process, readiness); @@ -2526,7 +2713,13 @@ fn connected_guest_udp_filters_other_wildcard_peer_aliases() { Ok(SocketOutcome::Completed(11)) ); assert_eq!( - send_datagram(&process, sender, b"wrong alias", SendFlags::NONE, None), + send_datagram( + &process, + sender, + b"wrong alias", + SendFlags::REPORT_PENDING_ERROR, + None + ), Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) ); } diff --git a/litebox_broker_userland/src/socket/udp.rs b/litebox_broker_userland/src/socket/udp.rs index 5a09f576dd..ddefa38df3 100644 --- a/litebox_broker_userland/src/socket/udp.rs +++ b/litebox_broker_userland/src/socket/udp.rs @@ -32,10 +32,10 @@ use super::host::{ Errno, HostErrno as _, HostPoller as _, HostSocket as _, Interest, Poller, Socket, SocketEvents, }; use super::{ - PlatformSocketStatus, ProviderCore, ReceiveFromOutcome, SocketEntry, SocketInbox, Topology, - broker_error_from_errno, local_socket_address, lock, read_lock, republish_own_readiness, - set_own_readiness, socket_error_from_errno, socket_operation_error_from_errno, write_lock, - zeroed_vec, + HookPoint, PlatformSocketStatus, ProviderCore, ReceiveFromOutcome, SocketEntry, SocketInbox, + Topology, broker_error_from_errno, local_socket_address, lock, read_lock, + republish_own_readiness, set_own_readiness, socket_error_from_errno, + socket_operation_error_from_errno, write_lock, zeroed_vec, }; pub(super) const MAX_REJECTED_UDP_DATAGRAMS_PER_COMMAND: usize = 64; @@ -1043,19 +1043,23 @@ impl SocketEntry<'_> { /// Sends a datagram to an external host, staging the socket's native /// endpoint first if needed. With `authorize_reply`, the socket also - /// accepts replies from the destination. + /// accepts replies from the destination. With `report_pending_error`, a + /// pending error fails the send and is taken, and otherwise it stays + /// pending. pub(super) fn send_to_external_udp( &mut self, data: RawParts<'_>, external_destination: SocketAddrV4, authorize_reply: bool, + report_pending_error: bool, ) -> BrokerResult> { let added_peer = authorize_reply && match self.reserve_udp_external_peer(external_destination)? { SocketOutcome::Completed(added) => added, SocketOutcome::Failed(error) => return Ok(SocketOutcome::Failed(error)), }; - let outcome = self.stage_and_send_external_udp(data, external_destination); + let outcome = + self.stage_and_send_external_udp(data, external_destination, report_pending_error); if added_peer && !matches!(outcome, Ok(SocketOutcome::Completed(_))) { self.remove_udp_external_peer(external_destination); } @@ -1066,6 +1070,7 @@ impl SocketEntry<'_> { &mut self, data: RawParts<'_>, external_destination: SocketAddrV4, + report_pending_error: bool, ) -> BrokerResult> { if self.udp_state()?.native_endpoint.is_none() { let endpoint = match self.stage_udp_endpoint(external_destination, None)? { @@ -1074,7 +1079,7 @@ impl SocketEntry<'_> { }; self.replace_udp_endpoint(Some(endpoint))?; } - self.send_external_udp(data, external_destination) + self.send_external_udp(data, external_destination, report_pending_error) } /// Creates a native endpoint on a host port that no guest peer refers to. @@ -1522,6 +1527,16 @@ impl SocketEntry<'_> { } } + /// Keeps an error taken from the host socket for a later call to report. + fn keep_udp_endpoint_error(&mut self, error: SocketError) -> BrokerResult<()> { + let endpoint = self.udp_endpoint_mut()?; + endpoint.error.record_consumed(error); + endpoint.readable = true; + // The error is already kept; ignore a failure to recompute readiness. + let _ = self.publish_udp_readiness(); + Ok(()) + } + /// Discards queued native datagrams the socket does not accept, leaving /// the endpoint readable only if an accepted datagram or an error is at /// the head. @@ -1564,20 +1579,32 @@ impl SocketEntry<'_> { Ok(()) } + /// Sends a datagram through the socket's native endpoint. With + /// `report_pending_error`, a pending error fails the send and is taken, + /// and otherwise it stays pending. pub(super) fn send_external_udp( &mut self, data: RawParts<'_>, external_destination: SocketAddrV4, + report_pending_error: bool, ) -> BrokerResult> { - if let Some(error) = self.take_consumed_udp_endpoint_error()? { + if report_pending_error && let Some(error) = self.take_consumed_udp_endpoint_error()? { return Ok(SocketOutcome::Failed(error)); } + // Where a host send takes the host socket's pending error and fails + // with it, a send that leaves pending errors takes the error first, + // and keeps it. + let keep_host_error = !report_pending_error && Socket::SEND_TAKES_UDP_ERRORS; + if keep_host_error && let Some(error) = take_udp_socket_error(&self.udp_endpoint()?.socket)? + { + self.keep_udp_endpoint_error(error)?; + } let destination = host_socket_destination(external_destination); let past_peer = matches!( self.udp_state()?.peer, Some(UdpPeer::External(peer)) if host_socket_destination(peer) != destination ); - let result = { + let (result, late_refusal) = { // Hold the port set so no broker endpoint appears on the // destination port between the check and the send. let ports = read_lock(&self.core().udp_ports); @@ -1585,7 +1612,7 @@ impl SocketEntry<'_> { return Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)); } let socket = &self.udp_endpoint()?.socket; - loop { + let send = || loop { let sent = if past_peer { socket.send_as_unconnected(data, destination) } else { @@ -1600,8 +1627,34 @@ impl SocketEntry<'_> { break socket_operation_error_from_errno(error).map(SocketOutcome::Failed); } } - } + }; + let mut late_refusal = false; + let result = loop { + self.core().hook(HookPoint::HostSend(self.id())); + match send() { + // An error may still reach the host socket after the + // take above, and a host send takes it. A host send fails + // with a refusal only by taking one, so such refusals are + // kept, as one, and the datagram sent again until a host + // send succeeds or fails otherwise. Each refusal takes an + // error that reached the host socket since the take or + // the last host send, so only a flood of ICMP errors from + // the host's network could keep this going. Another error + // that arrives so fails the send, since a host send can + // also fail so on its own, as without a route. + Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) + if keep_host_error => + { + late_refusal = true; + } + result => break result, + } + }; + (result, late_refusal) }; + if late_refusal { + self.keep_udp_endpoint_error(SocketError::ConnectionRefused)?; + } match result { Err(BrokerError::WouldBlock) => { self.udp_endpoint_mut()?.write_blocked = true; @@ -1610,9 +1663,12 @@ impl SocketEntry<'_> { } // A send may take the error the host socket had pending, as a // receive does. If it did not, rearming reports the error again. - Ok(SocketOutcome::Failed(error)) if self.udp_endpoint()?.error.is_pending() => self - .finish_udp_endpoint_error(error) - .map(SocketOutcome::Failed), + Ok(SocketOutcome::Failed(error)) + if report_pending_error && self.udp_endpoint()?.error.is_pending() => + { + self.finish_udp_endpoint_error(error) + .map(SocketOutcome::Failed) + } result => result, } } @@ -1824,6 +1880,20 @@ impl ProviderCore { result } + /// Opens another handle to the host socket under the UDP socket bound + /// to `guest_port`. + #[cfg(target_os = "linux")] + pub(super) fn udp_native_endpoint_handle(&self, guest_port: u16) -> std::net::UdpSocket { + self.with_udp_socket(guest_port, |socket| { + socket + .udp_endpoint()? + .socket + .try_clone_udp() + .map_err(|_| BrokerError::Internal) + }) + .unwrap() + } + pub(super) fn inject_udp_status_errors( &self, guest_port: u16, diff --git a/litebox_shim_linux/src/syscalls/inet.rs b/litebox_shim_linux/src/syscalls/inet.rs index d92b2d1789..dd3d6eb694 100644 --- a/litebox_shim_linux/src/syscalls/inet.rs +++ b/litebox_shim_linux/src/syscalls/inet.rs @@ -389,7 +389,7 @@ impl InetSocket { if !self.is_stream() && buf.len() > inet_socket::MAX_UDP_DATAGRAM_SIZE { return Err(Errno::EMSGSIZE); } - let send_flags = convert_flags!( + let mut send_flags = convert_flags!( flags, SendFlags, inet_socket::SendFlags, @@ -399,6 +399,12 @@ impl InetSocket { MORE, OOB, ); + // Like Linux, a UDP send fails with a pending error, such as one from + // an ICMP error, taking it, once its destination is checked and + // before a write shutdown is. + if !self.is_stream() { + send_flags |= inet_socket::SendFlags::REPORT_PENDING_ERROR; + } let is_empty_stream = buf.is_empty() && self.is_stream(); let (result, timeout) = self.wait( cx, From 30364e28c7c91ab0f6981b345cc54658d2aeb6ec Mon Sep 17 00:00:00 2001 From: Weidong Cui Date: Sat, 14 Nov 2026 16:03:20 -0800 Subject: [PATCH 3/4] Rearm UDP writes while a kept error waits A UDP endpoint was not watched again while it had an error pending. A send that would block while the endpoint kept an error, as a send without REPORT_PENDING_ERROR leaves one, then never learned that the host could send until a call took the error. Only an error the host socket still holds must stop the watch, which would report it again at once. Watch again while the endpoint keeps the error, and take an error that reaches the host socket meanwhile, coalescing it into the kept one, so that the watch does not report it over and over. Check that such a send learns when it can send, with the error kept, and that a later host error is taken at once. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: f5406de6-bab4-4f3b-b232-ae238032c2c2 --- litebox_broker_userland/src/socket.rs | 5 ++ .../src/socket/tests/udp.rs | 83 +++++++++++++++++++ litebox_broker_userland/src/socket/udp.rs | 37 +++++++-- 3 files changed, 120 insertions(+), 5 deletions(-) diff --git a/litebox_broker_userland/src/socket.rs b/litebox_broker_userland/src/socket.rs index 272c2b4fdf..1d3ea0870e 100644 --- a/litebox_broker_userland/src/socket.rs +++ b/litebox_broker_userland/src/socket.rs @@ -171,6 +171,9 @@ struct ProviderCore { /// Test callback run at every [`HookPoint`]. #[cfg(test)] hook: RwLock>, + /// Makes the next UDP host send would block, for tests. + #[cfg(test)] + block_next_udp_send: AtomicBool, } /// Socket counts, guest bindings, and peer links shared between sockets. @@ -372,6 +375,8 @@ impl ProviderCore { thread: Mutex::new(None), #[cfg(test)] hook: RwLock::new(None), + #[cfg(test)] + block_next_udp_send: AtomicBool::new(false), }); let weak = Arc::downgrade(&core); let (started, startup) = sync_channel(1); diff --git a/litebox_broker_userland/src/socket/tests/udp.rs b/litebox_broker_userland/src/socket/tests/udp.rs index c189944ed6..914c31d292 100644 --- a/litebox_broker_userland/src/socket/tests/udp.rs +++ b/litebox_broker_userland/src/socket/tests/udp.rs @@ -964,6 +964,89 @@ fn late_udp_refusals_stay_pending_while_the_datagram_is_sent() { ); } +/// A send that would block while the socket keeps an error still learns +/// when the host socket can send, without a call that checks or takes the +/// error, and the error stays pending. +#[test] +fn udp_write_wait_is_published_while_an_error_is_kept() { + let provider = Arc::new(UserlandSocketProvider::new(1, 1).unwrap()); + let broker = test_broker_core( + PolicyEngine::with_unauthenticated_rights(ObjectRights::all()) + .with_socket_policy(gateway_udp_policy()), + BrokerCoreLimits::new_with_all_limits(2, 0, 1, 1), + provider.clone(), + ) + .unwrap(); + let process = broker + .create_process(CallerCredential::Unauthenticated) + .unwrap(); + let (published, publications) = channel(); + let (retired, _retirements) = channel(); + let socket = create_udp_socket(&process, Arc::new(TestReadinessSink { published, retired })); + // Connected to itself, the host peer refuses the guest's datagrams. + let peer = UdpSocket::bind((Ipv4Addr::LOCALHOST, 0)).unwrap(); + let peer_address = socket_address_v4(peer.local_addr().unwrap()); + peer.connect(peer_address).unwrap(); + assert_eq!( + litebox_broker_core::socket::connect(&process, socket, gateway_address(peer_address)), + Ok(SocketOutcome::Completed(SocketConnectionStatus::Connected)) + ); + #[cfg(target_os = "linux")] + let host_socket = provider.core.udp_native_endpoint_handle( + litebox_broker_core::socket::status(&process, socket) + .unwrap() + .local_address + .unwrap() + .port(), + ); + let send = || send_datagram(&process, socket, b"refused", SendFlags::NONE, None); + assert_eq!(send(), Ok(SocketOutcome::Completed(7))); + wait_for_readiness_publication(&publications, socket, ReadinessFlags::ERROR); + + // The send keeps the refusal, and its host send would block. + provider + .core + .block_next_udp_send + .store(true, Ordering::Relaxed); + assert_eq!(send(), Err(BrokerError::WouldBlock)); + let mut blocked = false; + loop { + let (handle, readiness) = publications.recv_timeout(TEST_TIMEOUT).unwrap(); + if handle != socket { + continue; + } + if !readiness.contains(ReadinessFlags::WRITE) { + blocked = true; + } else if blocked { + break; + } + } + + // An error that reaches the host socket while the endpoint keeps one is + // taken at once, rather than reported over and over. + #[cfg(target_os = "linux")] + { + use rustix::event::{PollFd, PollFlags, Timespec, poll}; + + let hook = TestHook::install(&provider); + let start = hook.len(); + host_socket.send(b"late").unwrap(); + hook.wait_for_received_handled(start, |token| token & UDP_EVENT_TOKEN_FLAG != 0); + let mut sockets = [PollFd::new(&host_socket, PollFlags::empty())]; + let now = Timespec { + tv_sec: 0, + tv_nsec: 0, + }; + poll(&mut sockets, Some(&now)).unwrap(); + assert!(!sockets[0].revents().contains(PollFlags::ERR)); + } + + assert_eq!( + receive_datagram_into(&process, socket, &mut [0; 7], ReceiveFromFlags::NONE), + Ok(SocketOutcome::Failed(SocketError::ConnectionRefused)) + ); +} + #[test] fn udp_status_republishes_when_another_error_remains_pending() { let provider = Arc::new(UserlandSocketProvider::new(1, 1).unwrap()); diff --git a/litebox_broker_userland/src/socket/udp.rs b/litebox_broker_userland/src/socket/udp.rs index ddefa38df3..3c368604e2 100644 --- a/litebox_broker_userland/src/socket/udp.rs +++ b/litebox_broker_userland/src/socket/udp.rs @@ -559,6 +559,12 @@ impl UdpNativeErrorState { !matches!(self, Self::None) } + /// Whether the host socket still holds the error, so that watching the + /// socket would report it again at once. + const fn is_held_by_host(self) -> bool { + matches!(self, Self::PendingKernel) + } + fn record_kernel(&mut self) { if matches!(self, Self::None) { *self = Self::PendingKernel; @@ -1404,7 +1410,17 @@ impl SocketEntry<'_> { } if error_event { endpoint.readable = true; - endpoint.error.record_kernel(); + if endpoint.error.consumed().is_some() { + // An error reached the host socket, watched while the endpoint + // keeps an older one. Take it, to coalesce into the kept one, + // so that watching the socket does not report it again at + // once. + if let Some(error) = take_udp_socket_error(&endpoint.socket)? { + endpoint.error.record_consumed(error); + } + } else { + endpoint.error.record_kernel(); + } } if readable_event && !error_event { self.drain_rejected_external_datagrams()?; @@ -1422,7 +1438,10 @@ impl SocketEntry<'_> { let Some(endpoint) = self.udp_state_mut()?.native_endpoint.as_mut() else { return Ok(()); }; - if endpoint.error.is_pending() { + // Watching the socket would report an error it holds again at once, + // so wait for a call to take it. One the endpoint keeps, the socket + // no longer holds. + if endpoint.error.is_held_by_host() { return Ok(()); } let interest = udp_rearm_interest(read_shutdown, endpoint.readable, endpoint.write_blocked); @@ -1440,7 +1459,7 @@ impl SocketEntry<'_> { udp_endpoint_needs_rearm( endpoint.readable, endpoint.write_blocked, - endpoint.error.is_pending(), + endpoint.error.is_held_by_host(), ) }); if should_rearm { @@ -1613,6 +1632,14 @@ impl SocketEntry<'_> { } let socket = &self.udp_endpoint()?.socket; let send = || loop { + #[cfg(test)] + if self + .core() + .block_next_udp_send + .swap(false, Ordering::Relaxed) + { + break Err(BrokerError::WouldBlock); + } let sent = if past_peer { socket.send_as_unconnected(data, destination) } else { @@ -2022,8 +2049,8 @@ fn take_udp_socket_error(socket: &Socket) -> BrokerResult> { } } -fn udp_endpoint_needs_rearm(readable: bool, waiting_for_write: bool, pending_error: bool) -> bool { - !pending_error && (!readable || waiting_for_write) +fn udp_endpoint_needs_rearm(readable: bool, waiting_for_write: bool, host_error: bool) -> bool { + !host_error && (!readable || waiting_for_write) } fn udp_rearm_interest(read_shutdown: bool, readable: bool, waiting_for_write: bool) -> Interest { From 8528b578954b52a77d36c3d9f223400cb1552597 Mon Sep 17 00:00:00 2001 From: Weidong Cui Date: Sat, 14 Nov 2026 19:31:37 -0800 Subject: [PATCH 4/4] Use the shared refused UDP port in the write-wait test A UDP socket connected to itself refuses datagrams only on Linux, so use refusing_udp_address() and keep Windows coverage of the fix. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: f5406de6-bab4-4f3b-b232-ae238032c2c2 --- litebox_broker_userland/src/socket/tests/udp.rs | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/litebox_broker_userland/src/socket/tests/udp.rs b/litebox_broker_userland/src/socket/tests/udp.rs index 914c31d292..e48063e565 100644 --- a/litebox_broker_userland/src/socket/tests/udp.rs +++ b/litebox_broker_userland/src/socket/tests/udp.rs @@ -983,12 +983,9 @@ fn udp_write_wait_is_published_while_an_error_is_kept() { let (published, publications) = channel(); let (retired, _retirements) = channel(); let socket = create_udp_socket(&process, Arc::new(TestReadinessSink { published, retired })); - // Connected to itself, the host peer refuses the guest's datagrams. - let peer = UdpSocket::bind((Ipv4Addr::LOCALHOST, 0)).unwrap(); - let peer_address = socket_address_v4(peer.local_addr().unwrap()); - peer.connect(peer_address).unwrap(); + let (_refusing, refused_address) = crate::test_support::refusing_udp_address(); assert_eq!( - litebox_broker_core::socket::connect(&process, socket, gateway_address(peer_address)), + litebox_broker_core::socket::connect(&process, socket, gateway_address(refused_address)), Ok(SocketOutcome::Completed(SocketConnectionStatus::Connected)) ); #[cfg(target_os = "linux")]