[src/trunk]: src/share/man/man4 Add a BUGS section...

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

details:   https://anonhg.NetBSD.org/src/rev/8ea6220e67b5
branches:  trunk
changeset: 812849:8ea6220e67b5
user:      pgoyette <pgoyette%NetBSD.org@localhost>
date:      Wed Jan 06 01:54:53 2016 +0000

description:
Add a BUGS section...

diffstat:

 share/man/man4/filemon.4 |  12 ++++++++++--
 1 files changed, 10 insertions(+), 2 deletions(-)

diffs (33 lines):

diff -r f4d82b89a4f3 -r 8ea6220e67b5 share/man/man4/filemon.4
--- a/share/man/man4/filemon.4  Wed Jan 06 01:37:17 2016 +0000
+++ b/share/man/man4/filemon.4  Wed Jan 06 01:54:53 2016 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: filemon.4,v 1.15 2015/11/23 23:28:33 pgoyette Exp $
+.\"    $NetBSD: filemon.4,v 1.16 2016/01/06 01:54:53 pgoyette Exp $
 .\"
 .\" Copyright (c) 2011, Juniper Networks, Inc.
 .\"
@@ -23,7 +23,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 .\" OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd November 24, 2015
+.Dd January 6, 2016
 .Dt FILEMON 4
 .Os
 .Sh NAME
@@ -218,6 +218,14 @@
 .Sh HISTORY
 .Nm
 was contributed by Juniper Networks.
+.Sh BUGS
+If the file descriptor to which monitored events are being written is
+numerically lower than the descriptor on which /dev/filemon is open, the
+monitoring process will hang when it calls
+.Xr exit 3
+or an attempt is made to close the output file descriptor.
+To avoid the hang, ensure that the file descriptor on which /dev/filemon
+is open gets closed first.
 .Sh SECURITY CONSIDERATIONS
 Monitoring of a process enables the target process to write to the
 tracking process's file descriptor.