*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> diskusg (8)              



NAME    [Toc]    [Back]

       diskusg - Generates disk accounting data by user ID

SYNOPSIS    [Toc]    [Back]

       /usr/sbin/acct/diskusg  [-U number] [-s] [-v] [-p pw_filename]
 [-u u_filename] [-i ignlist] [file_spec...]

OPTIONS    [Toc]    [Back]

       Sets the number of internal allocated user  structures  to
       the  specified  number, one for each user.  The default is
       1000.  Ignores the data in the specified ignlist file system.
  The  ignlist operand specifies a list of file system
       names, separated with  commas  or  enclosed  by  quotation
       marks.   Uses  the specified pw_filename file as the password
 file used to generate login names.  The default password
 file is /etc/passwd.  Combines all records for a single
 user into a single record.  Input data must be in  the
       same  format  as the output of the diskusg command. If you
       specify the file_spec operand  with  the  -s  option,  the
       operand  must  be  an  ASCII  file  containing data in the
       appropriate format.  If the file_spec operand is not specified,
  input  data  will  be  taken  from standard input.
       Writes a record to  u_filename  for  each  file  that  has
       changed  its user ID to user no one.  Each record consists
       of the special file name, the inode number, and  the  user
       ID.   Writes a list of all files charged to user no one to
       standard error.

OPERANDS    [Toc]    [Back]

       Specifies one or more file systems. How you specify a file
       system  depends  on whether it is UFS or AdvFS and whether
       it is mounted.

              To specify a UFS file system that is mounted, enter
              the  name of its character device special file, for
              example: /dev/rrz3c.

              To specify a UFS file system that is  not  mounted,
              enter  the  name  of its block device special file,
              for example: /dev/rz3c.

              To specify an AdvFS fileset that is mounted,  enter
              the  name of the file domain, a pound-sign(#) character,
 and the name of the  fileset,  for  example:

              You cannot specify an AdvFS file system that is not

DESCRIPTION    [Toc]    [Back]

       The diskusg command generates intermediate disk accounting
       information about files in the specified file_spec or from
       standard input.

       The diskusg command obtains  user  login  names  from  the
       /etc/passwd  file,  by default, and reports one record per
       user to standard output.  The command usually  reads  only
       the inodes of the specified file system.

       The  diskusg  command  is  usually  called from the dodisk
       shell procedure when the cron daemon executes commands  in
       the  /usr/spool/cron/crontabs/root  file.    You  can also
       manually  invoke the command.

       If the diskusg command is executed from  the  dodisk  command,
  its  output  is directed to the /var/adm/dtmp file,
       which is used as input to the acctdisk command to  produce
       a  total  accounting  record. This total accounting record
       can be merged with other total accounting records to  produce
 a daily report.  Note that if the -o option is specified
 with the dodisk command, the acctdusg command is used
       instead  of  the  diskusg  command.   The acctdusg command
       provides a more thorough accounting of disk usage than the
       diskusg command.

       Records output by the diskusg command are in the following
       format: user_ID     login_name    disk_blocks

       The output contains the  following  information:  Assigned
       user  number  User  login name Total number of disk blocks
       allocated to the user

NOTES    [Toc]    [Back]

       This command can be used only for local devices.

       The command's behavior when it  encounters  a  nonexisting
       UFS  file  system  is  different from its behavior when it
       encounters a nonexisting AdvFS fileset.  If the  nonexisting
  file_spec  is a UFS file system, the command produces
       an error and continue to display  output  for  other  file
       systems and filesets. If the missing file_spec is an AdvFS
       fileset, the command exits without producing any output.

EXAMPLES    [Toc]    [Back]

       To manually invoke the diskusg command, you must be logged
       in as superuser.  For example, you could enter the following

              # /usr/sbin/acct/diskusg /dev/rrz3a

                 0   root        63652
                 1   daemon         84
                 2   bin         71144
                 4   adm           976
                 5   uucp         3324
               322   homer           2
               521   whistler        2
               943   cellini       363 1016    pollock         92
              1098    hopper         317  To  generate daily disk
              accounting information, add a line similar  to  the
              following   to   the  /usr/spool/cron/crontabs/root
              file: 0 2 * * 4 /usr/sbin/acct/dodisk The  previous
              example  shows a typical, periodically invoked command
 that the cron daemon reads and executes.   The
              time  period  is expressed by a 6-field entry using
              the format:

              mm  hh  dayofmonth  month  wkday  command

              The previous format shows  the  following  information:
  The  number of minutes past the hour, from 0
              to 59 The hour of the day in 24-hour clock notation
              The  day  of  the month The month, from 1 to 12 The
              day or days of the week, from 0 to 6,  where  0  is
              Sunday  and  inclusive  days are separated with a -
              (hyphen) The command that the cron daemon must execute.

              Unspecified  times  must  use  an  *  (asterisk) to
              define an empty field.  In  the  previous  example,
              the  dodisk shell procedure runs at 02:00 hours (2)
              every Thursday (4).  Usually, the dodisk shell procedure
  calls  the  diskusg command to redirect its
              output to a temporary file and then calls  acctdisk
              to  redirect  disk usage records from the temporary
              file as input to the  /var/adm/acct/nite/[filename]
              file   as   output.   The   file    stored  in  the
              /var/adm/acct/nite  subdirectory  is  a   permanent
              binary  record  of  disk  usage  for  the specified

FILES    [Toc]    [Back]

       Specifies the command path.  Accounting header files  that
       define   formats   for  writing  accounting  files.   User
       database file.

SEE ALSO    [Toc]    [Back]

       Commands: acct(8), acctdisk(8), acctdusg(8),  acctmerg(8),
       dodisk(8), runacct(8)

       Functions: acct(2)

       System Administration

[ Back ]
 Similar pages
Name OS Title
diskusg HP-UX generate disk accounting data by user ID
diskusg IRIX generate disk accounting data by user ID
vxdiskusg HP-UX generate VxFS disk accounting data by user ID
ttyslot Tru64 Find the slot for the current user in the user accounting database
acctdisk Tru64 Perform disk-usage accounting
acctdusg Tru64 Perform disk-usage accounting
acctsuspend HP-UX suspend and resume accounting when available disk space reaches threshold
acctresume HP-UX suspend and resume accounting when available disk space reaches threshold
pthread_key_create Tru64 Generates a unique thread-specific data key
tis_key_create Tru64 Generates a unique thread-specific data key
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service