Struct BoundUnixSocket 

pub struct BoundUnixSocket { /* private fields */ }

A bound AF_UNIX socket file: the node exists as long as this value does.

Hold it beside the UnixListener it was bound with. Dropping it removes the node, which is what keeps the next bind of the same path out of the unlink-then-bind race below.

Implementations

impl BoundUnixSocket

pub fn bind(path: &Path) -> Result<(BoundUnixSocket, UnixListener), Error>

Binds path with the hygiene a filesystem endpoint needs, replacing a stale socket file left by a crash.

Four things happen here, and each answers a documented hazard:

1. The path budget. sun_path is 108 bytes on Linux and 104 on macOS including the terminator, and the kernel truncates rather than failing, so an over-long path binds something other than what was asked for. It is refused instead (docs/research/ipc.md §1.1, §2.1). libzmq’s ipc:// publishes the same limit as “113 characters including the prefix” and leaves the rest to the caller (docs/research/zeromq.md §11).
2. The socket-type check. Closing a socket does not remove its node, so a crash leaves one and bind() then fails with EADDRINUSE. A stale node is a socket nobody is listening on; anything else at that path is not ours to remove, and removing it anyway is how a bind deletes a caller’s data.
3. Unlink, then bind. The usual answer to the stale node, and it opens a substitution race that is closed only “unless directory ownership and permissions prevent endpoint substitution” (docs/research/ipc.md §1.2, §7). The directory is therefore load-bearing: the caller MUST place the socket in a directory it owns and that no other user may write. libzmq’s ipc:// has this hazard too and answers none of it — a local process can steal a bound endpoint.
4. The mode, explicitly. 0600 set after bind, because a socket file is created with whatever umask allows, which is whatever the process happened to inherit.

pub fn path(&self) -> &Path

The path this socket is bound at.

Trait Implementations

impl Debug for BoundUnixSocket

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

Formats the value using the given formatter.

impl Drop for BoundUnixSocket

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.