fts aggrinfo(8dfs)

Synopsis

fts aggrinfo -server machine [-aggregate name] [-cell cellname] [{-noauth | -localauth}]
[-verbose] [-help]

Options

-server machine
Names the File Server machine about whose aggregates and partitions information is to be displayed. Specify the File Server machine using the machine's DCE path name, the machine's host name, or the machine's IP address.

-aggregate name
Specifies the device name, aggregate name, or aggregate ID of an exported aggregate or partition about which information is to be displayed. These identifiers are specified in the first, second, and fourth fields of the entry for the aggregate or partition in the dcelocal/var/dfs/dfstab file. If this option is omitted, information is provided about all of the exported aggregates and partitions on the specified machine.

-cell cellname
Specifies the cell where the command is to be run. The default is the local cell of the issuer of the command.

-noauth
Directs fts to use the unprivileged identity nobody as the identity of the issuer of the command. If you use this option, do not use the -localauth option.

-localauth
Directs fts to use the DFS server principal name of the machine on which the command is issued as the identity of the issuer. Use this option only if the command is issued from a DFS server machine (a machine that has a DFS server principal in the local Registry Database). You must be logged into the server machine as root for this option to work. If you use this option, do not use the -noauth option.

-verbose
Directs fts to provide detailed information about its actions as it executes the command.

-help
Prints the online help for this command. All other valid options specified with this option are ignored.

Description
The fts aggrinfo command lists information about the total amount of disk space and the amount of disk space currently available on exported aggregates and partitions. The -server option is used to specify the File Server machine on which the aggregates and partitions reside. The -aggregate option can be used to specify a single aggregate or partition about which information is to be displayed. If this option is omitted, information about all aggregates and partitions exported from the specified server is displayed. (Much of the information displayed by the fts aggrinfo command is specified in the dcelocal/var/dfs/dfstab file.)

The fts aggrinfo command displays roughly the same information as the df command available in the UNIX operating system. The df command can also be used to display information about exported DCE LFS aggregates and locally mounted DCE LFS filesets.

The fts lsaggr command can also be used to list all of the aggregates and partitions exported from a File Server machine.

Privilege Required
No privileges are required.

Output
The fts aggrinfo command displays a separate line for each aggregate or partition. Each line displays the following information:

· The file system type (LFS for a DCE LFS aggregate, or Non-LFS for a non-LFS partition).

· The aggregate name.

· The device name.

· The number of kilobytes of disk space currently available for use on the aggregate or partition.

· The total number of kilobytes on the aggregate or partition (not including any reserved disk space).

· The number of kilobytes, if any, of reserved disk space on the aggregate or partition. DCE LFS reserves a variable amount of disk space on each aggregate for internal purposes (for example, to accommodate additional space required for fileset move and clone operations). Some non-LFS implementations also reserve some amount of overdraw disk space for administrative purposes.

The fts aggrinfo and UNIX df commands produce essentially the same information.

Examples
The following example displays information about the disk space available on all aggregates and partitions exported from the File Server machine named /.../abc.com/hosts/fs1:

$ fts aggrinfo /.../abc.com/hosts/fs1

Non-LFS aggregate /usr (/dev/lv02): 24048 K free out of total 98304

(10923 reserved)

Non-LFS aggregate /tmp (/dev/lv03): 11668 K free out of total 12288

(1365 reserved)

LFS aggregate lfs1 (/dev/lfs1): 100537 K free out of total 101340

(2048 reserved)

LFS aggregate lfs2 (/dev/lfs2): 71957 K free out of total 73728

(2048 reserved)

Related Information
Commands: fts lsaggr(8dfs)

Files: dfstab(4dfs)