lscomp

Lists information about a component

APPLICABILITY

ProductCommand type
ClearCasecleartool subcommand
ClearCase LTcleartool 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 two-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.

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 description of components in the specified VOB.

    cmd-context  lscomp -invob /vobs/projects 
    17-Sep-99.12:06:59  parser  bill 
    root directory: "/vobs/parser"
    29-Mar-99.17:23:16  applets  pklenk 
    root directory: "/vobs/applets"
    29-Mar-99.17:23:25  booch  pklenk 
    root directory: "/vobs/booch"
    29-Mar-99 .17L23:37 libobj pklenk 
    root directory: "/vobs/libobj"
    29-Mar-99.17:23:44  stage  pklenk 
    root directory: "/vobs/stage"
    29-Mar-99.17:23:50  sun5_stage  pklenk 
    root directory: "/vobs/sun5_stage"
    29-Mar-99.17:24:01  nt_i386_stage  pklenk 
    root directory: "/vobs/nt_i386_stage"
    29-Mar-99.17:24:57  sys  pklenk 
    root directory: "/vobs/sys"

SEE ALSO

describe, lsbl, mkcomp, rmcomp



Copyright© 2003 Rational Software. All Rights Reserved.