Struct bluer::l2cap::Datagram

pub struct Datagram { /* private fields */ }

Available on crate feature l2cap only.

An L2CAP datagram socket (connection-less, unreliable messages of a fixed maximum length).

Implementations

impl Datagram

pub async fn bind(sa: SocketAddr) -> Result<Self>

Creates a new datagram socket, which will be bound to the specified socket address.

Specify SocketAddr::any_br_edr or SocketAddr::any_le for any local adapter address with a dynamically allocated PSM.

pub async fn connect(&self, sa: SocketAddr) -> Result<()>

Establish a datagram connection with a peer at the specified socket address.

pub fn peer_addr(&self) -> Result<SocketAddr>

Gets the peer address of this stream.

pub async fn send(&self, buf: &[u8]) -> Result<usize>

Sends a packet to the connected peer.

The packet length must not exceed the Self::send_mtu.

pub fn poll_send(&self, cx: &mut Context<'_>, buf: &[u8]) -> Poll<Result<usize>>

Attempts to send a packet to the connected peer.

The packet length must not exceed the Self::send_mtu.

pub async fn send_to(&self, buf: &[u8], target: SocketAddr) -> Result<usize>

Sends a packet to the specified target address.

The packet length must not exceed the Self::send_mtu.

pub fn poll_send_to(
    &self,
    cx: &mut Context<'_>,
    buf: &[u8],
    target: SocketAddr
) -> Poll<Result<usize>>

Attempts to send a packet to the specified target address.

The packet length must not exceed the Self::send_mtu.

pub async fn recv(&self, buf: &mut [u8]) -> Result<usize>

Receives a packet from the connected peer.

The provided buffer must be of length Self::recv_mtu, otherwise the packet may be truncated.

pub fn poll_recv(
    &self,
    cx: &mut Context<'_>,
    buf: &mut ReadBuf<'_>
) -> Poll<Result<()>>

Attempts to receive a packet from the connected peer.

The provided buffer must be of length Self::recv_mtu, otherwise the packet may be truncated.

pub async fn recv_from(&self, buf: &mut [u8]) -> Result<(usize, SocketAddr)>

Receives a packet from anywhere.

The provided buffer must be of length Self::recv_mtu, otherwise the packet may be truncated.

pub fn poll_recv_from(
    &self,
    cx: &mut Context<'_>,
    buf: &mut ReadBuf<'_>
) -> Poll<Result<SocketAddr>>

Attempts to receive a packet from anywhere.

The provided buffer must be of length Self::recv_mtu, otherwise the packet may be truncated.

pub fn shutdown(&self, how: Shutdown) -> Result<()>

Shuts down the read, write, or both halves of this connection.

pub fn send_mtu(&self) -> Result<usize>

Maximum transmission unit (MTU) for sending.

pub fn recv_mtu(&self) -> Result<usize>

Maximum transmission unit (MTU) for receiving.

pub unsafe fn from_raw_fd(fd: RawFd) -> Result<Self>

Constructs a new Datagram from the given raw file descriptor.

The file descriptor must have been set to non-blocking mode.

This function consumes ownership of the specified file descriptor. The returned object will take responsibility for closing it when the object goes out of scope.

Safety

If the passed file descriptor is invalid, undefined behavior may occur.

Trait Implementations

impl AsRawFd for Datagram

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl AsRef<Socket<Datagram>> for Datagram

fn as_ref(&self) -> &Socket<Datagram>

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for Datagram

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

Formats the value using the given formatter.

impl FromRawFd for Datagram

unsafe fn from_raw_fd(fd: RawFd) -> Self

Constructs a new instance of Self from the given raw file descriptor.

The file descriptor must have been set to non-blocking mode.

Panics

Panics when the conversion fails. Use Datagram::from_raw_fd for a non-panicking variant.