Displays disk space usage, in sectors, for one or more directories
or a directory tree.
Syntax |
 |
DISKUSE [[DIR=]dir_name] [; TREE | NOTREE |
USENAME ]
Parameters |
|
- dir_name
Directory name for which information is being listed
(optional). The dir_name is assumed to
be an MPE syntax name. HFS-named directories may be shown if dir_name
starts with a dot (.) or a slash (/). If dir_name
is an HFS name and ends in a slash, then all objects at all levels
under and including dir_name are reported,
unless the NOTREE
option is specified. The use of wildcards is permitted. If dir_name
is omitted, the process' current working directory (CWD) is assumed.
- TREE
Causes all directories below and including dir_name
to be reported. The dir_name may or may
not end in a slash (/), with no error or warning detected. Since
the MPE naming convention does not support a trailing slash (/),
the TREE option
is the only way to report multi-level disk space usage for an MPE-named
directory in a single command.
- NOTREE
Causes dir_name only
to be reported. If dir_name is an HFS
name and ends in a slash (/), a warning tells you that NOTREE
overrides the trailing slash (/).
- USENAME
Causes DISKUSE
to use dir_name name to decide whether
or not to display multiple levels of directories. If dir_name
is an HFS name and ends in a slash (/), then it and all directories
under it are shown. If dir_name does
not end in a slash (/), then only dir_name
is reported. The USENAME
parameter only applies to HFS-named directories and is ignored for
MPE-named directories. The USENAME
parameter is the default.
Operation |
|
The DISKUSE
command reports 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 ;TREE
is specified, 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 show only the total system disk space in one
line, enter:
DISKUSE /;NOTREE
NOTREE option overrides directory name ending in "/". (CIWARN 9041) |
To display disk space used by all directories directly
under the root, enter:
Examples |
|
The illustration below shows a hierarchical directory structure,
upon which all of the succeeding examples are based. 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).
For illustrative purposes, the HPPROMPT
variable has been set to show the current working directory (HPCWD).
For example:
:setvar hpprompt "hpcwd:"
/ACCT/GROUP/d0: |
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 below illustrates the format of the DISKUSE
output. In this example, the TREE
option is implied by the trailing slash (/). 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 ($).
/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: |
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 the following command equals the number shown under
the LEVEL BELOW
column. The number in the LEVEL BELOW
column is zero if the reported directory is empty.
LISTFILE dir_name/@,2;NOTREE |
- 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 the following command equals the total number in the TREE
column.
The plus signs (+) shown in the TREE column 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: |
MPE syntax can also be used, as shown in the following example
(note that the dir_name (MYDIR) is upshifted.)
This example is not based on the directory structure shown.
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. |
|
| |
|
Wildcards can be used to see a "horizontal cut" of disk s
pace usage at an arbitrary directory depth. Wildcarding can be used
in TREE and NOTREE
output, as shown in the following examples.
/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:
|
/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.
Related Information |
|
- Commands
LISTFILE,
REPORT
- Manuals
None.
