Date: Mon, 24 Jul 2017 16:58:54 +0000 (UTC) From: Edward Tomasz Napierala <trasz@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r321422 - head/usr.bin/ktrace Message-ID: <201707241658.v6OGwsc2092289@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: trasz Date: Mon Jul 24 16:58:54 2017 New Revision: 321422 URL: https://svnweb.freebsd.org/changeset/base/321422 Log: Improve the ktrace(1) man page to make it slightly more obvious that there are _two_ options that control its behaviour wrt child processes; slightly improve the example[1], and add Xrefs. Discussed with: wblock [1] MFC after: 2 weeks Sponsored by: DARPA, AFRL Modified: head/usr.bin/ktrace/ktrace.1 Modified: head/usr.bin/ktrace/ktrace.1 ============================================================================== --- head/usr.bin/ktrace/ktrace.1 Mon Jul 24 16:45:38 2017 (r321421) +++ head/usr.bin/ktrace/ktrace.1 Mon Jul 24 16:58:54 2017 (r321422) @@ -85,6 +85,9 @@ Clear the specified trace points associated with the g .It Fl d Descendants; perform the operation for all current children of the designated processes. +See also the +.Fl i +option. .It Fl f Ar trfile Log trace records to .Ar trfile @@ -97,6 +100,9 @@ flag is permitted). .It Fl i Inherit; pass the trace flags to all future children of the designated processes. +See also the +.Fl d +option. .It Fl p Ar pid Enable (disable) tracing on the indicated process id (only one .Fl p @@ -148,6 +154,9 @@ and .Ar command options are mutually exclusive. .Sh EXAMPLES +Run "make", then trace it and any child processes: +.Dl $ ktrace -i make +.Pp Trace all kernel operations of process id 34: .Dl $ ktrace -p 34 .Pp @@ -166,16 +175,15 @@ Enable tracing of on process 67: .Dl $ ktrace -ti -p 67 .Pp -Run the command "w", tracing only system calls: -.Dl $ ktrace -tc w -.Pp Disable all tracing to the file "tracedata": .Dl $ ktrace -c -f tracedata .Pp Disable tracing of all user-owned processes: .Dl $ ktrace -C .Sh SEE ALSO +.Xr dtrace 1 , .Xr kdump 1 , +.Xr truss 1 , .Xr ktrace 2 .Sh HISTORY The
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201707241658.v6OGwsc2092289>