footprint(1) [mojave man page]

FOOTPRINT(1)						    BSD General Commands Manual 					      FOOTPRINT(1)

NAME

     footprint -- gathers memory information about one or more processes

SYNOPSIS

     footprint [-j path] [-f bytes|formatted|pages] [-p name|pid] [-x name|pid] [-t] [-s] [-v] [-y] [-w] [--swapped] [--wired] [-a] process-name |
	       pid | memgraph [...]
     footprint -h, --help

DESCRIPTION

     The footprint utility gathers and displays memory consumption information for the specified processes or memory graph files.

     footprint will display all addressable memory used by the specified processes, but it emphasizes memory considered 'dirty' by the kernel for
     purposes of accounting.  If multiple processes are specified, footprint will de-duplicate multiply mapped objects and will display shared
     objects separately from private ones.

     footprint must be run as root when inspecting processes that are not owned by the current user.

OPTIONS

     -a, --all
	     target all processes (will take much longer)

     -j, --json path
	     also save a JSON representation of the data to the specified path

     -f, --format bytes|formatted|pages
	     textual output should be formatted in bytes, pages, or human-readable formatted (default)

     -p, --proc name
	     target the given process by name (can be used multiple times)

     -p, --pid pid
	     target the given process by pid (can be used multiple times)

     -x, --exclude name/pid
	     exclude the given process by name or pid (can be used multiple times)

	     often used with --all to exclude some processes from analysis

     -t, --targetChildren
	     in addition to the supplied processes, target their children, grandchildren, etc.

     -s, --skip
	     skip processes that are dirty tracked and have no outstanding XPC transactions (i.e., are "clean")

     -v      display vmmap-like output of address space layout

     -y, --summary
	     print only regions with dirty memory, and condense __TEXT, __DATA, and __LINKEDIT regions into 'Other' subtotal

     -w, --wide
	     show wide output with all columns (implies --swapped --wired)

     --swapped
	     show swapped/compressed column, a subset of 'dirty'

     --wired
	     show wired memory column, a subset of 'dirty'

     -h, --help
	     display help and exit

SAMPLE USAGE

     footprint Mail WindowServer

OS X
								 January 29, 2018							      OS X

Check Out this Related Man Page

footprint(1)						    BSD General Commands Manual 					      footprint(1)

NAME

     footprint -- gathers memory information about a process or set of processes.

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, regardless of the number of times that they are mapped into any number of
     processes. 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 dependent, 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 processes.

     -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

Linux and UNIX Man Pages

footprint(1) [mojave man page]

Check Out this Related Man Page