diskusg(8)						      System Manager's Manual							diskusg(8)

NAME

       diskusg - Generates disk accounting data by user ID

SYNOPSIS

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

       The diskusg command generates intermediate disk accounting information and writes one record per user to standard output.

PARAMETERS

       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 file-
	      set, for example:  root_domain#root.

	      You cannot specify an AdvFS file system that is not mounted.

FLAGS

       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 parameter 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 parameter with the -s flag, the parameter must be an  ASCII  file  containing  data  in  the
       appropriate format.  If the file_spec parameter is not specified, input data will be taken from standard input.	Writes a record to u_file-
       name 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.

DESCRIPTION

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

       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

       To manually invoke the diskusg command, you must be logged in as superuser.   For  example,  you  could	enter  the  following  command:  #
       /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 period.

FILES

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

RELATED INFORMATION

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

       Functions: acct(2)

       System Administration delim off

																	diskusg(8)