sp_smaps_snapshot

Manual Reference Pages - SP_SMAPS_SNAPSHOT (1)

NAME

sp_smaps_snapshot - create snapshot of /proc/[1-9]*/smaps files

Synopsis
Description
Options
Examples
Copyright
See Also

DESCRIPTION

This tool generates snapshot of /proc/pid/smaps information
for all processes in the system.

The smaps data from all processes in concatenated into the
output. Additionally, some data from /proc/pid/status is
also included for each process to help postprocessing tools
such as sp_smaps_analyze to perform additional tasks like
recognizing multiple threads belonging to one application
in order to provide more accurate memory usage statistics.

When run as root, it's possible to request this tool to
boost its priority to not-nice-at-all realtime scheduling which
hopefully yields more stable results for threads of MT apps.
However, this can be cause instability at least when the command
is run from a serial console, so this behavior is optional
rather than the default.

OPTIONS

-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>
Input file to use from /proc/pid/ instead of smaps.
-o <destination path> | --output=<destination path>
Output file to use instead of stdout.
-r | --realtime
Use realtime priority (needs to be run as root for this)

EXAMPLES

% sp_smaps_snapshot > after_boot.cap

Writes output fairly similar to 'head -2000 /proc/[1-9]*/smaps' to
logfile 'after_boot.cap'. (but with some additional data per process)

% sp_smaps_snapshot -fstatus -ostatus.log

Writes content of all proc/pid/status files to logfile status.log

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