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 systemwide.  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  an  uncompressed kernel image.  This lets smem include the size of the kernel's code and
              statically allocated data in the systemwide (-w) output.  (To obtain an uncompressed  image  of  a
              kernel  on disk, you may need to build the kernel yourself, then locate file vmlinux in the source
              tree.)

       -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.  Example: --realmem=1024M

       -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 included, 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
       -a, --autosize
              Size columns to fit terminal size.

       -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.

REQUIREMENTS

       smem requires:

       •  Linux kernel providing 'Pss' metric in /proc/<pid>/smaps (generally 2.6.27 or newer).

       •  Python 2.x (at least 2.4 or so).

       •  The matplotlib library (only if you want to generate graphical charts).

EMBEDDED USAGE

       To  capture memory statistics on resource-constrained systems, the the smemcap package includes a utility
       named smemcap.  smemcap captures all /proc entries required by smem and outputs them as  an  uncompressed
       .tar  file  to STDOUT.  smem can analyze the output using the --source option.  smemcap is small and does
       not require Python.

       To use smemcap:

       1.     Install package smemcap on target system.

       2.     Run smemcap on the target system and save the output:
              smemcap > memorycapture.tar

       3.     Copy the output to another machine and run smem on it:
              smem -S memorycapture.tar

FILES

       /proc/$pid/cmdline

       /proc/$pid/smaps

       /proc/$pid/stat

       /proc/meminfo

       /proc/version

RESOURCES

       Main Web Site: http://www.selenic.com/smem

       Source code repository: http://selenic.com/repo/smem

       Mailing list: http://selenic.com/mailman/listinfo/smem

SEE ALSO

       free(1), pmap(1), proc(5), ps(1), top(1), vmstat(8)

COPYING

       Copyright (C) 2008-2009 Matt Mackall.  Free use of this software is granted under the terms  of  the  GNU
       General Public License version 2 or later.

AUTHOR

       smem was written by Matt Mackall.

                                                   03/15/2010                                            SMEM(8)