Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Back to Main Index
Displays disk space usage, in sectors, for one or more directories or a directory tree.
DISKUSE [ [DIR=]dir_name] [; TREE | NOTREE | USENAME ]
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 will be reported, unless the NOTREE option is specified. Wildcarding 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 (/). For example, NOTREE option overrides directory name ending in "/". (CIWARN 9041) 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, will be shown. If dir_name does not end in a slash (/), then only dir_name will be reported. USENAME only applies to HFS-named directories and is ignored for MPE-named directories. USENAME is the default.
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 will contribute to the output. This also applies to wildcarded component names. For example, /@/@/@/@, will only count 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.) 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 for additional information on directory permissions). NOTE MPE syntax cannot specify a group.account. MPE syntax only permits DIR.GROUP.ACCT. (If group.account were specified, it would be interpreted as 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 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 wildcarded names, some directories will be seen (up to the directory where the error occurred). Even in the wildcarded directory name case, once an error is encountered, DISKUSE terminates.
The following example illustrates the format of the DISKUSE output. In this example, the TREE option is implied by the trailing slash. 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 +) The next example illustrates the use of the NOTREE option. Only the directory name is displayed. DISKUSE /ACCT/GROUP/d0 ;NOTREE SECTORS TREE LEVEL DIRECTORY (CWD = /ACCT/GROUP/d0) BELOW 960 240 /ACCT/GROUP/d0/ MPE syntax can also be used, as shown in the following example (note that the dir_name (MYDIR) is upshifted.) DISKUSE mydir.group.acct SECTORS TREE LEVEL DIRECTORY (CWD = /ACCT/GROUP/d0) BELOW 2100 330 /ACCT/GROUP/MYDIR
Commands: LISTFILE, REPORT Back to Main Index