From 3bf09f2dab9d8e3431702a2f50c2462a4b725c61 Mon Sep 17 00:00:00 2001 From: Brendan Gregg Date: Wed, 27 Jan 2016 23:11:12 -0800 Subject: [PATCH] wordwrap fix, and terminology adjustment --- man/man8/offcputime.8 | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/man/man8/offcputime.8 b/man/man8/offcputime.8 index 24ba0b8f9840..90863da41e3c 100644 --- a/man/man8/offcputime.8 +++ b/man/man8/offcputime.8 @@ -5,14 +5,14 @@ offcputime \- Summarize off-CPU time by kernel stack trace. Uses Linux eBPF/bcc. .B offcputime [\-h] [\-u] [\-p PID] [\-i INTERVAL] [\-T] [duration] .SH DESCRIPTION This program shows kernel stack traces and task names that were blocked and -"off-CPU", and the total duration they were blocked: their "off-CPU time". +"off-CPU", and the total duration they were not running: their "off-CPU time". It works by tracing when threads block and when they return to CPU, measuring -both the time they were blocked and the blocked kernel stack trace and the +both the time they were off-CPU and the blocked kernel stack trace and the task name. This data is summarized in the kernel using an eBPF map, and by -summing the blocked time by unique stack trace and task name. +summing the off-CPU time by unique stack trace and task name. The output summary will help you identify reasons why threads -were blocking, and quantify the time they were blocked. This spans all types +were blocking, and quantify the time they were off-CPU. This spans all types of blocking activity: disk I/O, network I/O, locks, page faults, involuntary context switches, etc. @@ -46,8 +46,7 @@ duration Duration to trace, in seconds. .SH EXAMPLES .TP -Trace all thread blocking events, and summarize (in-kernel) by kernel stack -trace and total off-CPU time: +Trace all thread blocking events, and summarize (in-kernel) by kernel stack trace and total off-CPU time: # .B offcputime .TP @@ -55,8 +54,7 @@ Trace for 5 seconds only: # .B offcputime 5 .TP -Trace for 5 seconds, and emit output in folded stack format (suitable for -flame graphs): +Trace for 5 seconds, and emit output in folded stack format (suitable for flame graphs): # .B offcputime -f 5 .TP