mondisk(8)                          CLIX                          mondisk(8)



  NAME

    mondisk - Runs CRM utility for monitoring disk resources

  SYNOPSIS

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

  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.)

    -I interval     Specifies how frequently the monitor samples and displays
                    information.  The interval is the number of 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 every interval seconds.
                    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 mondisk command provides information about disk resources.  The
    display shows activity on each disk controller with the following fields:

    ops       Number of I/O operations which occurred during the interval.

    busy      Percentage of the amount of time the controller spent processing
              requests versus the total time of the interval.

    bcnt      Count of 512-byte blocks transferred during the interval.

    avque     Average request queue depth during the interval.

    currque   Current request queue depth at the end of the interval.




  2/94 - Intergraph Corporation                                              1

  mondisk(8)                          CLIX                          mondisk(8)



    The file systems which are mounted on the disk controllers (if any) are
    shown next to their particular controller information.  Associated with
    each mounted file system is the number of free blocks on that file system,
    and what percentage of the file system's total blocks are free.  Also
    listed are the number of free inodes in the file system, and what
    percentage of the file system's total inodes are free.

    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

    In this example, the following command is entered to start the mondisk
    utility.

    /usr/ip32/crm/mondisk

    This is sample output from a mondisk session.

      Sample rate: 2                Tue Sep 25 17:35:14 1990
     device    ops  busy  bcnt  avque currque  freeblocks        freeinodes
    iop0scsi0   17  24.2%  272   1.0     1
      s0u0p7.0 "/" (S51K)                       29127 (38.8%)    4339 (70.6%)
      s0u0p7.1 swap partition                  383256 (100.0%)
    iop0scsi1    7   4.2%   74   1.0     5
      s1u0p7.0 "/usr" (FFS)                    116865 (10.2%)   48351 (74.5%)
      s1u1p7.0 "/usr2/wsdel" (FFS)             301747 (26.4%)   59906 (92.3%)
    iop0scsi3   49  60.8%  378   1.1     0
      s3u0p7.0 "/usr/src" (FFS)                214755 (22.8%)   31865 (50.2%)
      s3u0p7.1 "/usr/spool" (FFS)              133875 (66.9%)   11098 (77.4%)
      s3u1p7.0 "/usr2" (FFS)                    47525 (4.2%)    39675 (61.1%)
    iop0scsi4    0   0.0%    0   0.0     0
    iop1scsi2    3   1.7%   48   1.0     2
      i1s2u0p7.0 "/usr/spool/news" (FFS)       112251 (22.5%)    6838 (10.5%)
      i1s2u1p7.0 "/usr/public" (FFS)           231951 (20.3%)   43928 (67.7%)
      i1s2u0p7.1 "/usr2/dorf" (FFS)              8013 (2.3%)    15193 (61.8%)
    iop1scsi3    0   0.0%    0   0.0     0
      i1s3u1p7.0 "/usr/public/uunet" (FFS)     285993 (25.0%)   51263 (79.0%)
      i1s3u0p7.0 "/usr2/db" (FFS)               89685 (7.9%)    46186 (71.2%)
    ingr:/usr/public "/ingr" (NFS), soft        92047 (8.1%)        0 (0.0%)


  FILES

    Mondisk requires read access to the following files:

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

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




  2                                              Intergraph Corporation - 2/94

  mondisk(8)                          CLIX                          mondisk(8)



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

    /etc/mnttab   Contains information about the mounted file systems.

    /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 may result
    in unexplained ``disk full'' messages.

  EXIT VALUES

    The exit values are not valid.

  RELATED INFORMATION

    crm(1)




























  2/94 - Intergraph Corporation                                              3