Blame SOURCES/0028-Remove-man-page-for-cpupcstat.patch

fc9b0e
From 0d29e25727e5e112de48ea2d4efbd99d378ba3ed Mon Sep 17 00:00:00 2001
fc9b0e
Message-Id: <0d29e25727e5e112de48ea2d4efbd99d378ba3ed.1566225007.git.aquini@redhat.com>
fc9b0e
In-Reply-To: <d42f467a923dfc09309acb7a83b42e3285fbd8f4.1566225007.git.aquini@redhat.com>
fc9b0e
References: <d42f467a923dfc09309acb7a83b42e3285fbd8f4.1566225007.git.aquini@redhat.com>
fc9b0e
From: Eric B Munson <eric@munsonfam.org>
fc9b0e
Date: Sat, 17 Aug 2019 13:59:58 -0400
fc9b0e
Subject: [RHEL7 PATCH 28/31] Remove man page for cpupcstat
fc9b0e
fc9b0e
This script was deleted some time ago, remove the man page.
fc9b0e
fc9b0e
Signed-off-by: Eric B Munson <eric@munsonfam.org>
fc9b0e
Signed-off-by: Rafael Aquini <aquini@redhat.com>
fc9b0e
---
fc9b0e
 man/cpupcstat.8 | 117 --------------------------------------------------------
fc9b0e
 1 file changed, 117 deletions(-)
fc9b0e
 delete mode 100644 man/cpupcstat.8
fc9b0e
fc9b0e
diff --git a/man/cpupcstat.8 b/man/cpupcstat.8
fc9b0e
deleted file mode 100644
fc9b0e
index d84a726..0000000
fc9b0e
--- a/man/cpupcstat.8
fc9b0e
+++ /dev/null
fc9b0e
@@ -1,117 +0,0 @@
fc9b0e
-.\"                                      Hey, EMACS: -*- nroff -*-
fc9b0e
-.\" First parameter, NAME, should be all caps
fc9b0e
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
fc9b0e
-.\" other parameters are allowed: see man(7), man(1)
fc9b0e
-.TH CPUCPSTAT 8 "9 June, 2009"
fc9b0e
-.\" Please adjust this date whenever revising the manpage.
fc9b0e
-.\"
fc9b0e
-.\" Some roff macros, for reference:
fc9b0e
-.\" .nh        disable hyphenation
fc9b0e
-.\" .hy        enable hyphenation
fc9b0e
-.\" .ad l      left justify
fc9b0e
-.\" .ad b      justify to both left and right margins
fc9b0e
-.\" .nf        disable filling
fc9b0e
-.\" .fi        enable filling
fc9b0e
-.\" .br        insert line break
fc9b0e
-.\" .sp <n>    insert n+1 empty lines
fc9b0e
-.\" for manpage-specific macros, see man(7)
fc9b0e
-.SH NAME
fc9b0e
-cpupcstat \- Measure the DTLB miss rate
fc9b0e
-.SH SYNOPSIS
fc9b0e
-.B cpupcstat [options] [target]
fc9b0e
-.SH DESCRIPTION
fc9b0e
-\fBcpupcstat\fP uses oprofile to measure the DTLB miss rate of a
fc9b0e
-specified application or the kernel.  It configures oprofile to count the
fc9b0e
-number of DTLB misses, optionally starts the \fBtarget\fP, and reports on the
fc9b0e
-miss rate over a specified interval as \fBtarget\fP executes.
fc9b0e
-
fc9b0e
-The following options can be used to configure how \fBcpupcstat\fP works:
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --vmlinux </path/to/vmlinux>
fc9b0e
-
fc9b0e
-This allows the user to specify where the appropriate vmlinux file is for their
fc9b0e
-kernel.  If this is not specified, /boot/vmlinux\-\`uname \-r\` will be used.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --delay <seconds>
fc9b0e
-
fc9b0e
-This allows the user to specify the reporting interval.  The default is 10
fc9b0e
-seconds.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --target-global
fc9b0e
-
fc9b0e
-Gather statistics for all processes and the kernel running in the system.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --target-pid <pid>
fc9b0e
-
fc9b0e
-This allows the user to specify the pid of a process already that is already
fc9b0e
-running.  If this option is specified, \fBtarget\fP will be ignored.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --real-target <real-target>
fc9b0e
-
fc9b0e
-Use this to specify the real name of the program to monitor if the \fBtarget\fP
fc9b0e
-is a launcher script.  When this is specified, \fBtarget\fP is executed but the
fc9b0e
-report will be for \fBreal-target\fP.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --time-limit <sec>
fc9b0e
-
fc9b0e
-This option sets the time limit for monitoring.  If this is specified the
fc9b0e
-\fBtarget\fP or \fBpid\fP will only be monitored for \fBsec\fP seconds.  The
fc9b0e
-default continues monitoring while \fBtarget\fP or \fBpid\fP are still alive.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --kernel
fc9b0e
-
fc9b0e
-This allows the user to request DTLB miss rate data be collected for the kernel
fc9b0e
-as well as the \fBtarget\fP.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --misses-per-instruction
fc9b0e
-
fc9b0e
-This option requests that the ratio of instructions retired per TLB miss.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --misses-per-cycle
fc9b0e
-
fc9b0e
-This option requests that the ratio of CPU cycles per TLB miss.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --time-servicing
fc9b0e
-
fc9b0e
-This option requests that the percentage of CPU cycles spent servicing TLB
fc9b0e
-misses is displayed when \fBcpupcstat\fB exits.  To use this option the cost
fc9b0e
-in CPU cycles for a single TLB miss must be specified using either the
fc9b0e
-\fB--cost-config\fB option or the \fBtlbmiss_cost.sh\fB script.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --cost-config </path/to/config>
fc9b0e
-
fc9b0e
-This option tells \fBcpupcstat\fB that the cost in CPU cycles of a TLB miss
fc9b0e
-can be found in the specified file, it should be specified as:
fc9b0e
-
fc9b0e
-TLB_MISS_COST=XX
fc9b0e
-
fc9b0e
-Where XX is the cost in cycles.  This option is only used with the
fc9b0e
-\fB--time-servicing\fB option.
fc9b0e
-
fc9b0e
-.TP
fc9b0e
-.B --force-oprofile
fc9b0e
-
fc9b0e
-\fBcpupcstat\fP prefers the perf tool for data collection, only using oprofile
fc9b0e
-if perf is not present or supported.  This option will force \fBcpupcstat\fP to
fc9b0e
-use oprofile for data collection.
fc9b0e
-
fc9b0e
-.SH SEE ALSO
fc9b0e
-.I oprofile(1)
fc9b0e
-.I perf(1)
fc9b0e
-.I tlbmiss_cost.sh(8)
fc9b0e
-.br
fc9b0e
-.SH AUTHORS
fc9b0e
-Eric B Munson <ebmunson@us.ibm.com> is the primary author. See the documentation
fc9b0e
-for other contributors.
fc9b0e
-
fc9b0e
-- 
fc9b0e
1.8.3.1
fc9b0e