diskusg(8)                          CLIX                          diskusg(8)



  NAME

    diskusg - Generates disk accounting data by user ID

  SYNOPSIS

    diskusg [-sv] [-i fnmlist] [-p filename] [-u filename]

  FLAGS

    -s            Indicates that the input data is already in diskusg output
                  format.  The diskusg command combines all lines for a single
                  user into a single line.

    -v            Displays a verbose list on stderr of all files that are not
                  charged to a user.

    -i fnmlist    Ignores the data on file systems that are named in the
                  specified fnmlist.  The fnmlist is a list of file system
                  names separated by commas or enclosed within quotation
                  marks.  The diskusg command compares each name in this list
                  with the file system name stored in the volume ID (see
                  labelit(8)).

    -p filename   Uses the specified filename as the name of the password file
                  to generate login names.  The /etc/passwd file is used by
                  default.

    -u filename   Writes records for files that are not charged to a user to
                  the specified filename.  Records consist of the special
                  filename, the inode number, and the user ID.

  DESCRIPTION

    The diskusg command generates intermediate disk accounting information
    from data in the specified files, or from stdin if no files are indicated.
    The command directs output to stdout with one line per user displaying the
    user ID, login name, and total number of disk blocks, respectively.  The
    format of each line is as follows:

    uid       The numerical user ID of the user.

    login     The login name of the user.

    #blocks   The total number of disk blocks allocated to this user.

    The diskusg command normally reads only the inodes of file systems for
    disk accounting.  In this case, files are the special filenames of these
    devices.

    The output of diskusg is normally the input to the acctdisk command (see



  2/94 - Intergraph Corporation                                              1

  diskusg(8)                          CLIX                          diskusg(8)



    acct(8)) that generates total accounting records which can be merged with
    other accounting records.  The diskusg command is normally run by the
    dodisk command (see acctsh(8)).

  EXAMPLES

    The following example generates daily disk accounting information for root
    on /dev/dsk/s0u0p7.0:

    diskusg /dev/dsk/s0u0p7.0 | acctdisk >disktacct


  FILES

    /etc/passwd   Used for user ID to login name conversions.

  DIAGNOSTICS

    The diskusg command displays an error message if it cannot open or read a
    file.

  EXIT VALUES

    The diskusg command exits with a value of 5 if it cannot open a file.  It
    exits with a value of 1 if the command encounters a read error.  It exits
    with a value of 10 if the command line is incorrect.

  RELATED INFORMATION

    Commands:  acct(8), acctsh(8), labelit(8)

    Files:  acct(4)






















  2                                              Intergraph Corporation - 2/94