Struct MctpLinuxReq

pub struct MctpLinuxReq { /* private fields */ }

Encapsulation of a remote endpoint: a socket and an Endpoint ID.

Implementations

impl MctpLinuxReq

pub fn new(eid: Eid, net: Option<u32>) -> Result<Self>

Create a new MctpLinuxReq with EID eid

Examples found in repository

examples/mctp-req.rs (line 15)

fn main() -> std::io::Result<()> {
    const EID: Eid = Eid(8);

    // Create a new endpoint using the linux socket support
    let mut ep = MctpLinuxReq::new(EID, None)?;

    // for subsequent use of `ep`, we're just interacting with the
    // mctp::ReqChannel trait, which is independent of the socket support

    // Get Endpoint ID message: command 0x02, no data. Allow the MCTP stack
    // to allocate an owned tag.
    let tx_buf = vec![0x02u8];
    ep.send(MCTP_TYPE_CONTROL, &tx_buf)?;

    // Receive a response. We create a 16-byte vec to read into; ep.recv()
    // will return the sub-slice containing just the response data.
    let mut rx_buf = vec![0u8; 16];
    let (typ, ic, rx_buf) = ep.recv(&mut rx_buf)?;

    println!("response type {}, ic {:?}: {:x?}", typ, ic, rx_buf);

    Ok(())
}

pub fn as_socket(&mut self) -> &mut MctpSocket

Borrow the internal MCTP socket

pub fn net(&self) -> Option<u32>

Returns the MCTP Linux network, or None for the default MCTP_NET_ANY

Trait Implementations

impl ReqChannel for MctpLinuxReq

fn send_vectored( &mut self, typ: MsgType, ic: MsgIC, bufs: &[&[u8]], ) -> Result<()>

Send a MCTP message

Linux MCTP can also send a preallocated owned tag, but that is not yet supported in MctpLinuxReq.

fn recv<'f>( &mut self, buf: &'f mut [u8], ) -> Result<(MsgType, MsgIC, &'f mut [u8])>

Blocking receive

fn remote_eid(&self) -> Eid

Return the remote Endpoint ID

fn send(&mut self, typ: MsgType, buf: &[u8]) -> Result<(), Error>

Send a message to this endpoint, blocking.