Hi Günther, > Date: 2026-11-03 21:21:36+0100 > From: Günther Noack > > These are all returned directly from linux.git net/unix/af_unix.c: > > EACCES > unix_find_bsd() checks path_permission(&path, MAY_WRITE) on the > socket file of the remote address. The rule was already described > in prose, but the error was not listed. > > EAGAIN > unix_stream_connect() returns -EAGAIN when the listener's backlog > is full and the socket is nonblocking (there is no EINPROGRESS for > AF_UNIX). unix_dgram_sendmsg() returns -EAGAIN when the receiver's > queue is full and the send would block. > > EMSGSIZE > unix_dgram_sendmsg() fails if 'len > sk->sk_sndbuf - 32'. This is > the limit described in "Sockets API". > > ENOSPC > unix_autobind() fails when all 2^20 autobind names are taken. > > EPERM > unix_dgram_connect() and unix_dgram_sendmsg() fail if > !unix_may_send(), that is, if the target datagram socket is > connected to a socket other than the caller's. > > This is not something that the remote end normally does, > but it's a possible corner case. > > Cc: Kuniyuki Iwashima > Assisted-by: LLM > Signed-off-by: Günther Noack > --- > > Notes: > Verified in code. Kept LLM wording, which seemed OK. > > Remark: > > The case where the remote end is connected to a different socket is > obscure, but still possible with Unix Domain Sockets, when a program > first bind(2)s to a name, and then connect(2)s to another name. Then > that socket can be discovered by another process through the bound > name, but sending a dgram fails if the sender is not the one that that > socket has connected to. > > man/man7/unix.7 | 36 ++++++++++++++++++++++++++++++++++-- > 1 file changed, 34 insertions(+), 2 deletions(-) > > diff --git a/man/man7/unix.7 b/man/man7/unix.7 > index 762bf0d1fe08..2163a91514b9 100644 > --- a/man/man7/unix.7 > +++ b/man/man7/unix.7 > @@ -645,9 +645,24 @@ .SS Ioctls > .\" and it may well change, probably best not to document this now. > .SH ERRORS > .TP > +.B EACCES > +Write permission is denied on the socket file > +specified as the remote address to > +.BR connect (2) > +or > +.BR sendto (2) > +(see "Pathname socket ownership and permissions", above). > +.TP > .B EADDRINUSE Changes to EADDRINUSE are not documented in the commit message. Have a lovely night! Alex > -The specified local address is already in use or the filesystem socket > -object already exists. > +The specified local address is already in use > +or the file already exists. > +.TP > +.B EAGAIN > +The socket is nonblocking, and either > +.BR connect (2) > +was called on a stream or sequenced-packet socket > +and the backlog of the listening socket is full, > +or a datagram was sent to a socket whose receive queue is full. > .TP > .B EBADF > This error can occur for > @@ -684,6 +699,11 @@ .SH ERRORS > called on an already connected socket or a target address was > specified on a connected socket. > .TP > +.B EMSGSIZE > +The datagram to be sent is larger than the limit imposed by the > +.B SO_SNDBUF > +socket option (see "Sockets API", above). > +.TP > .B ENFILE > The system-wide limit on the total number of open files has been reached. > .TP > @@ -695,6 +715,11 @@ .SH ERRORS > .B ENOMEM > Out of memory. > .TP > +.B ENOSPC > +The socket was to be autobound, > +but all autobind addresses are in use > +(see "Autobind feature", above). > +.TP > .B ENOTCONN > Socket operation needs a target address, but the socket is not connected. > .TP > @@ -706,6 +731,13 @@ .SH ERRORS > The sender passed invalid credentials in the > .IR "struct ucred" . > .TP > +.B EPERM > +.BR connect (2) > +or > +.BR sendto (2) > +specified a datagram socket as the remote address, > +but that socket is connected to a different socket. > +.TP > .B EPIPE > Remote socket was closed on a stream socket. > If enabled, a > -- > 2.56.0 > > --