View source code
Display the source code in std/socket.d from which this page was generated on github.
Report a bug
If you spot a problem with this page, click here to create a Bugzilla issue.
Improve this page
Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Class std.socket.UnixAddress

Encapsulates an address for a Unix domain socket (AF_UNIX), i.e. a socket bound to a path name in the file system. Available only on supported systems.

class UnixAddress
  : Address ;

Linux also supports an abstract address namespace, in which addresses are independent of the file system. A socket address is abstract iff path starts with a null byte ('\0'). Null bytes in other positions of an abstract address are allowed and have no special meaning.

Constructors

NameDescription
this (path) Construct a new UnixAddress from the specified path.
this (addr) Construct a new UnixAddress.

Properties

NameTypeDescription
path[get] stringGet the underlying path.
addressFamily[get] AddressFamilyFamily of this address.
name[get] core.sys.posix.sys.socket.sockaddr*Returns pointer to underlying sockaddr structure.
nameLen[get] uintReturns actual size of underlying sockaddr structure.

Methods

NameDescription
toString () Get the underlying path.
factory (classname) Create instance of class specified by the fully qualified name classname. The class must either have no constructors or have a default constructor.
opCmp (o) Compare with another Object obj.
opEquals (o) Test whether this is equal to o. The default implementation only compares by identity (using the is operator). Generally, overrides and overloads for opEquals should attempt to compare objects by their contents. A class will most likely want to add an overload that takes your specific type as the argument and does the content comparison. Then you can override this and forward it to your specific typed overload with a cast. Remember to check for null on the typed overload.
toAddrString () Attempts to retrieve the host address as a human-readable string.
toHash () Compute hash function for Object.
toHostNameString () Attempts to retrieve the host name as a fully qualified domain name.
toPortString () Attempts to retrieve the numeric port number as a string.
toServiceNameString () Attempts to retrieve the service name as a string.
toString () Convert Object to a human readable string.

Example

auto addr = new UnixAddress("/var/run/dbus/system_bus_socket");
auto abstractAddr = new UnixAddress("\0/tmp/dbus-OtHLWmCLPR");

See Also

UNIX(7)

Authors

Christopher E. Miller, David Nadlinger, Vladimir Panteleev

License

Boost License 1.0.