showmemory(8)                       CLIX                       showmemory(8)



  NAME

    showmemory - Runs CRM utility for monitoring process memory regions

  SYNOPSIS

    /usr/ip32/crm/showmemory [-U boot_image] [input_flag] [-s]

  FLAGS

    -U boot_image   Lists the file specification of the CLIX image which was
                    booted.  This flag is required only if the boot image has
                    been moved since the system was booted.  (The default boot
                    image used is set on the Operating System Parameters menu
                    of the workstation Utility Pages; usually, the image is
                    the /unix file.  However, if the user moves the boot image
                    to a different directory, the -U flag must be used to tell
                    the CRM utilities where to find the boot image.)

    -s              Displays only the summary of all the processes on the
                    system.

    The following input_flags may be used:

    -p pid Specifies the process ID number (PID) to monitor.  The user may
           enter ps -e at the system prompt to determine the PID of a process
           already running.

    -n process_name
           Specifies the name of the process to monitor.  The user may enter
           ps -e at the system prompt to determine the name of a process
           already running.

    -e command arg ...
           Runs, provides arguments for, and monitors a program.

  DESCRIPTION

    The showmemory command displays a list of all processes on the system.  It
    also lists attached memory regions associated with each process.

    A brief explanation of the showmemory information given for each displayed
    region follows:

    REGION TYPE
           Displays the region type, which can be one of the following types:

           TEXT     Main executable code.

           DATA     Main data region.




  2/94 - Intergraph Corporation                                              1

  showmemory(8)                       CLIX                       showmemory(8)



           STACK    Process stack.

           SHMEM    Shared memory.

           DMM      Double mapped memory.

           LIBTXT   Shared library code.

           LIBDAT   Shared library data.

           MMF      Memory mapped file.

    REGION NUMBER
           Displays the CLIX internal identification number of the region.  If
           a region number displays in more than one process, the region is
           shared among those processes.

    VIRTUAL SIZE
           Displays the amount of virtual memory allocated to the region.  The
           virtual size of the regions is also allocated from the available
           swap space.

    PHYSICAL SIZE
           Displays the amount of real memory currently being used by the
           region.

    SHARED Displays the number of processes currently attached to the region.
           If no number appears in the shared column, the region is being used
           only by the one process.

    PERCENT MEMORY
           Displays the percentage of physical memory allocated to the region.
           This number is weighted by the number of processes sharing the
           region.

    CUMULATIVE
           Displays the cumulative percentage of physical memory used by the
           regions.

    After the list of processes has been displayed, a system summary is
    displayed.  The summary gives the following information:

    Total Physical Memory On System
           Displays (in megabytes) the amount of real memory the system has.

    Used By Processes
           Displays the final cumulative total of physical memory being used
           by the process regions.

    Process Overhead
           Displays the amount of memory used by the system to keep page



  2                                              Intergraph Corporation - 2/94

  showmemory(8)                       CLIX                       showmemory(8)



           tables and user blocks.

    n Unattached Regions
           Displays the amount of physical memory being used by regions
           without attached processes.  Unattached regions can occur when a
           program has the sticky bit set in its mode (see chmod(1)).

    Available Memory
           Displays the amount of physical memory that is available for
           processes to use.

    Initial Clix Size
           Displays the amount of physical memory used by the CLIX operating
           system when the system boots.

    Allocated By Clix
           Displays the amount of physical memory allocated when the CLIX
           operating system is running.  For example, when a driver is loaded,
           its text and data section occupies a section of physical memory.

  EXAMPLES

    The following example lists the process called libcd and shows its
    attached memory regions.

    /usr/ip32/crm/showmemory -n libcd


  FILES

    /dev/kmem     Allows showmemory access to kernel virtual memory space.

    /dev/mem      Allows showmemory access to kernel physical memory space.

    /proc/?????   The proc file system entry for all of the processes, where
                  ????? are the five-digit process IDs.

    /unix         The default CLIX image.  The showmemory command looks up
                  offsets into the kernel using symbols from boot_image.

  NOTES

    Read permission is required to access some files used by this command.  If
    the user is denied permission to access the required files, the superuser
    privileges are required to run this command.

  EXIT VALUES

    The exit values are not valid.

  RELATED INFORMATION



  2/94 - Intergraph Corporation                                              3

  showmemory(8)                       CLIX                       showmemory(8)



    Commands:  crm(1), chmod(1)





















































  4                                              Intergraph Corporation - 2/94