Sls

From SRB

Contents

NAME

Sls - display objects and sub-collections in a SRB collection

SYNOPSIS

Sls [-aChlVpvX] [-r|-f] [-A condition] [collection|srbObj ...]

Sls -c [-aChlvX] [-z zone] condition

DESCRIPTION

Sls utility displays objects that match the input srbObj, or objects and sub-collections in collection. When invoked with no collection|srbObj operand, the current working SRB collection value is displayed.

The second synopsis applies the condition and displays the resultant list of objects. It applies across all collections.

When the operand collection does not begin with '/', '../' or '^/' the collection name used is with respect to the current working collection.

When the operand collection begins with '^/' the collection name used is with respect to the mdasCollectionHome value in the ~/.srb/.MdasEnv file.

When the operand collection begins with '../' the collection name used is with respect to the parent of current working collection.

When the operand collection begins with '/' the collection name used is that of the operand value.

When the operand collection contains wildcard characters *|? then collection must be surrounded by double quotes.


OPTIONS

-a
list metaData associated with each file and collection.
-C
list the access control list of each file and collection. A char- acter "I" following the collection means the "ACL inherit bit" is set for the collection.
-r
display recursively for sub-collections of collection
-f
Force each argument to be interpreted as a collection.
-h
displays command options
-l
List in long format, giving owner, replica number, physical resource, size in bytes, time of creation, copy status and object name. A "%" for "copy status" means it is the most up-to-date copy. A "$" means the copy is bad (discovered by file check) and should be replaced.
-X
List using the Master MCAT. The default uses the Slave MCAT (unless the "masterMcat" environment variable is set) if configured.
-v
Lists in long format as -l but also includes the version numbers of all the copies.
-p
List the resource and physical path of the data file.
-V
Verify the physical path assoicated with the data by doing a file stat on the physical path. Only works for UNIX type resource currently.
-A
condition option is an '&' separated condition which will be applied in choosing the object to be listed. The separated condition is of the form "<Attr> <CompOp> <Value>", where <Attr> is an MCAT attribute found by Sattrs command, <CompOp> is a comparison operator and <Value> is a numeric or string value. The entire condition should be within a set of double quotes. Example: Sls -A "COPY = 0"
-c
condition option applies to the whole SRB system instead of relative to the current working collection. Example: Sls -c "GUID='123'" will find all objects that have their Guid set to 123. See Sattrs for details of applicable conditions.
-z
zone option applies to the second synopsis and is used to perform the Sls operation on a particular zone. If ALL is used for zone then every zone known to the current zone will be queried. zone can have wild cards.

SEE ALSO

Spwd, Scd, SgetD, Sattrs