svn commit: r334215 - head/usr.sbin/pmcstat

[Sean Bruno]

Author: sbruno
Date: Fri May 25 18:11:13 2018
New Revision: 334215
URL: https://svnweb.freebsd.org/changeset/base/334215

Log:
  pmcstat(8)
  - Document per thread filtering.
  
  Submitted by:	kbowling
  Sponsored by:	Limelight Networks
  Differential Revision:	https://reviews.freebsd.org/D15549

Modified:
  head/usr.sbin/pmcstat/pmcstat.8
  head/usr.sbin/pmcstat/pmcstat.c

Modified: head/usr.sbin/pmcstat/pmcstat.8
==============================================================================
--- head/usr.sbin/pmcstat/pmcstat.8	Fri May 25 18:07:20 2018	(r334214)
+++ head/usr.sbin/pmcstat/pmcstat.8	Fri May 25 18:11:13 2018	(r334215)
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 18, 2015
+.Dd May 25, 2018
 .Dt PMCSTAT 8
 .Os
 .Sh NAME
@@ -38,6 +38,8 @@
 .Op Fl E
 .Op Fl F Ar pathname
 .Op Fl G Ar pathname
+.Op Fl I
+.Op Fl L Ar lwp
 .Op Fl M Ar mapfilename
 .Op Fl N
 .Op Fl O Ar logfilename
@@ -155,6 +157,15 @@ is a
 this information is sent to the output file specified by the
 .Fl o
 option.
+.It Fl I
+Skip symbol lookup and display address instead.
+.It Fl L Ar lwp
+Filter on thread ID
+.Ar lwp ,
+which you can get from
+.Xr ps 1
+.Fl o
+.Li lwp .
 .It Fl M Ar mapfilename
 Write the mapping between executable objects encountered in the event
 log and the abbreviated pathnames used for

Modified: head/usr.sbin/pmcstat/pmcstat.c
==============================================================================
--- head/usr.sbin/pmcstat/pmcstat.c	Fri May 25 18:07:20 2018	(r334214)
+++ head/usr.sbin/pmcstat/pmcstat.c	Fri May 25 18:11:13 2018	(r334215)
@@ -365,8 +365,8 @@ pmcstat_show_usage(void)
 	    "\t -F file\t write a system-wide callgraph (Kcachegrind format)"
 		" to \"file\"\n"
 	    "\t -G file\t write a system-wide callgraph to \"file\"\n"
-	    "\t -I don't resolve leaf function but show address instead" 
-	    "\t -L \"tid\" filter on thread id in post-processing"
+	    "\t -I don't resolve leaf function name, show address instead\n"
+	    "\t -L lwp\t filter on thread id \"lwp\" in post-processing\n"
 	    "\t -M file\t print executable/gmon file map to \"file\"\n"
 	    "\t -N\t\t (toggle) capture callchains\n"
 	    "\t -O file\t send log output to \"file\"\n"