datagram-socket 0.3.0

Utilities for working with datagram sockets
Documentation
// Copyright (C) 2025, Cloudflare, Inc.
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
//     * Redistributions of source code must retain the above copyright notice,
//       this list of conditions and the following disclaimer.
//
//     * Redistributions in binary form must reproduce the above copyright
//       notice, this list of conditions and the following disclaimer in the
//       documentation and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
// IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
// SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

mod datagram;
mod shutdown;
mod socket_stats;

#[cfg(target_os = "linux")]
#[macro_use]
mod mmsg;

pub use self::datagram::*;

#[cfg(target_os = "linux")]
pub use mmsg::*;

#[cfg(unix)]
use std::os::fd::AsRawFd;

pub use self::shutdown::*;
pub use self::socket_stats::*;

#[cfg(target_os = "linux")]
pub fn is_nonblocking(fd: &impl AsRawFd) -> std::io::Result<bool> {
    let flags = unsafe { libc::fcntl(fd.as_raw_fd(), libc::F_GETFL) };

    if flags == -1 {
        return Err(std::io::Error::last_os_error());
    }

    if flags & libc::O_NONBLOCK != 0 {
        Ok(true)
    } else {
        Ok(false)
    }
}

#[cfg(all(unix, not(target_os = "linux")))]
pub fn is_nonblocking(_fd: &impl AsRawFd) -> std::io::Result<bool> {
    Ok(true)
}