git: 03399cd6e04e - main - filemon.4: Document FILEMON_SET_FD errors and refine wording a bit

From: Mark Johnston <markj_at_FreeBSD.org>
Date: Thu, 03 Feb 2022 14:47:07 UTC
The branch main has been updated by markj:

URL: https://cgit.FreeBSD.org/src/commit/?id=03399cd6e04eb108db0392c8e77eb6ea00c5532e

commit 03399cd6e04eb108db0392c8e77eb6ea00c5532e
Author:     Mark Johnston <markj@FreeBSD.org>
AuthorDate: 2022-02-03 14:42:14 +0000
Commit:     Mark Johnston <markj@FreeBSD.org>
CommitDate: 2022-02-03 14:46:34 +0000

    filemon.4: Document FILEMON_SET_FD errors and refine wording a bit
    
    Reviewed by:    emaste, debdrup, Pau Amma
    MFC after:      1 week
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:  https://reviews.freebsd.org/D34128
---
 share/man/man4/filemon.4 | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/share/man/man4/filemon.4 b/share/man/man4/filemon.4
index 24707fe3e592..9fb2fe10a2ec 100644
--- a/share/man/man4/filemon.4
+++ b/share/man/man4/filemon.4
@@ -31,7 +31,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 15, 2019
+.Dd February 1, 2022
 .Dt FILEMON 4
 .Os
 .Sh NAME
@@ -51,10 +51,10 @@ calls.
 .Pp
 .Nm
 is not intended to be a security auditing tool.
-Many system calls are not tracked and binaries of foreign ABI will not be fully
-audited.
-It is intended for auditing of processes for the purpose of determining its
-dependencies in an efficient and easily parsable format.
+Many system calls are not tracked and binaries using a non-native ABI may not
+be fully audited.
+It is intended for auditing of processes for the purpose of determining their
+dependencies using an efficient and easily parsable format.
 An example of this is
 .Xr make 1
 which uses this module with
@@ -145,6 +145,11 @@ will fail if:
 The
 .Nm
 handle is already associated with a file descriptor.
+.It Bq Er EINVAL
+The file descriptor has an invalid type and cannot be used for
+tracing.
+.It Bq Er EBADF
+The file descriptor is invalid or not opened for writing.
 .El
 .Pp
 The