# Trait SocketAddrExt

1.70.0 · Source

    pub trait SocketAddrExt: Sealed {
        // Required methods
        fn from_abstract_name<N>(name: N) -> Result<SocketAddr>
           where N: AsRef<[u8]>;
        fn as_abstract_name(&self) -> Option<&[u8]>;
    }

Available on Linux and (Linux or Android) only.
Expand description

Platform-specific extensions to `SocketAddr`.

## Required Methods§

1.70.0 · Source

#### fn from_abstract_name<N>(name: N) -> Result<SocketAddr>
where N: AsRef<[u8]>,

Creates a Unix socket address in the abstract namespace.

The abstract namespace is a Linux-specific extension that allows Unix sockets to be bound without creating an entry in the filesystem. Abstract sockets are unaffected by filesystem layout or permissions, and no cleanup is necessary when the socket is closed.

An abstract socket address name may contain any bytes, including zero.

##### §Errors

Returns an error if the name is longer than `SUN_LEN - 1`.

##### §Examples

    use std::os::unix::net::{UnixListener, SocketAddr};
    #[cfg(target_os = "linux")]
    use std::os::linux::net::SocketAddrExt;
    #[cfg(target_os = "android")]
    use std::os::android::net::SocketAddrExt;

    fn main() -> std::io::Result<()> {
        let addr = SocketAddr::from_abstract_name(b"hidden")?;
        let listener = match UnixListener::bind_addr(&addr) {
            Ok(sock) => sock,
            Err(err) => {
                println!("Couldn't bind: {err:?}");
                return Err(err);
            }
        };
        Ok(())
    }

1.70.0 · Source

#### fn as_abstract_name(&self) -> Option<&[u8]>

Returns the contents of this address if it is in the abstract namespace.

##### §Examples

    use std::os::unix::net::{UnixListener, SocketAddr};
    #[cfg(target_os = "linux")]
    use std::os::linux::net::SocketAddrExt;
    #[cfg(target_os = "android")]
    use std::os::android::net::SocketAddrExt;

    fn main() -> std::io::Result<()> {
        let name = b"hidden";
        let name_addr = SocketAddr::from_abstract_name(name)?;
        let socket = UnixListener::bind_addr(&name_addr)?;
        let local_addr = socket.local_addr().expect("Couldn't get local address");
        assert_eq!(local_addr.as_abstract_name(), Some(&name[..]));
        Ok(())
    }

## 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.

## Implementors§

1.70.0 · Source§

### impl SocketAddrExt for SocketAddr

Available on Unix and (Android or Linux) only.