dlook - a tool for showing process memory maps & cpu usage
SYNOPSIS
dlook [-a] [-c] [-h] [-l] [-o outfile] [-s secs] command [command-args]
dlook [-a] [-c] [-h] [-l] [-o outfile] [-s secs] pid
DESCRIPTION
This command displays the memory map & cpu usage for a
specified process.
The following information is printed for each page in the
virtual address space of the process,
· the object that owns the page (file, SYSV shared
memory, device driver, etc).
· type of page (RAM, FETCHOP, IOSPACE, etc)
· if RAM memory,
· memory attributes (SHARED, DIRTY, etc)
· node that the page is located on
· (optional) physical address of page
Optionally, the amount of elapsed cpu time that the pro
cess has executed on each physical cpu in the system is
also printed.
Two forms of the command are provided. In the first form,
dlook prints information about an existing process that is
identified by a pid You must be the owner of the process
or be running with root privilige to use this form of the
command.
In the second form, a command and optional command argu
ments are specified. Dlook exec's the command and passes
the command arguments. On process termination, dlook
prints information about the process. Specifying the -s
option causes the information to be sampled at regular
internals.
OPTIONS
-a Show physical addresses of each page in the address
space.
-c Show elapsed cpu time process has executed on each
-h Explicitly list holes in the address space.
-l Show libraries.
-o Output file name. If not specified, output is writ
ten to stdout.
-s Specifies a sample interval in seconds. Information
about the process is displayed every secs of cpu
usage by the process.
EXAMPLES
Print the map & cpu usage for the process with pid 1456:
dlook -c 1456
Execute the date command & print the memory map at process
termination:
dlook date
Run a MPI job using mpirun & print the memory map for each
thread:
mpirun -np 8 dlook ft.8
BUGS
The -s secs option works only on child processes. The
itimer information that is required to make this option
work is not inherited by child processes forked by com
mand.
If multiple processes terminate at the same time, dlook
output from the processes may be interspersed if it is
written directly to the terminal. Use the -o option to
send the output to a file. File locking will provide
proper serialization.
ERRORS
Dlook depends on a loadable kernel module named "numa
tools". If this modules is not loaded, dlook will fail &
print a message to remind the user to load the numatools
module.
cpumemsets(1), dplace(1), runon(1)
Man(1) output converted with
man2html