topfault(8)                         CLIX                         topfault(8)



  NAME

    topfault - Runs CRM utility for monitoring page faults

  SYNOPSIS

    /usr/ip32/crm/topfault [-U boot_image] [-I interval] [-S snap_file] [-i
    input_file] [-o output_file]

  FLAGS

    -U boot_image   Specifies the file specification of the CLIX image which
                    was booted.  This flag is only required 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.)

    -I interval     Specifies how frequently the monitor samples and displays
                    information.  The interval is specified in seconds.  The
                    default interval is 2 seconds.

    -S snap_file    Specifies a name for the snapshot file.  (The default
                    filename is /tmp/CRM.snapshot.)

    -i input_file   Reads the data from input_file each interval.  The
                    input_file must have been created as an output_file using
                    the -o flag.  A hyphen (-) for input_file reads input from
                    stdin.

    -o output_file  Directs output to output_file.  A hyphen (-) for
                    output_file directs output to stdout.

  DESCRIPTION

    The topfault command monitors the page faults being encountered by each
    process running on the system.

    A brief explanation of the topfault fields follows.  A similar list can be
    accessed online by entering a ? while the monitor is running.

    Sample time    Displays how frequently (in seconds) the monitor gathers
                   and displays information.  The default setting is two
                   seconds.  This time interval can be changed by pressing the
                   up arrow key (to increment) and the down arrow key (to
                   decrement).

    Max displayed  Displays the maximum number of faulting processes.  This
                   value can be changed by pressing the right arrow key (to



  2/94 - Intergraph Corporation                                              1

  topfault(8)                         CLIX                         topfault(8)



                   increment) and the left arrow key (to decrement).

    vfault         Displays virtual faults.  The vfault value is the sum of
                   the four following values defined by CLIX.  Remember that,
                   out of the four following types of faults, only swap and
                   file faults go to the disk; demand and cache faults are
                   satisfied in memory.

                   demand   Demand zero and demand fill pages.

                   swap     Fault satisfied from swap area.

                   cache    Fault satisfied in the cache.

                   file     Fault satisfied from a file.

    pfault         Displays protection faults.  The pfault value is the sum of
                   the following values:

                   cop_wrt   (Copy-on-write.)  If two processes are sharing a
                             copy-on-write page in memory, the page must be
                             copied when the process that does not have write
                             access needs to write to the page.

                   steal     If a page is marked copy-on-write but only one
                             process is accessing it, the page does not need
                             to be copied.  Instead, the protections are
                             changed on the page so that one process can write
                             to it.

    freedpgs       Displays the number of pages that were freed on the system
                   during the last sample interval.

    unmodsw        Displays the number of unmodified pages in swap during the
                   sample time period.

    unmodfl        Displays the number of unmodified pages in all files during
                   the sample time period.

    swapin         Displays the number of pages swapped into memory during the
                   sample time period.

    swapout        Displays the number of pages swapped out of memory during
                   the sample time period.

    To take a snapshot of the statistics, type S (press <Shift> <S> ).  The
    statistics shown at that instant are saved to the file /tmp/CRM.snapshot,
    or to the file specified with the -S flag.

  EXAMPLES




  2                                              Intergraph Corporation - 2/94

  topfault(8)                         CLIX                         topfault(8)



    The following example samples every five seconds for faults.

    /usr/ip32/crm/topfault -I 5


  FILES

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

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

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

    /tmp/CRM.snapshot
                The default filename of a snapshot.

  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.

  CAUTIONS

    Sending raw data to a file can create a very large file, which can result
    in unexpected ``disk full'' messages.

  DIAGNOSTICS

    The diagnostic messages are designed to be self-explanatory.

  EXIT VALUES

    The exit values are not valid.

  RELATED INFORMATION

    Commands:  crm(1)















  2/94 - Intergraph Corporation                                              3