footprint(1) BSD General Commands Manual footprint(1)
NAME
footprint -- gathers memory information about a process or set of pro-
cesses.
SYNOPSIS
footprint -h
footprint -proc <process-name> | -pid <pid> [-proc <process-name> | -pid
<pid> [...]]
[-categories | -regions] [-swapped]
[-graphics] [-collapseSharing] [-targetChildren]
[-skipIdleExitClean]
[-o <output-file-location>]
[-i <input-file-location>]
DESCRIPTION
footprint provides a summary number and a categorization that describe
memory use that most impacts the system.
footprint gathers the sum of dirty/anonymous allocations in one or more
processes along with their attributable kernel resources (currently
KPRVT). Shared allocations only contribute to the footprint once, regard-
less of the number of times that they are mapped into any number of pro-
cesses. The "footprint" value represents allocations that will cause the
system to page in accommodation.
footprint needs to be run as root. It can target multiple processes via
multiple instances of the -proc and -pid flags.
OPTIONS
-categories Detailed output on a per-VM-region type level (medium
detail).
-regions Display all memory objects and associated regions
that contribute to each category (high detail).
-swapped Display swapped bytes information where applicable.
-graphics Gather graphics data if available (platform depen-
dent, not tallied into footprint total).
-collapseSharing Do not group shared memory output by process.
-targetChildren Gather footprint information for the set of processes
launched directly or indirectly by the target pro-
cesses.
-skipIdleExitClean Do not gather information on any processes that are
ready to be quit on memory pressure. Also applicable
after the fact with -i option.
OS X June 28, 2012 OS X
Mac OS X 10.9 - Generated Mon Oct 14 19:32:28 CDT 2013