Shows information from fileset headers
Synopsis
fts lsheader -server machine [-aggregate name] [{-fast | -long}] [-cell cellname]
[{-noauth |
-localauth}] [-verbose] [-help]
Options
-server machine
Names a File Server machine about whose filesets header information is to be displayed. Specify the File Server machine using the machine's DCE
pathname, the machine's host name, or the machine's IP address. This option can be combined with the -aggregate option to name a specific aggregate on -server.
-aggregate name
Specifies the device name, aggregate name, or aggregate ID of the aggregate or partition on -server from whose filesets header 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. The
-server option must be provided with this option.
-fast
Directs the output to display only the fileset ID numbers of all filesets on the indicated server (and optionally the aggregate). If you use this option, do not use the
-long option.
-long
Directs the output to display more detailed information about all filesets on the indicated server (and optionally the aggregate). If you use this option, do not use the
-fast option.
-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 lsheader command formats and displays information from the fileset headers of filesets on the specified server (and optionally the aggregate or
partition). To display information from the headers of all filesets on a specific File Server machine, specify the name of the server machine with the -server option. To specify
information from the headers of all filesets on a specific aggregate on a File Server machine, specify the name of the server machine with the -server option and the name of the aggregate or
partition with the -aggregate option.
Include the -fast option with the command to display only the ID numbers of the filesets at the specified location. Include the -long option with the command to display more detailed information from the headers of the filesets at the specified location.
Use the fts lsfldb command to display information from fileset entries in the Fileset Location Database (FLDB). To display more information about a single fileset, use the fts lsft command to display all of the information displayed by this command when the -long option is used and all of the information displayed by the fts lsfldb command.
Privilege Required
The issuer must be listed in the admin.ft file on the machine specified by -server.
Output
The fts lsheader command displays different output about the filesets at the specified location depending on whether the -fast or -long option
is included. Information about the filesets is displayed in numeric order by fileset ID number if the -fast option is used; otherwise, it is displayed in alphabetical order by fileset name.
The information described in this section is displayed for DCE LFS filesets. Because non-LFS filesets do not have DCE LFS fileset headers, the fts lsheader command displays much less information for non-LFS filesets, and the -fast and -long options have less of an impact on the amount of output displayed.
If the -fast option is used, the command lists the ID number of each fileset. If the -aggregate option is omitted, the command also displays the total number of filesets on the specified server.
If both the -fast and -long options are omitted, the command displays the following information:
· The File Server machine, aggregate name, and aggregate ID number where the filesets reside.
· The total number of filesets on the aggregate.
· Each fileset's name (with a .readonly or .backup extension, if appropriate).
· Each fileset's fileset ID number.
· Each fileset's type (RW for read/write, RO for read-only, or BK for backup).
· Each fileset's allocation usage and quota usage, in kilobytes.
· Each fileset's status (On-line, Off-line, or an error indicator).
· The total number of filesets online, the total number of filesets offline, and the total number of filesets busy. A busy fileset is one upon which a fileset-related operation is currently in progress (for example, the fileset is being moved or cloned, or the Replication Server is currently forwarding changes from the fileset to read-only replicas).
If the -long option is used, the command displays the following additional information for each fileset:
· Whether it is a DCE LFS (LFS) or non-LFS fileset
· Information about the state of the fileset
· The ID numbers of the parent, clone, and backup filesets related to the fileset
· The ID numbers of the low-level backing and low-level forward filesets related to the fileset
· The version number of the fileset
· The allocation and allocation usage, in kilobytes, of the fileset
· The quota and quota usage, in kilobytes, of the fileset
· The day, date, and time when the fileset was created (replicated or backed up for a read-only or backup fileset)
· The day, date, and time when the contents of the fileset were last updated (same as the creation time for a read-only or backup fileset)
Examples
The following examples show output from the fts lsheader command when it is executed with the -fast option, with neither the -fast option nor
the -long option, and with the -long option. All three examples display output primarily for the same fileset, user.terry (ID number 0,,196953).
$ fts lsheader /.../abc.com/hosts/fs3 /dev/lfs1 -fast
0,,196953
0,,196956
.
.
0,,199845
0,,199846
$ fts lsheader /.../abc.com/hosts/fs3 /dev/lfs1
Total filesets on server fs3 aggregate lfs1 (ID 10): 16
user.terry 0,,196953 RW 5071 K alloc 8421 K quota On-line
user.wvh 0,,196956 RW 4955 K alloc 9371 K quota On-line
.
.
Total filesets on-line 15; total off-line 1; total busy 0
$ fts lsheader /.../abc.com/hosts/fs3 /dev/lfs1 -long
Total filesets on server fs3 aggregate lfs1 (ID 10): 16
user.terry 0,,196953 RW LFS states 0x10010005 On-line
fs3.abc.com, aggregate lfs1 (ID 10)
Parent 0,,196953 Clone 0,,0 Backup 0,,196955
llBack 0,,0 llFwd 0,,0 Version 0,,25963
429496729 K alloc limit; 1252 K alloc usage
15000 K quota limit; 9340 K quota usage
Creation Tue Oct 15 16:45:16 1991
Last Update Fri Nov 22 11:36:00 1991
user.wvh 0,,196956 RW LFS states 0x10010005 On-line
.
.
Total filesets on-line 15; total off-line 1; total busy 0
Related Information
Commands: fts lsfldb(8dfs)
Files: dfstab(4dfs)