diskusg(1M)                                                        diskusg(1M)


NAME
     diskusg - generate disk accounting data by user ID

SYNOPSIS
     /usr/lib/acct/diskusg [options] [files]

DESCRIPTION
     diskusg generates intermediate disk accounting information from data in
     files or the standard input if omitted.  diskusg outputs lines on the
     standard output (one per user) in the following format:

          uid login #blocks

     where

     uid       is the numeric user ID of the user
     login     is the login name of the user
     #blocks   is the total number of disk blocks allocated to this user

     diskusg is normally used to read the inodes of efs or xfs filesystems for
     disk accounting.  In this case, files are the special filenames of these
     devices.

     diskusg recognizes these options:

     -s           Combine all lines for a single user into a single line.
                  (The input data is already in diskusg output format.)

     -v           Print (on standard error) a list of all files charged to no
                  one.

     -u file      Write (to file) records of files that are charged to no one.
                  Records consist of the special filename, the inode number,
                  and the user ID.

     -i fnmlist   Ignore the data on those filesystems for which a name is
                  recorded in fnmlist.  (fnmlist is a list of filesystem names
                  separated by commas or enclosed within quotes.)  diskusg
                  compares each name in this list with the filesystem name
                  stored in the volume ID.  (See labelit(1M).)  This option is
                  inoperative for xfs filesystems, because there's no way to
                  set the filesystem name.

     The environment variable ACCT_MAXUSERS is checked in order to allocate
     enough memory to handle the maximum number of distinct users that might
     need to be reported.  The environment variable ACCT_MAXIGN is checked in
     order to allocate enough memory to keep track of the maximum number of
     filesystem names that will be ignored in the report.


FILES
     /etc/passwd   used for conversions of user IDs to login names

USAGE
     The output of the diskusg command is normally the input to acctdisk (see
     acct(1M)), which generates total accounting records that can be merged
     with other accounting records.  diskusg is normally run in dodisk.  (See
     dodisk(1M).)

     acctdusg (see acct(1M)) can be used on all filesystem types but is slower
     than diskusg.

EXAMPLES
     Generate daily disk accounting information for the root filesystem on
     /dev/dsk/dks0d1s0 (where root is an efs or xfs filesystem):

          diskusg /dev/dsk/dks0d1s0 | acctdisk > disktacct


REFERENCES
     acct(1M), dodisk(1M), acct(4).


                                                                        Page 2