Module Name: src
Committed By: wiz
Date: Wed Jul 18 16:50:05 UTC 2018
Modified Files:
src/usr.sbin/tprof: tprof.8 tprof.c
Log Message:
Various improvements to man page. Sync usage.
To generate a diff of this commit:
cvs rdiff -u -r1.8 -r1.9 src/usr.sbin/tprof/tprof.8
cvs rdiff -u -r1.11 -r1.12 src/usr.sbin/tprof/tprof.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/usr.sbin/tprof/tprof.8
diff -u src/usr.sbin/tprof/tprof.8:1.8 src/usr.sbin/tprof/tprof.8:1.9
--- src/usr.sbin/tprof/tprof.8:1.8 Fri Jul 13 12:04:50 2018
+++ src/usr.sbin/tprof/tprof.8 Wed Jul 18 16:50:05 2018
@@ -1,4 +1,4 @@
-.\" $NetBSD: tprof.8,v 1.8 2018/07/13 12:04:50 maxv Exp $
+.\" $NetBSD: tprof.8,v 1.9 2018/07/18 16:50:05 wiz Exp $
.\"
.\" Copyright (c)2011 YAMAMOTO Takashi,
.\" All rights reserved.
@@ -58,7 +58,7 @@ The first argument,
.Ar op ,
specifies the action to take.
Valid actions are:
-.Bl -tag -width offline
+.Bl -tag -width offline -offset indent
.It list
Display a list of performance counter events available on the system.
.It monitor Xo
@@ -84,12 +84,8 @@ if specified.
The default is
.Dq Pa tprof.out .
.It analyze Xo
-.Op Fl C
-.Op Fl k
-.Op Fl L
-.Op Fl P
+.Op Fl CkLPs
.Op Fl p Ar pid
-.Op Fl s
.Ar file
.Xc
Analyze the samples produced by a previous run of
@@ -97,6 +93,7 @@ Analyze the samples produced by a previo
stored in
.Ar file ,
and generate a plain text representation of them.
+.Bl -tag -width XPXpidXX -offset indent
.It Fl C
Don't distinguish CPUs.
All samples are treated as its CPU number is 0.
@@ -116,13 +113,13 @@ and ignore the rest.
.It Fl s
Per symbol.
.El
+.El
.Sh EXAMPLES
The following command profiles the system during 20 seconds and writes the
samples into the file myfile.out.
.Dl # tprof monitor -e llc-misses:k -o myfile.out sleep 20
The following command displays the results of the sampling.
.Dl # tprof analyze myfile.out
-.Ed
.Sh DIAGNOSTICS
The
.Nm
@@ -148,6 +145,7 @@ were dropped.
.Sh SEE ALSO
.Xr tprof 4
.Sh AUTHORS
+.An -nosplit
The
.Nm
utility is written by
Index: src/usr.sbin/tprof/tprof.c
diff -u src/usr.sbin/tprof/tprof.c:1.11 src/usr.sbin/tprof/tprof.c:1.12
--- src/usr.sbin/tprof/tprof.c:1.11 Sat Jul 14 16:34:15 2018
+++ src/usr.sbin/tprof/tprof.c Wed Jul 18 16:50:05 2018
@@ -1,4 +1,4 @@
-/* $NetBSD: tprof.c,v 1.11 2018/07/14 16:34:15 jmcneill Exp $ */
+/* $NetBSD: tprof.c,v 1.12 2018/07/18 16:50:05 wiz Exp $ */
/*
* Copyright (c) 2018 The NetBSD Foundation, Inc.
@@ -57,7 +57,7 @@
#include <sys/cdefs.h>
#ifndef lint
-__RCSID("$NetBSD: tprof.c,v 1.11 2018/07/14 16:34:15 jmcneill Exp $");
+__RCSID("$NetBSD: tprof.c,v 1.12 2018/07/18 16:50:05 wiz Exp $");
#endif /* not lint */
#include <sys/ioctl.h>
@@ -109,7 +109,7 @@ usage(void)
fprintf(stderr, "\tmonitor -e name:option [-o outfile] command\n");
fprintf(stderr, "\t\tMonitor the event 'name' with option 'option'\n"
"\t\tcounted during the execution of 'command'.\n");
- fprintf(stderr, "\tanalyze [-C] [-k] [-L] [-P] [-p pid] [-s] file\n");
+ fprintf(stderr, "\tanalyze [-CkLPs] [-p pid] file\n");
fprintf(stderr, "\t\tAnalyze the samples of the file 'file'.\n");
exit(EXIT_FAILURE);
