From ec791cadb1947bb1e7a2186df260cb79efd26dc2 Mon Sep 17 00:00:00 2001
From: Brian Somers <brian@FreeBSD.org>
Date: Sat, 9 May 1998 14:45:06 +0000
Subject: [PATCH] Add a BUGS section and describe a problem I've been having
 for a few weeks now.

---
 lib/libc/sys/send.2 | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/lib/libc/sys/send.2 b/lib/libc/sys/send.2
index 57fcfb3ae3c..bf7bd4a6137 100644
--- a/lib/libc/sys/send.2
+++ b/lib/libc/sys/send.2
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     From: @(#)send.2	8.2 (Berkeley) 2/21/94
-.\"	$Id$
+.\"	$Id: send.2,v 1.7 1997/02/22 15:04:22 peter Exp $
 .\"
 .Dd February 15, 1995
 .Dt SEND 2
@@ -171,6 +171,19 @@ but may be caused by transient congestion.
 .It Bq Er EHOSTUNREACH
 The remote host was unreachable.
 .El
+.Sh BUGS
+Because
+.Fn sendmsg
+doesn't necessarily block until the data has been transferred, it
+is possible to transfer an open file descriptor across an
+.Dv AF_UNIX
+domain socket
+.Pq see Xr recv 2 ,
+then
+.Fn close
+it before it has actually been sent, the result being that the receiver
+gets a closed file descriptor.  It is left to the application to
+implement an acknowlegment mechanism to prevent this from happening.
 .Sh SEE ALSO
 .Xr fcntl 2 ,
 .Xr getsockopt 2 ,