footprint man page on Darwin

Man page or keyword search:  
man Server   23457 pages
apropos Keyword Search (all sections)
Output format
Darwin logo
[printable version]

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
[top]

List of man pages available for Darwin

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net