Trait PlatformTcp 

pub trait PlatformTcp {
    // Required methods
    fn create_endpoint(
        ep: *mut c_void,
        address: *const u8,
        port: *const u8,
    ) -> i8;
    fn free_endpoint(ep: *mut c_void);
    fn open(sock: *mut c_void, endpoint: *const c_void, timeout_ms: u32) -> i8;
    fn listen(sock: *mut c_void, endpoint: *const c_void) -> i8;
    fn close(sock: *mut c_void);
    fn read(sock: *const c_void, buf: *mut u8, len: usize) -> usize;
    fn read_exact(sock: *const c_void, buf: *mut u8, len: usize) -> usize;
    fn send(sock: *const c_void, buf: *const u8, len: usize) -> usize;
}

TCP networking.

Socket and endpoint parameters are opaque *mut c_void pointers to platform-specific types (_z_sys_net_socket_t, _z_sys_net_endpoint_t). The shim provides correctly-sized #[repr(C)] wrappers whose sizes are auto-detected from C headers at build time (see Phase 80 design).

Read functions return usize::MAX on error. Send returns usize::MAX on error.

Method names are unprefixed — the trait already namespaces them. Shims dispatch via <ConcretePlatform as PlatformTcp>::open(...) etc.

Required Methods

fn create_endpoint(ep: *mut c_void, address: *const u8, port: *const u8) -> i8

Resolve address + port strings into an endpoint handle.

fn free_endpoint(ep: *mut c_void)

Free endpoint resources.

fn open(sock: *mut c_void, endpoint: *const c_void, timeout_ms: u32) -> i8

Open a TCP client connection. endpoint is by-value (opaque bytes on stack).

fn listen(sock: *mut c_void, endpoint: *const c_void) -> i8

Open a TCP listening socket.

fn close(sock: *mut c_void)

Close a TCP socket.

fn read(sock: *const c_void, buf: *mut u8, len: usize) -> usize

Read up to len bytes. Returns bytes read, or usize::MAX on error.

fn read_exact(sock: *const c_void, buf: *mut u8, len: usize) -> usize

Read exactly len bytes. Returns len on success, usize::MAX on error.

fn send(sock: *const c_void, buf: *const u8, len: usize) -> usize

Send len bytes. Returns bytes sent, or usize::MAX on error.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl PlatformTcp for CffiPlatform

fn create_endpoint(ep: *mut c_void, address: *const u8, port: *const u8) -> i8

fn free_endpoint(ep: *mut c_void)

fn open(sock: *mut c_void, endpoint: *const c_void, timeout_ms: u32) -> i8

fn listen(sock: *mut c_void, endpoint: *const c_void) -> i8

fn close(sock: *mut c_void)

fn read(sock: *const c_void, buf: *mut u8, len: usize) -> usize

fn read_exact(sock: *const c_void, buf: *mut u8, len: usize) -> usize

fn send(sock: *const c_void, buf: *const u8, len: usize) -> usize

Implementors