//! Definitions related to unix domain socket support.

//!

//! To avoid confusion, don't import `SocketAddr` from this module directly;

//! instead, import the module and refer to `unix::SocketAddr`.

#[cfg(not(unix))]

use std::path::Path;

/// A replacement/re-export [`std::os::unix::net::SocketAddr`].

///

/// On Unix platforms, this is just a re-export of [`std::os::unix::net::SocketAddr`].

///

/// On non-Unix platforms, this type is an uninhabited placeholder that can never be instantiated.

#[cfg(unix)]

pub use std::os::unix::net::SocketAddr;

// Void is used only as a stand-in for unix::SocketAddr.  Avoid unused crate warning.

//

// (We can't express the right dependency condition in Cargo.toml,

// and anyway it's not worth trying to conditionally suppress the dependency.)

#[cfg(unix)]

use void as _;

/// Address for an AF_UNIX socket.

///

/// (This is an uninhabited placeholder implementations for platforms without AF_UNIX support.)

///

/// Note that we currently include Windows on platforms without AF_UNIX support:

/// When we use unix domain sockets in Arti, we rely on their filesystem-based security properties,

/// which we haven't yet had a chance to fully analyze on non-Unix platforms.

#[cfg(not(unix))]

#[derive(Debug, Clone)]

pub struct SocketAddr(void::Void);

#[cfg(not(unix))]

impl SocketAddr {

    /// Return true if this is an "unnamed" socket address.

    ///

    /// (Because this type is uninhabited, this method cannot actually be called.)

    pub fn is_unnamed(&self) -> bool {

        void::unreachable(self.0)

    }

    /// Return the pathname for this socket address, if it is "named".

    ///

    /// (Because this type is uninhabited, this method cannot actually be called.)

    pub fn as_pathname(&self) -> Option<&Path> {

        void::unreachable(self.0)

    }

    /// Attempt to construct an AF_UNIX socket address from the provided `path`.

    ///

    /// (Because this platform lacks AF_UNIX support, this method will always return an error.)

    pub fn from_pathname<P: AsRef<Path>>(path: P) -> std::io::Result<Self> {

        let _ = path;

        Err(NoAfUnixSocketSupport.into())

    }

}

/// Error: Unix domain sockets are not supported on this platform.

#[derive(Clone, Debug, Default, thiserror::Error)]

#[error("No support for unix domain sockets on this platform")]

#[non_exhaustive]

pub struct NoAfUnixSocketSupport;

/// Deprecated name for `NoAfUnixSocketSupport`

#[deprecated]

pub type NoUnixAddressSupport = NoAfUnixSocketSupport;

impl From<NoAfUnixSocketSupport> for std::io::Error {

}