lsbl
Lists information about a baseline
SYNOPSIS
- List
baseline information per stream or component or by promotion level:
- lsbl [ –s·hort |
–l·ong | –fmt format-string |
–tre·e
- | –mem·ber_of [ –r·ecurse ]
]
[ –lev·el promotion-level | [ –ltl·evel promotion-level ]
[ –gtl·evel promotion-level ]
]
[ –com·ponent component-selector ]
[ –obs·olete ]
[ –str·eam stream-selector | –cvi·ew ]
- List
information for one or more specific baselines:
- lsbl [ –s·hort | –l·ong |
–fmt format-string | –tre·e
- | –mem·ber_of [ –r·ecurse ]
] [ –obs·olete ] [ baseline-selector ... ]
DESCRIPTION
The lsbl command lists
information for one or more baselines.
OPTIONS AND ARGUMENTS
Specifying the Output
- Default
- A one-line summary of each baseline.
- –s·hort
- Displays only the name of each baseline.
- –l·ong
- For noncomposite baselines, displays detailed
information for each baseline, including ownership, creation, and label information
and the stream, component, change sets, and promotion level associated with
the baseline.
For composite baselines, displays baselines
that the composite directly depends on.
- –fmt format-string
- Displays information in the specified format.
See the fmt_ccase reference page for details.
- –tre·e
- Displays a list of streams and baselines associated
with one or more baselines. The list is indented to show the order of succession
for baselines.
- –mem·ber_of [ –r·ecurse ]
- Used by itself, displays the composite baselines of which each baseline
is a direct member. Used with the –recurse option,
displays all baselines of which each baseline is a direct or indirect member.
The list is indented to show the baseline hierarchy.
Filtering by Promotion Level
- Default
- All promotion levels.
- –lev·el promotion-level
- Displays a list of baselines that are at the
specified promotion level. An error results if the specified level is not
in the project VOB's current list of valid promotion levels. This option
modifies the –stream and –component options.
For general information about promotion levels, see the setplevel reference
page.
- –ltl·evel promotion-level
- Displays a list of baselines whose promotion
level is lower than the one specified by the promotion-level argument. For
example, your project has four promotion levels in this order: PROTOTYPE, REVIEWED, TESTED, CERTIFIED. If you use the argument –ltlevel TESTED,
the lsbl command displays a list of all baselines whose
promotion level is PROTOTYPE or REVIEWED.
This option modifies the –stream and –component options.
- –gtl·evel promotion-level
- Displays a list of baselines whose promotion
level is greater than the one specified. This option modifies the –stream and –component options.
Specifying the Baseline
- Default
- –cview.
- –com·ponent component-selector
- Displays a list of baselines of the specified component.
- –str·eam stream-selector
- Displays a list of baselines created in the
specified stream.
- –cvi·ew
- Displays a list of baselines created in the
stream attached to the current view.
- baseline-selector ...
- Specifies one or more baselines for which information
is displayed.
Listing Obsolete Baselines
- Default
- Lists only nonobsolete baselines.
- –obs·olete
- Includes obsolete baselines in the listing.
Obsolete baselines 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 summary (the default) of baselines of the specified component.
- Display
a description of baselines created in a stream:
- Display a list of streams
and baselines associated with one or more baselines.
- Display all baselines of which
the baseline cvob2_INITIAL is a direct or indirect
member. In this example, cvob2_INITIAL is a direct
member of bl_test6, which in turn is a direct member
of bl_test9. cvob2_INITIAL is
an indirect member of bl_test9.