[src/trunk]: src/external/bsd/blacklist/lib Clarify that we always need a val...

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

details:   https://anonhg.NetBSD.org/src/rev/7619f237120e
branches:  trunk
changeset: 746398:7619f237120e
user:      christos <christos%NetBSD.org@localhost>
date:      Mon Mar 30 15:47:15 2020 +0000

description:
Clarify that we always need a valid socket

diffstat:

 external/bsd/blacklist/lib/libblacklist.3 |  12 ++++++++++--
 1 files changed, 10 insertions(+), 2 deletions(-)

diffs (33 lines):

diff -r 763de40d4405 -r 7619f237120e external/bsd/blacklist/lib/libblacklist.3
--- a/external/bsd/blacklist/lib/libblacklist.3 Mon Mar 30 15:31:52 2020 +0000
+++ b/external/bsd/blacklist/lib/libblacklist.3 Mon Mar 30 15:47:15 2020 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: libblacklist.3,v 1.9 2019/11/06 20:50:01 christos Exp $
+.\" $NetBSD: libblacklist.3,v 1.10 2020/03/30 15:47:15 christos Exp $
 .\"
 .\" Copyright (c) 2015 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 5, 2017
+.Dd March 30, 2020
 .Dt LIBBLACKLIST 3
 .Os
 .Sh NAME
@@ -122,6 +122,14 @@
 .Xr getpeername 2
 will not work, the server will pass the peer name in the message.
 .Pp
+In all cases the file descriptor passed in the
+.Fa fd
+argument must be pointing to a valid socket so that
+.Xr blacklistd 8
+can establish ownership of the local endpoint
+using
+.Xr getsockname 2 .
+.Pp
 By default,
 .Xr syslogd 8
 is used for message logging.