Module Name: src
Committed By: pgoyette
Date: Wed Jan 6 01:54:53 UTC 2016
Modified Files:
src/share/man/man4: filemon.4
Log Message:
Add a BUGS section...
To generate a diff of this commit:
cvs rdiff -u -r1.15 -r1.16 src/share/man/man4/filemon.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/filemon.4
diff -u src/share/man/man4/filemon.4:1.15 src/share/man/man4/filemon.4:1.16
--- src/share/man/man4/filemon.4:1.15 Mon Nov 23 23:28:33 2015
+++ src/share/man/man4/filemon.4 Wed Jan 6 01:54:53 2016
@@ -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 @@ successful, and is thus more complex to
.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.
