lsfolder
Lists information about folders
SYNOPSIS
- lsfolder [ –s·hort | –l·ong | –fmt format-string
- | –tre·e [ –fmt format-string ] [ –dep·th depth ]
| –anc·estor [ –fmt format-string ]
[ –dep·th depth ]
]
[ –inv·ob vob-selector | –in folder-selector | –vie·w view-tag | –cvi·ew
| folder-selector ...] [ –obs·olete ]
DESCRIPTION
The lsfolder command
displays information that describes one or more folders.
OPTIONS AND ARGUMENTS
Choosing a Display Format
- Default
- A one-line summary.
- –s·hort
- Displays only the the name of each folder.
- –l·ong
- Displays a detailed listing for a folder.
- –fmt format-string
- Displays information in the specified format.
See the fmt_ccase reference page for more
information.
- –tre·e [ –fmt format-string ]
[ –dep·th depth ]
- Displays information about a folder and
its contents. Default output format is similar to that of the lsvtree command.
The –fmt option
displays information in the format specified by the format-string argument.
See the fmt_ccase reference page for details.
The –depth option
lists the hierarchy of objects to the level specified by the depth argument.
The depth argument must be a positive integer.
- –anc·estor [ –fmt format-string ]
[ –dep·th depth ]
- Displays information about a folder and
any parent folders.
The –fmt option
formats information using the specified format-string. See
the fmt_ccase reference page for more information.
The –depth option
specifies how many levels to display. The depth argument
must be a positive integer: a value of zero lists the entire hierarchy.
Specifying a Folder
- Default
- All folders in the project VOB of the
current directory.
- –inv·ob vob-selector
- Displays a list of folders in the specified
project VOB.
- –in folder-selector ...
- Displays a list of subfolders of the specified
folder or folders.
- –vie·w view-tag
- Displays information about the parent folder
of the stream attached to the specified view.
- –cvi·ew
- Displays information about the parent folder
of the stream attached to the current view.
- folder-selector ...
- Specifies one or more folders to list.
Listing Obsolete Folders
- Default
- Lists only nonobsolete folders.
- –obs·olete
- Includes obsolete folders in the listing.
Obsolete folders are those that have been processed with lock –obsolete
EXAMPLES
The UNIX examples in this section are written for use in csh.
If you use another shell, you may need to use different quoting and escaping
conventions.
The Windows examples that include wildcards or quoting are written for
use in cleartool interactive mode. If you use cleartool single-command
mode, you may need to change the wildcards and quoting to make your command
interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents
the UNIX shell or Windows command interpreter prompt, followed by the cleartool command.
In cleartool interactive mode, cmd-context represents
the interactive cleartool prompt.
Note: In the UNIX examples that follow, arguments and output that show
multicomponent VOB tags are not applicable to ClearCase LT, which recognizes
only single-component VOB tags. In this manual, a multicomponent VOB tag is
by convention a two-component VOB tag of the form /vobs/vob-tag-leaf—for
example, /vobs/src. A single-component VOB tag consists
of a leaf only—for example, /src. In all other
respects, the examples are valid for ClearCase LT.
- Display
a one-line summary of the specified folder.
- Display
a long listing for the specified folder.