bind.2, connect.2, getpeername.2, getsockname.2, getsockopt.2: Replace discussion...

The discussion of 'socklen_t' editorializes and is repeated
across several pages. Replace it with a reference to accept(2),
where some details about this type are provided.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/bind.2 b/man2/bind.2
index 07d8e8ae7d63c441a3c5c3e07020bde2168d8866..13e7305e908ad6055832ab476c6ac5739d822656 100644 (file)
--- a/man2/bind.2
+++ b/man2/bind.2
@@ -248,15 +248,9 @@ and this header file is not required on Linux.
 However, some historical (BSD) implementations required this header
 file, and portable applications are probably wise to include it.
 
-The third argument of
-.BR bind ()
-is in reality an
-.I int
-(and this is what 4.x BSD and libc4 and libc5 have).
-Some POSIX confusion resulted in the present
-.IR socklen_t ,
-also used by glibc.
-See also
+For background on the
+.I socklen_t
+type, see
 .BR accept (2).
 .SH BUGS
 The transparent proxy options are not described.

diff --git a/man2/connect.2 b/man2/connect.2
index db2245c1741af7d7a2fcecc95694a94094a93081..c2689e0fcbc8d9eec5ab4d8c499b77e7d401057e 100644 (file)
--- a/man2/connect.2
+++ b/man2/connect.2
@@ -260,15 +260,9 @@ and this header file is not required on Linux.
 However, some historical (BSD) implementations required this header
 file, and portable applications are probably wise to include it.
 
-The third argument of
-.BR connect ()
-is in reality an
-.I int
-(and this is what 4.x BSD and libc4 and libc5 have).
-Some POSIX confusion resulted in the present
-.IR socklen_t ,
-also used by glibc.
-See also
+For background on the
+.I socklen_t
+type, see
 .BR accept (2).
 
 If

diff --git a/man2/getpeername.2 b/man2/getpeername.2
index 89f76a0dd9959e297a09ba7bb3a03d8c2ea46100..3bd80f3c8e137a95d4742b6a114f2d63caea0742 100644 (file)
--- a/man2/getpeername.2
+++ b/man2/getpeername.2
@@ -103,15 +103,9 @@ POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD
 .RB ( getpeername ()
 first appeared in 4.2BSD).
 .SH NOTES
-The third argument of
-.BR getpeername ()
-is in reality an
-.I "int\ *"
-(and this is what 4.x BSD and libc4 and libc5 have).
-Some POSIX confusion resulted in the present
-.IR socklen_t ,
-also used by glibc.
-See also
+For background on the
+.I socklen_t
+type, see
 .BR accept (2).
 
 For stream sockets, once a

diff --git a/man2/getsockname.2 b/man2/getsockname.2
index c6c8ca46a3fce73dc05295d25a4e964f15dbd58d..3333ed33b3c167c769baec4734076c8afd52d296 100644 (file)
--- a/man2/getsockname.2
+++ b/man2/getsockname.2
@@ -101,15 +101,9 @@ first appeared in 4.2BSD).
 .\" SVr4 documents additional ENOMEM
 .\" and ENOSR error codes.
 .SH NOTES
-The third argument of
-.BR getsockname ()
-is in reality an
-.I "int\ *"
-(and this is what 4.x BSD and libc4 and libc5 have).
-Some POSIX confusion resulted in the present
-.IR socklen_t ,
-also used by glibc.
-See also
+For background on the
+.I socklen_t
+type, see
 .BR accept (2).
 .SH SEE ALSO
 .BR bind (2),

diff --git a/man2/getsockopt.2 b/man2/getsockopt.2
index c1672b41737c92db08ceeceba76508d0eedf6950..40639c9287d52ae9f700bc16388f96206dc7e5d8 100644 (file)
--- a/man2/getsockopt.2
+++ b/man2/getsockopt.2
@@ -186,19 +186,9 @@ and this header file is not required on Linux.
 However, some historical (BSD) implementations required this header
 file, and portable applications are probably wise to include it.
 
-The
-.I optlen
-argument of
-.BR getsockopt ()
-and
-.BR setsockopt ()
-is in reality an
-.I "int [*]"
-(and this is what 4.x BSD and libc4 and libc5 have).
-Some POSIX confusion resulted in the present
-.IR socklen_t ,
-also used by glibc.
-See also
+For background on the
+.I socklen_t
+type, see
 .BR accept (2).
 .SH BUGS
 Several of the socket options should be handled at lower levels of the