diskusg(1M)                                              diskusg(1M)


       NAME
             diskusg, bfsdiskusg, sfsdiskusg, ufsdiskusg, vxdiskusg -
             generate disk accounting data by user ID

       SYNOPSIS
             /usr/lib/acct/diskusg [options] [files]
             /usr/lib/acct/bfsdiskusg [options] [files]
             /usr/lib/acct/sfsdiskusg [options] [files]
             /usr/lib/acct/ufsdiskusg [options] [files]
             /usr/lib/acct/vxdiskusg [options] [files]

       DESCRIPTION
             diskusg, bfsdiskusg, sfsdiskusg, ufsdiskusg, and vxdiskusg
             generate intermediate disk accounting information from data in
             files, or the standard input if omitted.  diskusg, bfsdiskusg,
             sfsdiskusg, ufsdiskusg and vxdiskusg output lines on the
             standard output (one per user) in the following format:

                   uid login #blocks

             where

             uid       is the numerical user ID of the user,
             login     is the login name of the user, and
             #blocks   is the total number of disk blocks allocated to this
                       user (always reported in 512 byte blocks).

             diskusg is normally used to read the inodes of s5 file systems
             for disk accounting.  In this case, files are the special
             filenames of these devices.  bfsdiskusg, sfsdiskusg,
             ufsdiskusg, and vxdiskusg are used to read the inodes of bfs,
             sfs, ufs, and vxfs file systems, respectively, for disk
             accounting.

          Options
             diskusg, bfsdiskusg, sfsdiskusg, ufsdiskusg, and vxdiskusg
             recognize the following 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.





                           Copyright 1994 Novell, Inc.               Page 1

      diskusg(1M)                                              diskusg(1M)


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

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

            The diskusg, sfsdiskusg, ufsdiskusg, and vxdiskusg commands
            recognize the following option:

            -i fnmlist
                  Ignore the data on those file systems for which a name
                  is recorded in fnmlist.  (fnmlist is a list of file
                  system names separated by commas or enclosed within
                  quotes.)  diskusg compares each name in this list with
                  the file system name stored in the volume ID.  [See
                  labelit(1M).]

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

      USAGE
            The output of the diskusg, bfsdiskusg, sfsdiskusg, ufsdiskusg,
            and vxdiskusg commands is normally the input to acctdisk [see
            acct(1M)], which generates total accounting records that can
            be merged with other accounting records.  diskusg, bfsdiskusg,
            sfsdiskusg, ufsdiskusg, and vxdiskusg are normally run in
            dodisk.  [See acctsh(1M).]

            acctdusg [see acct(1M)] can be used on all file system types
            but is slower than diskusg.

         Examples
            Generate daily disk accounting information for the root file
            system on /dev/dsk/c1b0d0s0 (where root is an s5 file system):

                  diskusg /dev/dsk/c1b0d0s0 | acctdisk > disktacct

      REFERENCES
            acct(1M), acct(4), acctsh(1M)






                          Copyright 1994 Novell, Inc.               Page 2