smem(8)

NAME

smem - Report memory usage with shared memory divided proportionally.

SYNOPSIS

smem [options]

DESCRIPTION

smem reports physical memory usage, taking shared memory pages into account. Unshared memory is reported as the USS (Unique Set Size). Shared memory is divided evenly among the processes sharing that memory. The unshared memory (USS) plus a process's proportion of shared memory is reported as the PSS (Proportional Set Size). The USS and PSS only include physical memory usage. They do not include memory that has been swapped out to disk.

Memory can be reported by process, by user, by mapping, or system-wide. Both text mode and graphical output are available.

OPTIONS

GENERAL OPTIONS

-h, --help

Show help.

SOURCE DATA

By default, smem will pull most of the data it needs from the /proc filesystem of the system it is running on. The --source option lets you used a tarred set of /proc data saved earlier, possibly on a different machine. The --kernel and --realmem options let you specify a couple things that smem cannot discover on its own.

-K KERNEL, --kernel=KERNEL

Path to kernel image. This lets smem include the size of the kernel's code and statically allocated data in the systemwide (-w) output.

-R REALMEM, --realmem=REALMEM

Amount of physical RAM. This lets smem detect the amount of memory used by firmware/hardware in the systemwide (-w) output. If provided, it will also be used as the total memory size to base percentages on.

-S SOURCE, --source=SOURCE

/proc data source. This lets you specify an alternate source of the /proc data. For example, you can capture data from an embedded system using smemcap, and parse the data later on a different machine. If the --source option is not included, smem reports memory usage on the running system.

REPORT BY

If none of the following options are include, smem reports memory usage by process.

-m, --mappings

Report memory usage by mapping.

-u, --users

Report memory usage by user.

-w, --system

Report systemwide memory usage summary.

FILTER BY

If none of these options are included, memory usage is reported for all processes, users, or mappings. (Note: If you are running as a non-root user, and if you are not using the --source options, then you will only see data from processes whose /proc/ information you have access to.)

-M MAPFILTER, --mapfilter=MAPFILTER

Mapping filter regular expression.

-P PROCESSFILTER, --processfilter=PROCESSFILTER

Process filter regular expression.

-U USERFILTER, --userfilter=USERFILTER

User filter regular expression.

OUTPUT FORMATTING

-c COLUMNS, --columns=COLUMNS

Columns to show.

-H, --no-header

Disable header line.

-k, --abbreviate

Show unit suffixes.

-n, --numeric

Show numeric user IDs instead of usernames.

-p, --percent

Show percentages.

-r, --reverse

Reverse sort.

-s SORT, --sort=SORT

Field to sort on.

-t, --totals

Show totals.

OUTPUT TYPE

These options specify graphical output styles.

--bar=BAR

Show bar graph.

--pie=PIE

Show pie graph.

NOTES

smem requires a 2.6.27 or newer kernel.

FILES

/proc/$pid/cmdline

/proc/$pid/smaps

/proc/$pid/stat

/proc/meminfo

/proc/version

SEE ALSO

free(1),pmap(1)

AUTHOR

smem was written by Matt Mackall.

07/09/2009 SMEM(8)