diskusg

PURPOSE

     Generates disk accounting data by user ID.

SYNOPSIS
     diskusg [ -si[fnmlist] ] [ -p file ] [ -uv [file] ] [file]

DESCRIPTION

     The   diskusg   command   generates   intermediate   disk
     accounting  information  from  data   in  files  or  from
     standard input if you do  not specify any files.  diskusg
     writes lines  to 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 allo-
                   cated to this user.

     The diskusg  command normally  reads only the  i-nodes of
     file systems  for disk  accounting.  In this  case, files
     are the special file names of these devices.

     Note:  This command is for local devices only.

FLAGS

     -i  fnmlist   Ignores the data on those file systems with
                   a file system name  in fnmlist.  fnmlist is
                   a list  of file  system names  separated by
                   commas or enclosed  within quotation marks.
                   diskusg  compares each  name  in this  list
                   with  the file  system name  stored in  the
                   volume ID.
     -p  file      Uses file as the  name of the password file
                   to  generate login  names.  /etc/passwd  is
                   used by default.
     -s            Combines all lines for a single user into a
                   single line.  (The input date is already in
                   diskusg output format.)
     -u  file      Writes records  to file  of files  that are
                   charged to no one.   Records consist of the
                   special file  name, the i-node  number, and
                   the user ID.
     -v            Writes  a list  to  standard  error of  all
                   files that are charged to no one.

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

EXAMPLES

     The following will generate  daily disk accounting infor-
     mation:

       for  i  in  /dev/hd0  /dev/hd1  /dev/hd2  /dev/hd3
       do
             diskusg  $i  > dtmp.'basename $i'  &
       done
       wait
       diskusg  -s  dtmp.*  | sort  +On  +1  |  acctdisk  > dacct

FILES

     /etc/passwd    Used  for user  ID to  login name  conver-
                    sions.

RELATED INFORMATION

     The following commands:   "acct,"  "acctcms," "acctcom,"
     "acctcon,"    "acctmerg,"   "acctprc,"    "fwtmp,"   and
     "runacct."

     The acct system  call and the acct and utmp  files in AIX
     Operating System Technical Reference.

     The discussion  of accounting  in Managing the  AIX Oper-
     ating System.