This command displays disk space usage, in sectors, for one or more directories or a directory tree.
Operation Notes |
 |
You can use the DISKUSE command to report on disk space, in sectors, for a directory. Disk space allocated to directories themselves (including accounts and MPE groups) is counted as part of the total number of sectors. The process' CWD is shown for all relative pathnames.
The number of components in the pathname controls the level of directories being reported. If a pathname has four components, for example, /a/b/c/d, then only directories with four or more components contribute to the output. This also applies to the use of wildcard component names. For example, /@/@/@/@ only counts directories with at least four components in their pathname (absolute or relative, depending on how it was specified). MPE names follow the same formula: @.@.@ reports only MPE-named directories one level below MPE groups. (@.@ is the same since it is qualified with the logon account name.)
Use |
|
You must have traverse directory entries (TD) and read directory entries (RD) permissions to each directory contributing to the reported totals. TD access is needed to each directory component named in dir_name. (Refer to the ALTSEC command in this chapter for additional information on directory permissions.)
Note that the MPE syntax cannot specify a group.account. MPE syntax only permits dir.group.acct if dir is a valid MPE name; that is, all uppercase alphanumeric. (If group.account were specified, it would be interpreted as a file called group.account.logon_account.)
Directory errors can occur while DISKUSE is collecting file space information. For example, if you lack traverse directory entries (TD) access to one or more of the lower level directories, an error occurs.
If you specify ;TREE, you will only be able to see directories that you have TD and RD access to. DISKUSE stops on the first error encountered. This may result in no data (other than a header) displayed, or in the case of wildcard names, some directories are seen (up to the directory where the error occurred). Even in the wildcard directory name case, once an error is encountered, DISKUSE terminates.
There are several ways to see all disk space used on the system:
To show the disk space for every directory on the system, enter:
To display disk space used by all directories directly under the root, enter:
Examples |
|
Figure 2-1 “Hierarchical Directory Structure” illustrates a hierarchical directory structure. In this figure, directory names are shown as the character d plus a number (for example, d0), and file names are shown as the character f plus a number (for example f1). All of the examples following Figure 2-1 “Hierarchical Directory Structure” assume the directory structure shown. For illustrative purposes, the HPPROMPT variable has been set to show the current working directory (HPCWD). For example:
:setvar hpprompt "hpcwd:"
/ACCT/GROUP/d0:
|
Figure 2-1 Hierarchical Directory Structure
/ACCT/GROUP/d0 = CWD
|
-----------------------------------|---------------------------------------
| | | | | |
d1 d2 d3 f1 f2 f3
| |
--------------|--------------- ----|--------------
| | | | | | | | | | |
d4 f4 f5 d5 d6 f6 d7 f7 f8 f9 f10
| | | |
---|-- ---| -----|---- --|-----------------------
| | | | | | | | | | | |
f11 f12 d8 f13 f14 f15 d9 f16 f17 f18 f19 f20
|
The example shown in Figure 2-2 “DISKUSE Output Format” illustrates the format of the DISKUSE output. In this example, the TREE option is implied by the trailing slash (/).
Figure 2-2 DISKUSE Output Format
/ACCT/GROUP/d0:diskuse ./
SECTORS
TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)
BELOW
64 + 0 ./d1/
96 32 ./d2/d4/
64 0 ./d2/d5/d8/
128 64 ./d2/d5/
112 48 ./d2/d6/
448 + 240 ./d2/
64 0 ./d3/d7/d9/
208 144 ./d3/d7/
336 + 128 ./d3/
48 + 0 (files directly below specified directory)
960 240 ./ (64 +)
/ACCT/GROUP/d0:
|
|
| |
|
 | NOTE: The current working directory (CWD) relative display is shown as part of the header line. If the CWD name is long, it truncates with a dollar sign ($). |
|
| |
|
Each of the columns contains information about the directory.
- DIRECTORY
(left-justified) Displays the selected directory name, in HFS-format. The directory pathname wraps around to the next line if it is longer than the field.
- LEVEL BELOW
(right-justified) Shows the number of sectors allocated directly to all objects immediately under the named directory. The space used by the listed directory file (container) does not contribute to this number, nor does the space used by the objects under directories under the displayed directory. The sum of the number of sectors reported by a
LISTFILE dir_name/@,2;NOTREE
|
equals the number shown under the LEVEL BELOW column. The number in the LEVEL BELOW column is zero if the reported directory is empty.
- TREE
(right-justified) Displays the total number of sectors used by the directory listed. This includes space used by the directory itself, all files immediately under the directory, and space used by all subdirectory entries. The sum of the number of sectors seen in a
equals the total number in the TREE column.
The plus signs (+) shown in the TREE column of Figure 2-2 “DISKUSE Output Format” refer to the directories that are one level below the target directory. When added, the sectors shown in this example equal 896. The last entry shows the total number of sectors (960) used by all subdirectories under the target directory (896) plus the sectors used by the target directory itself (64).
The next example illustrates the use of the NOTREE option. Only the directory name is displayed.
/ACCT/GROUP/d0:diskuse /ACCT/GROUP/d0 ;notree
SECTORS
TREE LEVEL DIRECTORY
BELOW
960 240 /ACCT/GROUP/d0/
/ACCT/GROUP/d0:
|
If the directory name parameter is omitted, the CWD is assumed, as seen in the following example:
/ACCT/GROUP/d0:diskuse
SECTORS
TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)
BELOW
960 240 ./
|
The next example illustrates the use of the TREE option. Information is reported for the dir_name (d3) and all directories below.
/ACCT/GROUP/d0:diskuse ./d3/@ ;tree
SECTORS
TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)
BELOW
64 0 ./d3/d7/d9/
208 + 144 ./d3/d7/
208 ./d3/@
/ACCT/GROUP/d0:
|
You can use MPE syntax as shown in the following example (note that the dir_name (MYDIR) is upshifted.) This example is not based on the directory structure shown in Figure 2-1 “Hierarchical Directory Structure”.
DISKUSE mydir.group.acct
SECTORS
TREE LEVEL DIRECTORY
BELOW
2100 330 /ACCT/GROUP/MYDIR
|
|
| |
|
| NOTE: The output is presented in HFS syntax, even if the directory name is supplied in MPE syntax. If wildcards were used to specify the directory name in MPE syntax, then the final line of output is the user-supplied directory name (upshifted) in MPE format. |
|
| |
|
You can use wildcards to see a "horizontal cut" of disk space usage at an arbitrary directory depth. Wildcarding can be used in TREE and NOTREE output, as shown in the following examples.
Figure 2-3 Using Wildcards with NOTREE Output
/ACCT/GROUP/d0:diskuse ./@
SECTORS
TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)
BELOW
64 + 0 ./d1/
448 + 240 ./d2/
336 + 128 ./d3/
848 ./@
/ACCT/GROUP/d0:
|
Figure 2-4 Using Wildcards with TREE Output
/ACCT/GROUP/d0:diskuse ./@/
SECTORS
TREE LEVEL DIRECTORY (CWD= /ACCT/GROUP/d0)
BELOW
64 + 0 ./d1/
96 32 ./d2/d4/
64 0 ./d2/d5/d8/
128 64 ./d2/d5/
112 48 ./d2/d6/
448 + 240 ./d2/
64 0 ./d3/d7/d9/
208 144 ./d3/d7/
336 + 128 ./d3/
848 ./@
/ACCT/GROUP/d0:
|
The last line of output contains the directory name and the total number of sectors (under the TREE column). The final TREE number always equals the sum of all other TREE numbers for directories with the same number of components as contained in the user-specified name that are designated with a plus sign (+) in the TREE column. For example, if you specified a pathname with three components, then the sum of the TREE field for all directory names with exactly three components equals the final total value.
