lscomp

Lists information about a component

APPLICABILITY


Product

Command Type

ClearCase


cleartool subcommand


ClearCase LT


cleartool subcommand


Platform

UNIX


Windows

SYNOPSIS

lscomp [ -s·hort | -l·ong | -fmt format-string |-tre·e ]

[ -inv·ob vob-selector | component-selector ...] [ -obs·olete ]

DESCRIPTION

The lscomp command lists information about one or more components.

RESTRICTIONS

None.

OPTIONS AND ARGUMENTS

SPECIFYING THE OUTPUT. Default: A one-line summary.
-s·hort

Displays only the name of each component.
-l·ong

Displays an expanded multiple-line listing for each component, similar to the describe -long command.
-fmt format-string

Displays information using the specified format-string. See the fmt_ccase reference page for details.
-tre·e

Recursively lists baselines and streams in the specified components. The output format is similar to that of the lsvtree command.

SPECIFYING THE COMPONENT Default: All components in the project VOB of the current directory.

-inv·ob vob-selector

Displays information for all components in the specified project VOB.
component-selector ...

Specifies one or more components for which information is displayed.

LISTING OBSOLETE COMPONENTS. Default: Lists only nonobsolete components.

-obs·olete

Includes obsolete components in the listing. Obsolete components 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. In Attache, cmd-context represents the workspace 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.

SEE ALSO

describe, lsbl, mkcomp, rmcomp