docs/156955: bug in share/man/man2/setsockopt.2

[Matthias Andree]

The following reply was made to PR docs/156955; it has been noted by GNATS.

From: Matthias Andree <mandree at FreeBSD.org>
To: bcr at FreeBSD.org
Cc: bug-followup at FreeBSD.org
Subject: Re: docs/156955: bug in share/man/man2/setsockopt.2
Date: Fri, 27 May 2011 17:41:29 +0200

 Am 27.05.2011 16:24, schrieb Benedict Reuschling:
 > Is this still an issue? The man page looks fine on the two systems I
 > checked. The SO_KEEPALIVE text is on its own line. The file in question
 > is lib/libc/sys/getsockopt.2 and has the correct formatting as far as I
 > can see.
 > 
 > Benedict Reuschling
 > FreeBSD Doc Committer
 > 
 > The FreeBSD Documentation Project
 > FreeBSD German Documentation Project - https://doc.bsdgroup.de
 
 Yup, still broken on RELENG_8:
 
 ...
 SO_DEBUG enables debugging in the underlying protocol modules.
 SO_REUSEADDR indicates that the rules used in validating addresses sup-
 plied in a bind(2) system call should allow reuse of local addresses.
 SO_REUSEPORT allows completely duplicate bindings by multiple processes
 if they all set SO_REUSEPORT before binding the port.  This option per-
 mits multiple instances of a program to each receive UDP/IP multicast or
 broadcast datagrams destined for the bound port.  SO_KEEPALIVE enables
 the periodic transmission of messages on a connected socket.  Should the
 connected party fail to respond to these messages, the connection is con-
 sidered broken and processes using the socket are notified via a SIGPIPE
 signal when attempting to send data.  SO_DONTROUTE indicates that outgo-
 ing messages should bypass the standard routing facilities.  Instead,
 messages are directed to the appropriate network interface according to
 the network portion of the destination address.
 ...
 
 So missing paragraphs befrore SO_REUSEPORT, SO_KEEPALIVE, SO_DONTROUTE,
 SO_RCVTIMEO, possibly more.