Content-type: text/html Man page of diskusg

diskusg

Section: Maintenance Commands (8)
Index Return to Main Contents
 

NAME

diskusg - Generates disk accounting data by user ID  

SYNOPSIS

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

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

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 filesystem parameter with the -s flag, the parameter must be an ASCII file containing data in the appropriate format. If filesystem 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.  

DESCRIPTION

The diskusg command generates intermediate disk accounting information about files in the specified filesystem or from standard input. You must specify the raw device special file for filesystem (for example, /dev/rrz3c). A file system must exist on the device.

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

Note that this command can be used only for local devices.  

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


 

Index

NAME
SYNOPSIS
FLAGS
DESCRIPTION
EXAMPLES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:29 GMT, October 02, 2010