summaryrefslogtreecommitdiffstats
path: root/share/man/man4/filemon.4
diff options
context:
space:
mode:
authorobrien <obrien@FreeBSD.org>2012-06-05 20:32:38 +0000
committerobrien <obrien@FreeBSD.org>2012-06-05 20:32:38 +0000
commita8e30d2658c45d4d595d0a42cf55415acc7e3b6b (patch)
tree746e7661b1fab8b7357a1bfcb1b4894e41057ead /share/man/man4/filemon.4
parent7bbd1fbd36c9b9ef15effb74d2e22c60e2181703 (diff)
downloadFreeBSD-src-a8e30d2658c45d4d595d0a42cf55415acc7e3b6b.zip
FreeBSD-src-a8e30d2658c45d4d595d0a42cf55415acc7e3b6b.tar.gz
mdoc police.
Submitted by: ru Much thanks to: ru
Diffstat (limited to 'share/man/man4/filemon.4')
-rw-r--r--share/man/man4/filemon.452
1 files changed, 30 insertions, 22 deletions
diff --git a/share/man/man4/filemon.4 b/share/man/man4/filemon.4
index 6821f22..801f4df 100644
--- a/share/man/man4/filemon.4
+++ b/share/man/man4/filemon.4
@@ -50,64 +50,70 @@ responds to two
calls.
.Pp
System calls are denoted using the following single letters:
+.Pp
.Bl -tag -width indent -compact
-.It Dq Li C
+.It Ql C
.Xr chdir 2
-.It Dq Li D
+.It Ql D
.Xr unlink 2
-.It Dq Li E
+.It Ql E
.Xr exec 2
-.It Dq Li F
+.It Ql F
.Xr fork 2 ,
.Xr vfork 2
-.It Dq Li L
+.It Ql L
.Xr link 2 ,
.Xr linkat 2 ,
.Xr symlink 2 ,
.Xr symlinkat 2
-.It Dq Li M
+.It Ql M
.Xr rename 2
-.It Dq Li R
+.It Ql R
.Xr open 2
for read
-.It Dq Li S
+.It Ql S
.Xr stat 2
-.It Dq Li W
+.It Ql W
.Xr open 2
for write
-.It Dq Li X
+.It Ql X
.Xr _exit 2
.El
.Pp
Note that
-.Dq R
+.Ql R
following
-.Dq W
+.Ql W
records can represent a single
.Xr open 2
for R/W,
or two seperate
.Xr open 2
calls, one for
-R
+.Ql R
and one for
-W.
+.Ql W .
.Sh IOCTLS
User mode programs communicate with the
-.Nm filemon
-driver through a
-number of ioctls which are described below.
+.Nm
+driver through a number of ioctls which are described below.
Each takes a single argument.
-.Bl -tag -width FILEMON_SET_PID
+.Bl -tag -width ".Dv FILEMON_SET_PID"
.It Dv FILEMON_SET_FD
Write the internal tracing buffer to the supplied open file descriptor.
.It Dv FILEMON_SET_PID
Child process ID to trace.
.El
.Sh RETURN VALUES
-The ioctl returns zero on success and non-zero on failure.
+.\" .Rv -std ioctl
+The
+.Fn ioctl
+function returns the value 0 if successful;
+otherwise the value \-1 is returned and the global variable
+.Va errno
+is set to indicate the error.
.Sh FILES
-.Bl -tag -width /dev/zero
+.Bl -tag -width ".Pa /dev/filemon"
.It Pa /dev/filemon
.El
.Sh EXAMPLES
@@ -127,7 +133,7 @@ open_filemon(void)
int fm_fd, fm_log;
if ((fm_fd = open("/dev/filemon", O_RDWR)) == -1)
- err(1, "open(\"/dev/filemon\", O_RDWR)");
+ err(1, "open(\e"/dev/filemon\e", O_RDWR)");
if ((fm_log = open("filemon.out",
O_CREAT | O_WRONLY | O_TRUNC, DEFFILEMODE)) == -1)
err(1, "open(filemon.out)");
@@ -156,7 +162,9 @@ Creates a file named
.Pa filemon.out
and configures the
.Nm
-device to write the filemon buffer contents to it.
+device to write the
+.Nm
+buffer contents to it.
.Sh SEE ALSO
.Xr dtrace 1 ,
.Xr ktrace 1 ,
OpenPOWER on IntegriCloud