From owner-svn-src-stable@freebsd.org Wed Oct 4 11:59:54 2017 Return-Path: Delivered-To: svn-src-stable@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id A8A13E37414; Wed, 4 Oct 2017 11:59:54 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 7591083A7E; Wed, 4 Oct 2017 11:59:54 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v94BxrVm012411; Wed, 4 Oct 2017 11:59:53 GMT (envelope-from trasz@FreeBSD.org) Received: (from trasz@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v94Bxrf6012410; Wed, 4 Oct 2017 11:59:53 GMT (envelope-from trasz@FreeBSD.org) Message-Id: <201710041159.v94Bxrf6012410@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: trasz set sender to trasz@FreeBSD.org using -f From: Edward Tomasz Napierala Date: Wed, 4 Oct 2017 11:59:53 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-11@freebsd.org Subject: svn commit: r324269 - stable/11/usr.bin/ktrace X-SVN-Group: stable-11 X-SVN-Commit-Author: trasz X-SVN-Commit-Paths: stable/11/usr.bin/ktrace X-SVN-Commit-Revision: 324269 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-stable@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for all the -stable branches of the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 04 Oct 2017 11:59:54 -0000 Author: trasz Date: Wed Oct 4 11:59:53 2017 New Revision: 324269 URL: https://svnweb.freebsd.org/changeset/base/324269 Log: MFC r321422: 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. Modified: stable/11/usr.bin/ktrace/ktrace.1 Directory Properties: stable/11/ (props changed) Modified: stable/11/usr.bin/ktrace/ktrace.1 ============================================================================== --- stable/11/usr.bin/ktrace/ktrace.1 Wed Oct 4 11:58:52 2017 (r324268) +++ stable/11/usr.bin/ktrace/ktrace.1 Wed Oct 4 11:59:53 2017 (r324269) @@ -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