Fri Jun 26 15:45:18 2020 UTC ()
Sort options and their descriptions.
Replace tab with space in table.
Make non-standard section subsections.
Comment out Xr to procsystime(1) which does not exist on NetBSD.


(wiz)
diff -r1.5 -r1.6 src/external/cddl/dtracetoolkit/dist/Man/man1m/dtruss.1m
diff -r1.4 -r1.5 src/external/cddl/dtracetoolkit/dist/Man/man1m/opensnoop.1m
cvs diff -r1.5 -r1.6 src/external/cddl/dtracetoolkit/dist/Man/man1m/dtruss.1m (expand / switch to unified diff)

--- src/external/cddl/dtracetoolkit/dist/Man/man1m/dtruss.1m 2020/06/25 14:08:48 1.5
+++ src/external/cddl/dtracetoolkit/dist/Man/man1m/dtruss.1m 2020/06/26 15:45:18 1.6
@@ -1,23 +1,23 @@ @@ -1,23 +1,23 @@
1.\" $NetBSD: dtruss.1m,v 1.5 2020/06/25 14:08:48 uwe Exp $ 1.\" $NetBSD: dtruss.1m,v 1.6 2020/06/26 15:45:18 wiz Exp $
2.Dd June 25, 2020 2.Dd June 25, 2020
3.Dt DTRUSS 1 3.Dt DTRUSS 1
4.Os 4.Os
5.Sh NAME 5.Sh NAME
6.Nm dtruss 6.Nm dtruss
7.Nd process syscall details. Uses DTrace 7.Nd process syscall details. Uses DTrace
8.Sh SYNOPSIS 8.Sh SYNOPSIS
9.Nm 9.Nm
10.Op Fl acdeflhoLs 10.Op Fl acdeflhLos
11.Op Fl t Ar syscall 11.Op Fl t Ar syscall
12.Op Fl p Ar PID | Fl n Ar name | command 12.Op Fl p Ar PID | Fl n Ar name | command
13.Sh DESCRIPTION 13.Sh DESCRIPTION
14.Nm 14.Nm
15prints details on process system calls. 15prints details on process system calls.
16It is like a DTrace version of truss, and has been designed to be less 16It is like a DTrace version of truss, and has been designed to be less
17intrusive than truss. 17intrusive than truss.
18.Pp 18.Pp
19Of particular interest is the elapsed times and on cpu times, which can 19Of particular interest is the elapsed times and on cpu times, which can
20identify both system calls that are slow to complete, and those which are 20identify both system calls that are slow to complete, and those which are
21consuming CPU cycles. 21consuming CPU cycles.
22.Pp 22.Pp
23Since this uses DTrace, only the root user or users with the dtrace_kernel 23Since this uses DTrace, only the root user or users with the dtrace_kernel
@@ -29,47 +29,47 @@ print all details @@ -29,47 +29,47 @@ print all details
29dynamic variable buffer size. 29dynamic variable buffer size.
30Increase this if you notice dynamic variable drop errors. 30Increase this if you notice dynamic variable drop errors.
31The default is 31The default is
32.Ql "4m" 32.Ql "4m"
33for 4\~megabytes per CPU. 33for 4\~megabytes per CPU.
34.It Fl c 34.It Fl c
35print system call counts 35print system call counts
36.It Fl d 36.It Fl d
37print relative timestamps, us (microseconds) 37print relative timestamps, us (microseconds)
38.It Fl e 38.It Fl e
39print elapsed times, us 39print elapsed times, us
40.It Fl f 40.It Fl f
41follow children as they are forked 41follow children as they are forked
42.It Fl l 
43force printing of pid/lwpid per line 
44.It Fl L 42.It Fl L
45don't print pid/lwpid per line 43don't print pid/lwpid per line
 44.It Fl l
 45force printing of pid/lwpid per line
46.It Fl n Ar name 46.It Fl n Ar name
47examine processes with this name 47examine processes with this name
48.It Fl o 48.It Fl o
49print on-cpu times, us 49print on-cpu times, us
50.It Fl s 
51print stack backtraces 
52.It Fl p Ar PID 50.It Fl p Ar PID
53examine this PID 51examine this PID
 52.It Fl s
 53print stack backtraces
54.It Fl t Ar syscall 54.It Fl t Ar syscall
55examine this syscall only 55examine this syscall only
56.El 56.El
57.Bl -column "SYSCALL(args)" 57.Bl -column "SYSCALL(args)"
58.It Sy Field Ta Sy Description 58.It Sy Field Ta Sy Description
59.It PID/LWPID Ta Process ID\|/\|Lightweight Process ID 59.It PID/LWPID Ta Process ID\|/\|Lightweight Process ID
60.It RELATIVE Ta relative timestamps to the start of the thread, us 60.It RELATIVE Ta relative timestamps to the start of the thread, us
61.It ELAPSD Ta elapsed time for this system call, us 61.It ELAPSD Ta elapsed time for this system call, us
62.It CPU Ta on-cpu time for this system call, us 62.It CPU Ta on-cpu time for this system call, us
63.It SYSCALL(args) Ta system call name, with arguments (some may be evaluated) 63.It SYSCALL(args) Ta system call name, with arguments (some may be evaluated)
64.El 64.El
65.Sh EXAMPLES 65.Sh EXAMPLES
66run and examine the 66run and examine the
67.Ql df -h 67.Ql df -h
68command 68command
69.Pp 69.Pp
70.Dl Ic dtruss df -h 70.Dl Ic dtruss df -h
71.Pp 71.Pp
72examine PID 1871 72examine PID 1871
73.Pp 73.Pp
74.Dl Ic dtruss -p 1871 74.Dl Ic dtruss -p 1871
75.Pp 75.Pp
@@ -78,28 +78,28 @@ examine all processes called "tar" @@ -78,28 +78,28 @@ examine all processes called "tar"
78.Dl Ic dtruss -n tar 78.Dl Ic dtruss -n tar
79.Pp 79.Pp
80run 80run
81.Ql test.sh 81.Ql test.sh
82and follow children 82and follow children
83.Pp 83.Pp
84.Dl Ic dtruss -f test.sh 84.Dl Ic dtruss -f test.sh
85.Pp 85.Pp
86run the 86run the
87.Ql date 87.Ql date
88command and print elapsed and on cpu times, 88command and print elapsed and on cpu times,
89.Pp 89.Pp
90.Dl Ic dtruss -eo date 90.Dl Ic dtruss -eo date
91.Sh STABILITY 91.Ss STABILITY
92stable \(em needs the syscall provider. 92stable \(em needs the syscall provider.
93.Sh DOCUMENTATION 93.Ss DOCUMENTATION
94See the DTraceToolkit for further documentation under the Docs directory. 94See the DTraceToolkit for further documentation under the Docs directory.
95The DTraceToolkit docs may include full worked examples with verbose 95The DTraceToolkit docs may include full worked examples with verbose
96descriptions explaining the output. 96descriptions explaining the output.
97.Sh EXIT 97.Sh EXIT
98dtruss will run forever until Ctrl\-C is hit, or if a command was 98dtruss will run forever until Ctrl\-C is hit, or if a command was
99executed dtruss will finish when the command ends. 99executed dtruss will finish when the command ends.
100.Sh SEE ALSO 100.Sh SEE ALSO
101.Xr dtrace 1 , 101.Xr dtrace 1
102.Xr procsystime 1 102.\".Xr procsystime 1
103.Sh AUTHORS 103.Sh AUTHORS
104.An Brendan Gregg 104.An Brendan Gregg
105[Sydney, Australia] 105[Sydney, Australia]
cvs diff -r1.4 -r1.5 src/external/cddl/dtracetoolkit/dist/Man/man1m/opensnoop.1m (expand / switch to unified diff)

--- src/external/cddl/dtracetoolkit/dist/Man/man1m/opensnoop.1m 2020/06/25 14:59:51 1.4
+++ src/external/cddl/dtracetoolkit/dist/Man/man1m/opensnoop.1m 2020/06/26 15:45:18 1.5
@@ -1,61 +1,61 @@ @@ -1,61 +1,61 @@
1.\" $NetBSD: opensnoop.1m,v 1.4 2020/06/25 14:59:51 uwe Exp $ 1.\" $NetBSD: opensnoop.1m,v 1.5 2020/06/26 15:45:18 wiz Exp $
2.Dd June 25, 2020 2.Dd June 25, 2020
3.Dt OPENSNOOP 1 3.Dt OPENSNOOP 1
4.Os 4.Os
5.Sh NAME 5.Sh NAME
6.Nm opensnoop 6.Nm opensnoop
7.Nd snoop file opens as they occur. Uses DTrace 7.Nd snoop file opens as they occur. Uses DTrace
8.Sh SYNOPSIS 8.Sh SYNOPSIS
9.Nm 9.Nm
10.Op Fl a | Fl A | Fl ceghsvxZ 10.Op Fl a | Fl A | Fl ceghsvxZ
11.Op Fl f Ar pathname 11.Op Fl f Ar pathname
12.Op Fl n Ar name 12.Op Fl n Ar name
13.Op Fl p Ar PID 13.Op Fl p Ar PID
14.Sh DESCRIPTION 14.Sh DESCRIPTION
15.Nm 15.Nm
16tracks file opens. 16tracks file opens.
17As a process issues a file open, details such as UID, PID and pathname are 17As a process issues a file open, details such as UID, PID and pathname are
18printed out. 18printed out.
19The returned file descriptor is printed, a value of \-1 indicates an error. 19The returned file descriptor is printed, a value of \-1 indicates an error.
20This can be useful for troubleshooting to determine if appliacions are 20This can be useful for troubleshooting to determine if appliacions are
21attempting to open files that do not exist. 21attempting to open files that do not exist.
22Since this uses DTrace, only the root user or users with the 22Since this uses DTrace, only the root user or users with the
23dtrace_kernel privilege can run this command. 23dtrace_kernel privilege can run this command.
24.Bl -tag -width Fl 24.Bl -tag -width Fl
25.It Fl a 
26print all data 
27.It Fl A 25.It Fl A
28dump all data, space delimited 26dump all data, space delimited
 27.It Fl a
 28print all data
29.It Fl c 29.It Fl c
30print current working directory of process 30print current working directory of process
31.It Fl e 31.It Fl e
32print errno value 32print errno value
 33.It Fl f Ar pathname
 34file pathname to snoop
33.It Fl g 35.It Fl g
34print full command arguments 36print full command arguments
 37.It Fl n Ar name
 38process name to snoop
 39.It Fl p Ar PID
 40process ID to snoop
35.It Fl s 41.It Fl s
36print start time, us 42print start time, us
37.It Fl v 43.It Fl v
38print start time, string 44print start time, string
39.It Fl x 45.It Fl x
40only print failed opens 46only print failed opens
41.It Fl Z 47.It Fl Z
42print zonename 48print zonename
43.It Fl f Ar pathname 
44file pathname to snoop 
45.It Fl n Ar name 
46process name to snoop 
47.It Fl p Ar PID 
48process ID to snoop 
49.El 49.El
50.Bl -column "STRTIME" 50.Bl -column "STRTIME"
51.It Sy Fields Ta Sy Description 51.It Sy Fields Ta Sy Description
52.It ZONE Ta Zone name 52.It ZONE Ta Zone name
53.It UID Ta User ID 53.It UID Ta User ID
54.It PID Ta Process ID 54.It PID Ta Process ID
55.It PPID Ta Parent Process ID 55.It PPID Ta Parent Process ID
56.It FD Ta File Descriptor 56.It FD Ta File Descriptor
57.Pq \-1 is error 57.Pq \-1 is error
58.It ERR Ta Va errno 58.It ERR Ta Va errno
59value 59value
60.Pq see Pa /usr/include/sys/errno.h 60.Pq see Pa /usr/include/sys/errno.h
61.It CWD Ta current working directory of process 61.It CWD Ta current working directory of process
@@ -71,29 +71,29 @@ Default output, print file opens by proc @@ -71,29 +71,29 @@ Default output, print file opens by proc
71.Dl Ic opensnoop 71.Dl Ic opensnoop
72.Pp 72.Pp
73Print human readable timestamps, 73Print human readable timestamps,
74.Pp 74.Pp
75.Dl Ic opensnoop -v 75.Dl Ic opensnoop -v
76.Pp 76.Pp
77See error codes, 77See error codes,
78.Pp 78.Pp
79.Dl Ic opensnoop -e 79.Dl Ic opensnoop -e
80.Pp 80.Pp
81Snoop this file only, 81Snoop this file only,
82.Pp 82.Pp
83.Dl Ic opensnoop -f /etc/passwd 83.Dl Ic opensnoop -f /etc/passwd
84.Sh STABILITY 84.Ss STABILITY
85stable \(em needs the syscall provider. 85stable \(em needs the syscall provider.
86.Sh DOCUMENTATION 86.Ss DOCUMENTATION
87See the DTraceToolkit for further documentation under the Docs directory. 87See the DTraceToolkit for further documentation under the Docs directory.
88The DTraceToolkit docs may include full worked examples with verbose 88The DTraceToolkit docs may include full worked examples with verbose
89descriptions explaining the output. 89descriptions explaining the output.
90.Sh EXIT 90.Sh EXIT
91.Nm 91.Nm
92will run forever until Ctrl\-C is hit. 92will run forever until Ctrl\-C is hit.
93.Sh SEE ALSO 93.Sh SEE ALSO
94.Xr dtrace 1 94.Xr dtrace 1
95.Sh AUTHORS 95.Sh AUTHORS
96.An Brendan Gregg 96.An Brendan Gregg
97[Sydney, Australia] 97[Sydney, Australia]
98.Sh BUGS 98.Sh BUGS
99Occasionally the pathname for the file open cannot be read and the following 99Occasionally the pathname for the file open cannot be read and the following