diff options
Diffstat (limited to 'man7/unix.7')
| -rw-r--r-- | man7/unix.7 | 26 |
1 files changed, 16 insertions, 10 deletions
diff --git a/man7/unix.7 b/man7/unix.7 index 1591691a4f..9751abd5e9 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -45,8 +45,8 @@ and (since kernel 2.6.4) for a connection-oriented socket that preserves message boundaries and delivers messages in the order that they were sent. -Unix sockets support passing file descriptors or process credentials to other -processes using ancillary data. +Unix sockets support passing file descriptors or process credentials +to other processes using ancillary data. .SH "ADDRESS FORMAT" A Unix address is defined as a filename in the filesystem or @@ -81,7 +81,8 @@ If .B sun_path starts with a zero byte it refers to the abstract namespace maintained by the Unix protocol module. -The socket's address in this namespace is given by the rest of the bytes in +The socket's address in this namespace is given by the rest of the +bytes in .BR sun_path . Note that names in the abstract namespace are not zero-terminated. @@ -96,7 +97,8 @@ by specifying SOL_SOCKET as the socket family. .TP .B SO_PASSCRED Enables the receiving of the credentials of the sending process -ancillary message. When this option is set and the socket is not yet connected +ancillary message. +When this option is set and the socket is not yet connected a unique name in the abstract namespace will be generated automatically. Expects an integer boolean flag. @@ -135,7 +137,8 @@ Ancillary data is sent and received using and .BR recvmsg (2). For historical reasons the ancillary message types listed below -are specified with a SOL_SOCKET type even though they are PF_UNIX specific. +are specified with a SOL_SOCKET type even though they are PF_UNIX +specific. To send them set the .B cmsg_level field of the struct @@ -177,7 +180,8 @@ The sender must specify its own process ID (unless it has the capability .BR CAP_SYS_ADMIN ), its user ID, effective user ID, or saved set-user-ID (unless it has .BR CAP_SETUID ), -and its group ID, effective group ID, or saved set-group-ID (unless it has +and its group ID, effective group ID, or saved set-group-ID +(unless it has .BR CAP_SETGID ). To receive a .I struct ucred @@ -231,8 +235,10 @@ the remote socket does not exist or the filename is not a socket. .TP .B EINVAL Invalid argument passed. A common cause is the missing setting of AF_UNIX -in the sun_type field of passed addresses or the socket being in an invalid -state for the applied operation. +in the +.I sun_type +field of passed addresses or the socket being in an +invalid state for the applied operation. .TP .B EOPNOTSUPP Stream operation called on non-stream oriented socket or tried to @@ -249,8 +255,8 @@ Remote socket does not match the local socket type (SOCK_DGRAM vs. SOCK_STREAM) .TP .B EADDRINUSE -Selected local address is already taken or filesystem socket object already -exists. +Selected local address is already taken or filesystem socket +object already exists. .TP .B EISCONN .BR connect (2) |