Lists fileset information from both the fileset header and the FLDB entry
Synopsis
fts lsft [{-path {filename | directory_name} | -fileset {name | ID}}] [-server machine]
[-cell cellname] [{-noauth | -localauth}] [-verbose] [-help]
Options
-path {filename | directory_name}
Names a file or directory on the fileset whose fileset header and FLDB information is to be displayed. Use this option or
use -fileset; omit both options to display information about the fileset that contains the current working directory.
-fileset {name | ID}
Specifies the complete name or fileset ID number of the fileset to be examined. The read/write, read-only, or backup version of the
fileset can be specified. Append the .backup or .readonly extension to the name of the fileset to list information about the backup or read-only version instead of the read/write
version; if the read/write version no longer exists, the command fails if the .backup or .readonly extension is not used with the name of the fileset.
Use this option or use -path; omit both options to display information about the fileset that contains the current working directory.
-server machine
Names the File Server machine that houses the fileset about which 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 is useful for displaying information about a particular read-only replica of a DCE LFS fileset for which multiple replicas exist. If you include the .readonly extension with the name of a fileset specified with the -fileset option, specify the ID number of the read-only version of a fileset with the -fileset option, or specify the path to a file or directory in a read-only fileset with the -path option, you can use the -server option to indicate the machine that houses the specific replica about which information is to be displayed. If you omit the -server option in these cases, the command displays information about the replica at the fileset's oldest read-only site (the replica at the site that has been defined for the longest time).
This option is always unnecessary if information is to be displayed about the read/write or backup version of a fileset.
-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 lsft command displays information from both the fileset header and the Fileset Location Database (FLDB) entry for the specified fileset. It
displays the same output as the fts lsheader command with the -long option and the fts lsfldb command for a single fileset. It can be used to learn the fileset ID number
of a fileset or to examine locked FLDB entries.
The fileset whose information is to be displayed can be specified by indicating the name of a file or directory on the fileset with the -path option, or it can be specified by indicating its name or ID number with the -fileset option. Omit both the -path and -fileset options to display information about the fileset that contains the current working directory. If the name of the fileset is specified with the -fileset option, the .backup or .readonly extension can be appended to the name to display information about one of those fileset versions rather than the read/write version.
If information about a read-only replica of a DCE LFS fileset is to be displayed and multiple replicas of the fileset exist, the -server option can be used to name the File Server machine that houses the specific replica about which information is to be displayed. Indicating a specific replica can be useful if network or hardware problems caused only some of a fileset's replicas to be updated. (By default, all replicas of the same fileset should always contain the same information.)
Use the fts lsheader command to display information from fileset headers. Use the fts lsfldb command to display information from fileset entries in the FLDB.
Privilege Required
No privileges are required.
Output
The fts lsft command displays the following information from the fileset header and the FLDB entry for a specified DCE LFS fileset. Because non-LFS filesets do
not have DCE LFS fileset headers, and because functionality such as replication is not supported for non-LFS filesets, this command displays less information for a non-LFS fileset.
The command displays the following information from the fileset's header:
· The fileset's name (with a .readonly or .backup extension, if appropriate)
· Its fileset ID number
· Its type (RW for read/write, RO for read-only, or BK for backup)
· Its type (LFS or non-LFS)
· Information about the state of the fileset
· Its status (On-line, Off-line, or an error indicator)
· The File Server machine, aggregate name, and aggregate ID number on which it resides
· 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
· Its version number
· Its allocation and allocation usage, in kilobytes
· Its quota and quota usage, in kilobytes
· 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)
It then displays the following information from the fileset's entry in the FLDB:
· The fileset's name.
· The fileset IDs of the read/write, read-only, and backup versions of the fileset.
· For each version, a status flag of valid indicates the version actually exists at a site; a status flag of invalid indicates the version does not exist at any site. (For the read-only version, the status flag indicates whether a replication site is defined.)
· The maximum and minimum advisory RPC authentication bounds for use in communications with Cache Managers. There are two sets of bounds: One set governs communications with Cache Managers in the local cell while, the other set governs communications with Cache Managers in foreign cells. Currently, these bounds are not enforced but serve to bias the Cache Managers initial authentication level.
· The number of sites at which a version of the fileset exists.
· An indicator if the FLDB entry is locked. (The indicator is omitted if the entry is not locked.)
· The replication parameters associated with the fileset.
· Information identifying the File Server machines and aggregates (sites) on which read/write (RW), read-only (RO), or backup (BK) versions of the fileset reside.
· For a read-only version, the MaxSiteAge replication parameter defined for that site; for a read/write version, 0:00:00.
· The abbreviated DCE principal name of each File Server machine on which a version of the fileset resides, and the name of the group that owns the server entry for the machine (or <nil> if no group owns the server entry).
Examples
The following example displays information from the fileset header and FLDB entry for a DCE LFS fileset named user.terry:
$ fts lsft -fileset user.terry
_______________________________________________________________
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 Fri Oct 15 16:45:16 1993
Last Update Mon Nov 22 11:36:00 1993
user.terry
readWriteID 0,,196953 valid
readOnlyID 0,,196594 invalid
backupID 0,,196595 valid
Minimum local protection level: rpc_c_protect_level_none
Maximum local protection level: rpc_c_protect_level_pkt_privacy
Minimum remote protection level:
rpc_c_protect_level_none
Maximum remote protection level: rpc_c_protect_level_pkt_privacy
number of sites: 2
Sched repl: maxAge=2:00:00; failAge=1d0:00:00;
reclaimWait=18:00:00; minRepDelay=0:05:00;
defaultSiteAge=0:30:00
server flags aggr siteAge principal owner
fs3.abc.com RW,BK
lfs1 0:00:00 hosts/fs3 <nil>
_______________________________________________________________
Related Information
Commands: fts lsfldb(8dfs)