[src/trunk]: src/lib/libc/sys Document EINVAL for out of range socket address...

[dholland <dholland%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/e30f7b9f1bdb
branches:  trunk
changeset: 960735:e30f7b9f1bdb
user:      dholland <dholland%NetBSD.org@localhost>
date:      Sun Mar 28 03:29:31 2021 +0000

description:
Document EINVAL for out of range socket address lengths.

This is what happens, but wasn't documented. Applies to bind(2),
connect(2), and send(2).

diffstat:

 lib/libc/sys/bind.2    |  6 ++++--
 lib/libc/sys/connect.2 |  6 ++++--
 lib/libc/sys/send.2    |  6 ++++--
 3 files changed, 12 insertions(+), 6 deletions(-)

diffs (81 lines):

diff -r 1d38073c0d8d -r e30f7b9f1bdb lib/libc/sys/bind.2
--- a/lib/libc/sys/bind.2       Sat Mar 27 23:35:37 2021 +0000
+++ b/lib/libc/sys/bind.2       Sun Mar 28 03:29:31 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: bind.2,v 1.30 2017/07/03 21:32:50 wiz Exp $
+.\"    $NetBSD: bind.2,v 1.31 2021/03/28 03:29:31 dholland Exp $
 .\"
 .\" Copyright (c) 1983, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)bind.2     8.1 (Berkeley) 6/4/93
 .\"
-.Dd April 5, 2015
+.Dd March 27, 2021
 .Dt BIND 2
 .Os
 .Sh NAME
@@ -99,6 +99,8 @@
 the family of the socket and that requested in
 .Fa name->sa_family
 are not equivalent.
+.It Bq Er EINVAL
+The socket address length passed was outside the allowable range.
 .It Bq Er ENOTSOCK
 .Fa s
 is not a socket.
diff -r 1d38073c0d8d -r e30f7b9f1bdb lib/libc/sys/connect.2
--- a/lib/libc/sys/connect.2    Sat Mar 27 23:35:37 2021 +0000
+++ b/lib/libc/sys/connect.2    Sun Mar 28 03:29:31 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: connect.2,v 1.28 2010/05/31 12:16:20 njoly Exp $
+.\"    $NetBSD: connect.2,v 1.29 2021/03/28 03:29:31 dholland Exp $
 .\"
 .\" Copyright (c) 1983, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)connect.2  8.1 (Berkeley) 6/4/93
 .\"
-.Dd May 18, 2004
+.Dd March 27, 2021
 .Dt CONNECT 2
 .Os
 .Sh NAME
@@ -97,6 +97,8 @@
 .It Bq Er ENOTSOCK
 .Fa s
 is a descriptor for a file, not a socket.
+.It Bq Er EINVAL
+The socket address length passed was outside the allowable range.
 .It Bq Er EADDRNOTAVAIL
 The specified address is not available on this machine.
 .It Bq Er EAFNOSUPPORT
diff -r 1d38073c0d8d -r e30f7b9f1bdb lib/libc/sys/send.2
--- a/lib/libc/sys/send.2       Sat Mar 27 23:35:37 2021 +0000
+++ b/lib/libc/sys/send.2       Sun Mar 28 03:29:31 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: send.2,v 1.32 2017/06/11 17:01:26 abhinav Exp $
+.\"    $NetBSD: send.2,v 1.33 2021/03/28 03:29:31 dholland Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)send.2     8.2 (Berkeley) 2/21/94
 .\"
-.Dd June 22, 2012
+.Dd March 27, 2021
 .Dt SEND 2
 .Os
 .Sh NAME
@@ -217,6 +217,8 @@
 .It Bq Er EINVAL
 The total length of the I/O is more than can be expressed by the ssize_t
 return value.
+.It Bq Er EINVAL
+The socket address length passed was outside the allowable range.
 .It Bq Er EMSGSIZE
 The socket requires that message be sent atomically,
 and the size of the message to be sent made this impossible.