DISKUSE. HP (Hewlett-Packard) HP 3000

PDF

Dokumentum

Hirdetés

Command Definitions C-E

DISKUSE

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

NOTREE

USENAME

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.

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

(/).

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.)

Chapter 3 193

Command Definitions C-E

DISKUSE

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

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.

;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 /@

194 Chapter 3

Command Definitions C-E

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

|---------------------

--|----

| | |

-|- ---|-------|--------------------

| | | | | | | | | | | |

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/

208

0 ./d3/d7/d9/