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