diskusg - Generates disk accounting data by user ID
/usr/sbin/acct/diskusg [-U number] [-s] [-v] [-p pw_filename]
[-u u_filename] [-i ignlist] [file_spec...]
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.
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:
root_domain#root.
You cannot specify an AdvFS file system that is not
mounted.
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
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.
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.
Specifies the command path. Accounting header files that
define formats for writing accounting files. User
database file.
Commands: acct(8), acctdisk(8), acctdusg(8), acctmerg(8),
dodisk(8), runacct(8)
Functions: acct(2)
System Administration
diskusg(8)
[ Back ] |
