HP 3000 Manuals HP 3000 Manuals
DISKUSE
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:
DISKUSE /
* 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:
DISKUSE /@
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.
LISTFILE dir_name,2;TREE
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.