Struct PageServer 

pub struct PageServer { /* private fields */ }

A resolved, BOUND page-server listener plus its real bound address.

Holding this value keeps the port reserved (the socket is already in LISTEN state, queuing connections at the kernel backlog) until crate::server::ShellServer::adopt takes ownership of the listener to run the accept loop — so no other process can claim the port in the window between resolution and serving.

Implementations

impl PageServer

pub fn resolve(frame: &FrameSection) -> Result<Self, HostError>

Resolves the page-server listener from the [frame] section.

A stated [frame].bind binds exactly (loud failure if taken); an absent one prefers PREFERRED_PAGE_PORT and walks forward to the next free, Fetch-safe port.

Errors

Returns HostError::PageServerUnavailable when a stated [frame].bind is already in use, or HostError::NoFreePagePort when the whole forward walk from the preferred port finds nothing free (practically impossible; a genuinely exhausted local port space).

pub const fn local_addr(&self) -> SocketAddr

The REAL bound page-server address — the one printed on boot and folded into the derived bus origin allow-list.

pub fn into_listener(self) -> TcpListener

Consumes the resolved page server, yielding the held listener for the shell server’s accept loop to adopt.

Trait Implementations

impl Debug for PageServer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.