Struct systemd_socket::SocketAddr

pub struct SocketAddr(_);

Socket address that can be an ordinary address or a systemd socket

This is the core type of this crate that abstracts possible addresses. It can be (fallibly) converted from various types of strings or deserialized with serde. After it's created, it can be bound as TcpListener from std or even tokio or async_std if the appropriate feature is enabled.

Optional dependencies on parse_arg and serde make it trivial to use with configure_me.

Implementations

impl SocketAddr

pub fn from_systemd_name<T: Into<String>>(name: T) -> Result<Self, ParseError>

Creates SocketAddr from systemd name directly, without requiring systemd:// prefix.

Always fails with systemd unsupported error if systemd is not supported.

pub fn bind(self) -> Result<TcpListener, BindError>

Creates std::net::TcpListener

This method either binds the socket, if the address was provided or uses systemd socket if the socket name was provided.

Trait Implementations

impl Debug for SocketAddr

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

Formats the value using the given formatter.

impl Display for SocketAddr

Displays the address in format that can be parsed again.

Important: While I don't expect this impl to change, don't rely on it! It should be used mostly for debugging/logging.

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

Formats the value using the given formatter.

impl<I: Into<IpAddr>> From<(I, u16)> for SocketAddr

pub fn from(value: (I, u16)) -> Self

Performs the conversion.

impl From<SocketAddr> for SocketAddr

pub fn from(value: SocketAddr) -> Self

Performs the conversion.

impl From<SocketAddrV4> for SocketAddr

pub fn from(value: SocketAddrV4) -> Self

Performs the conversion.

impl From<SocketAddrV6> for SocketAddr

pub fn from(value: SocketAddrV6) -> Self

Performs the conversion.

impl FromStr for SocketAddr

type Err = ParseError

The associated error which can be returned from parsing.

pub fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<'a> TryFrom<&'a OsStr> for SocketAddr

type Error = ParseOsStrError

The type returned in the event of a conversion error.

pub fn try_from(s: &'a OsStr) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<&'a str> for SocketAddr

type Error = ParseError

The type returned in the event of a conversion error.

pub fn try_from(s: &'a str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<OsString> for SocketAddr

type Error = ParseOsStrError

The type returned in the event of a conversion error.

pub fn try_from(s: OsString) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for SocketAddr

type Error = ParseError

The type returned in the event of a conversion error.

pub fn try_from(s: String) -> Result<Self, Self::Error>

Performs the conversion.