Shows information from fileset entries in the FLDB
Synopsis
fts lsfldb [-fileset {name | ID}] [-server machine] [-aggregate name] [-locked]
[-cell
cellname] [{-noauth | -localauth}] [-verbose] [-help]
Options
-fileset {name | ID}
Specifies the complete name or fileset ID number of a fileset about which information from the Fileset Location Database (FLDB) is to be
displayed. Use this option or use -server (and optionally -aggregate), -locked, or both. Omit this option and the -server, -aggregate, and
-locked options to display information about all fileset entries in the FLDB.
-server machine
Names a File Server machine about whose filesets information from the FLDB 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 -aggregate to display information about the filesets on a single aggregate on
-server, or it can be combined with -locked to display information about the filesets with locked FLDB entries on the server machine. Use this option alone or with
-aggregate, -locked, or both, or use -fileset. Omit this option and the -fileset, -aggregate, and -locked options to display information about
all fileset entries in the FLDB.
-aggregate name
Specifies the device name, aggregate name, or aggregate ID of the aggregate or partition on -server about whose filesets information from the
FLDB 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. The -locked option can be supplied with this option to display information about the filesets with locked FLDB entries on the
aggregate.
-locked
Specifies that the output show information only for filesets with locked FLDB entries. Use this option alone to see information for all filesets with locked FLDB
entries. Use this option with -server (and optionally -aggregate) to see all filesets on a specific server machine (and optionally aggregate) with locked FLDB entries. Use this
option alone or with -server (and optionally -aggregate) or use -fileset. Omit this option and the -fileset, -server, and -aggregate options to
display information about all fileset entries in the FLDB.
-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 lsfldb command formats and displays information about fileset entries from the FLDB. Its options can be combined to display information about a
variety of different filesets. To display FLDB information for
· Every fileset entry, specify no options
· Every fileset entry that mentions a specific File Server machine as the site of any version of a fileset, specify the name of the machine with -server
· Every fileset entry that mentions a specific aggregate on a specific File Server machine as the site of any version of a fileset, specify both -server and -aggregate
· The FLDB entries for filesets with locked entries, specify the -locked option alone or with -server (and optionally -aggregate)
· The fileset entry for a single fileset, specify the fileset name or ID number with -fileset
Use the fts lsheader command to display information from fileset headers. To display more information about a single fileset, use the fts lsft command to display all of the information displayed by the fts lsheader command when the -long option is used and all of the information displayed by this command.
Privilege Required
No privileges are required.
Output
The fts lsfldb command displays the following information from the FLDB for each DCE LFS fileset specified with -fileset or -server (and
optionally -aggregate). Because functionality such as replication is not supported for non-LFS filesets, this command displays less information for non-LFS filesets.
· 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 number of sites at which a version of the fileset exists.
· 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.
· 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) where 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).
If the output includes more than one FLDB entry, information about the filesets is displayed in alphabetical order by fileset name. The last line of the output displays the total number of entries successfully reported and the total number of entries not reported (the number of entries that failed).
Examples
The following command shows an example of the output from the fts lsfldb command for a fileset named user.terry:
$ fts lsfldb user.terry
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: 1
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 lock(8dfs)
Files: dfstab(4dfs)