sp_smaps_filter

Manual Reference Pages - SP_SMAPS_FILTER (1)

NAME

sp_smaps_filter - smaps capture file analysis tool

Synopsis
Description
Options
Examples
Notes
Copyright
See Also

SYNOPSIS

sp_smaps_filter [options] <capture file> ...

DESCRIPTION

This tool is used for processing capture files.
The following processing modes are available:

flatten:
heuristically detect and remove threads
input - capture file
output - capture file

normalize:
thread removal and conversion to csv format
input - capture file
output - csv file

appvals:
thread removal and output main per application values
input - capture file
output - csv file

analyze:
thread removal and conversion to html format
input - capture file
output - html index + sub pages in separate dir

diff:
thread removal and comparison of memory usage values
input - capture files
output - csv or html file

-h | --help
This help text
-V | --version
Tool version
-v | --verbose
Enable diagnostic messages
-q | --quiet
Disable warning messages
-s | --silent
Disable all messages
-f <source path> | --input=<source path>
Add capture file for processing.
-o <destination path> | --output=<destination path>
Override default output path.
-m <filter mode> | --mode=<filter mode>
One of:
flatten
normalize
analyze
appvals
diff
-l <level> | --difflevel=<level>
Display results at level:
0 = capture
1 = command
2 = command, pid
3 = command, pid, type
4 = command, pid, type, path
-t <level> | --trimlevel=<level>
Omit repeating classification data:
1 = command
2 = command, pid
3 = command, pid, type
4 = command, pid, type, path

EXAMPLES

% sp_smaps_filter -m flatten *.cap
writes capture format output without threads -> *.flat

% sp_smaps_filter -m normalize *.cap
writes csv format output -> *.csv

% sp_smaps_filter -m appcals *.cap
writes csv format summary -> *.apps

% sp_smaps_filter -m analyze *.cap
writes browsable html analysis index -> *.html

% sp_smaps_filter -m diff *.cap -o diff.sys.csv
difference report in csv minimum details

% sp_smaps_filter -m diff *.cap -o diff.obj.csv
difference report in csv maximum details

% sp_smaps_filter -m diff *.cap -o diff.pid.html -tapp
difference report in html details to pid.level
appcolumn output trimmed

NOTES

The filtering mode defaults to analyze, unless the program
is invoked via symlink in which case the mode determined
after the last underscore in invocation name, i.e.
% ln -s sp_smaps_filter sp_smaps_diff
% sp_smaps_diff ...
is equal to
% sp_smaps_filter -mdiff ...

COPYRIGHT

This is free software. You may redistribute copies of it under the
terms of the GNU General Public License v2 included with the software.
There is NO WARRANTY, to the extent permitted by law.

Register