diskusg man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

diskusg(8)							    diskusg(8)

       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  spe‐
       cial  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

       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  com‐
       mand  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 supe‐
       ruser.  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 for‐
       mats for writing accounting files.  User database file.

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

       Functions: acct(2)

       System Administration


List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net