NAME

       smemstat - report memory usage with shared memory divided proportionally

SYNOPSIS

       smemstat [options] [delay [count]]

DESCRIPTION

       smemstat reports the physical memory usage taking into consideration shared memory.

       Swap  reports  memory  that is swapped out to disk. Unshared memory is reported as USS (Unique Set Size).
       Unshared memory including the proportion of shared memory is reported as the PSS (Proportional Set Size).
       The non-swapped physical memory is reported as the RSS (Resident Set Size).

       Running with root privilege will report all user space processes, otherwise  running  without  will  just
       report the current user's processes.

       If  a delay and count are not specified, a snapshot of the current memory used by the user's processes is
       report.

       If a delay in seconds is specified, smemstat will periodically show any per-process  changes  in  memory;
       the  interval  being  the  specified  delay.   This  will  run  indefinitely  until  a  SIGINT is caught.
       Specifying count will repeat the periodic output count number of times.

OPTIONS

       smemstat options are as follow:

       -a     show memory size change with up arrow ↑ (increase) and down arrow ↓ (decrease)

       -c     get command information from processes comm field

       -d     strip directory basename off command information

       -g     report memory in gigabytes

       -h     show help

       -k     report memory in kilobytes

       -l     show long (full) command information

       -m     report memory in megabytes

       -o file
              output data into a JSON formatted file

       -p proclist
              specify a comma separated list of processes to monitor. The process list may contain one  or  more
              PIDs or process names.

       -q     run quietly, only really makes sense with -o option

       -s     show short command information

       -t     top mode, show top changes of memory

       -T     top mode, show top consumers of memory

       When  running in 'top mode', pressing 'q' will quit, 'a' toggles the memory change arrow, 't' toggles the
       top consumers of memory view.

SEE ALSO

       cpustat(8), eventstat(8), forkstat(8), top(1), vmstat(8)

AUTHOR

       smemstat was written by Colin Ian King <colin.i.king@gmail.com>

       This manual page was written by Colin Ian King <colin.i.king@gmail.com>, for the Ubuntu project (but  may
       be used by others).

COPYRIGHT

       Copyright © 2014-2021 Canonical Ltd, Copyright © 2021-2024 Colin Ian King.
       This  is  free  software;  see  the  source  for  copying conditions.  There is NO warranty; not even for
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

                                                January 11, 2024                                     SMEMSTAT(8)