perf script: Fix documentation of '-f' when it should be '-F'
The documentation for perf script mixes up '-f' and '-F'. Fix it. Signed-off-by: Adrian Hunter <adrian.hunter@intel.com> Cc: Andi Kleen <ak@linux.intel.com> Cc: Jiri Olsa <jolsa@redhat.com> Link: http://lkml.kernel.org/r/None Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
This commit is contained in:
parent
b573d8028e
commit
cbb0bba9f3
|
@ -119,13 +119,13 @@ OPTIONS
|
||||||
srcline, period, iregs, brstack, brstacksym, flags.
|
srcline, period, iregs, brstack, brstacksym, flags.
|
||||||
Field list can be prepended with the type, trace, sw or hw,
|
Field list can be prepended with the type, trace, sw or hw,
|
||||||
to indicate to which event type the field list applies.
|
to indicate to which event type the field list applies.
|
||||||
e.g., -f sw:comm,tid,time,ip,sym and -f trace:time,cpu,trace
|
e.g., -F sw:comm,tid,time,ip,sym and -F trace:time,cpu,trace
|
||||||
|
|
||||||
perf script -f <fields>
|
perf script -F <fields>
|
||||||
|
|
||||||
is equivalent to:
|
is equivalent to:
|
||||||
|
|
||||||
perf script -f trace:<fields> -f sw:<fields> -f hw:<fields>
|
perf script -F trace:<fields> -F sw:<fields> -F hw:<fields>
|
||||||
|
|
||||||
i.e., the specified fields apply to all event types if the type string
|
i.e., the specified fields apply to all event types if the type string
|
||||||
is not given.
|
is not given.
|
||||||
|
@ -133,9 +133,9 @@ OPTIONS
|
||||||
The arguments are processed in the order received. A later usage can
|
The arguments are processed in the order received. A later usage can
|
||||||
reset a prior request. e.g.:
|
reset a prior request. e.g.:
|
||||||
|
|
||||||
-f trace: -f comm,tid,time,ip,sym
|
-F trace: -F comm,tid,time,ip,sym
|
||||||
|
|
||||||
The first -f suppresses trace events (field list is ""), but then the
|
The first -F suppresses trace events (field list is ""), but then the
|
||||||
second invocation sets the fields to comm,tid,time,ip,sym. In this case a
|
second invocation sets the fields to comm,tid,time,ip,sym. In this case a
|
||||||
warning is given to the user:
|
warning is given to the user:
|
||||||
|
|
||||||
|
@ -143,9 +143,9 @@ OPTIONS
|
||||||
|
|
||||||
Alternatively, consider the order:
|
Alternatively, consider the order:
|
||||||
|
|
||||||
-f comm,tid,time,ip,sym -f trace:
|
-F comm,tid,time,ip,sym -F trace:
|
||||||
|
|
||||||
The first -f sets the fields for all events and the second -f
|
The first -F sets the fields for all events and the second -F
|
||||||
suppresses trace events. The user is given a warning message about
|
suppresses trace events. The user is given a warning message about
|
||||||
the override, and the result of the above is that only S/W and H/W
|
the override, and the result of the above is that only S/W and H/W
|
||||||
events are displayed with the given fields.
|
events are displayed with the given fields.
|
||||||
|
@ -154,14 +154,14 @@ OPTIONS
|
||||||
event type, a message is displayed to the user that the option is
|
event type, a message is displayed to the user that the option is
|
||||||
ignored for that type. For example:
|
ignored for that type. For example:
|
||||||
|
|
||||||
$ perf script -f comm,tid,trace
|
$ perf script -F comm,tid,trace
|
||||||
'trace' not valid for hardware events. Ignoring.
|
'trace' not valid for hardware events. Ignoring.
|
||||||
'trace' not valid for software events. Ignoring.
|
'trace' not valid for software events. Ignoring.
|
||||||
|
|
||||||
Alternatively, if the type is given an invalid field is specified it
|
Alternatively, if the type is given an invalid field is specified it
|
||||||
is an error. For example:
|
is an error. For example:
|
||||||
|
|
||||||
perf script -v -f sw:comm,tid,trace
|
perf script -v -F sw:comm,tid,trace
|
||||||
'trace' not valid for software events.
|
'trace' not valid for software events.
|
||||||
|
|
||||||
At this point usage is displayed, and perf-script exits.
|
At this point usage is displayed, and perf-script exits.
|
||||||
|
@ -173,7 +173,7 @@ OPTIONS
|
||||||
respectively.
|
respectively.
|
||||||
|
|
||||||
Finally, a user may not set fields to none for all event types.
|
Finally, a user may not set fields to none for all event types.
|
||||||
i.e., -f "" is not allowed.
|
i.e., -F "" is not allowed.
|
||||||
|
|
||||||
The brstack output includes branch related information with raw addresses using the
|
The brstack output includes branch related information with raw addresses using the
|
||||||
/v/v/v/v/ syntax in the following order:
|
/v/v/v/v/ syntax in the following order:
|
||||||
|
|
Loading…
Reference in a new issue