EXMAP(1)

NAME
exmap - manual page for exmap 0.3.2

SYNOPSIS
exmap [options] [pid|name ...]

DESCRIPTION
This is the command-line front-end to Exmap.

Exmap is a powerful tool for analysing memory usage; it provides information not only on how much memory process(es) use, but details of how it is used, including how much of it is shared with other process and how individual modules of the process contribute to its use. The exmap-console package provides a command-line-only alternative interface to the GUI gExmap application.

OPTIONS

--no-file-info
    : Only summary for each process (implies --no-elf-info).

--no-elf-info
    : No breakdown per elf sections in each file.

--all-pids
    : Information for all accessible pids; if not used, at least one process must be specified.

--vm-threshold=bytes
    : Information only for processes above VM threshold

--sort-by=what
    : vm|sole|heap|stack|mapped|none (default: none)

--sort-type=which
    : desc|asc (default: desc)

--format=which
    : human|csv|csv+sums (default: human)

--log=file
    : Print results to file, not stdout

--interactive
    : Run in interactive mode

--version
    : Program version

--module-version
    : Version of required kernel module

--help

If --all-pids is not given, at least one process has to be specified, either by a pid or command name. Command names must not include path. Specifying a process by name is equivalent to giving pids for all running processes of that name.

If neither --no-file-info nor --no-elf-info is given then for any processes specified explicitely symbol information is printed where available.

EXAMPLES
exmap pid
   : Prints memory usage for single process in human-friendly
     format. exmap --all-pids --sort-by=sole --format=csv
   : Prints memory usage for all accessible pids, CSV formated for
     use with suitable viewer (e.g., spreadsheet program). exmap --all-pids --vm-threshold=1000000
   : Prints memory usage for all accessible pids that use more than
     1000000 bytes of virtual memory. exmap bash
   : Prints memory usage for all bash processes running.

INTERACTIVE MODE
In interactive mode, the application creates a system snapshot, which then can be examined from a command prompt. To start the application in interactive mode, use the --interactive command line option. For details of available interactive operations, type 'help' on the command prompt.

DOWNLOAD
Exmap console client can be found at:
    http://projects.o-hand.com/#misc Svn repository is at:
    svn co http://svn.o-hand.com/repos/misc/trunk/exmap-console The original exmap package by John Berthels on which this program is based can be found at http://www.berthels.co.uk/exmap.

AUTHOR
Exmap console client: Tomas Frydrych <tf@o-hand.com> Exmap kernel module: John Berthels <jjberthels@gmail.com>

COPYRIGHT
Exmap console client (c) 2006 OpenedHand Ltd. Exmap kernel module (c) 2005 John Berthels The package is distributed under the terms of the GNU General Public Licence.