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