lsproject

Lists information about a project

Applicability

Product

Command type

VersionVault

cleartool subcommand

VersionVault Remote Client

rcleartool subcommand

Platform

UNIX

Linux

Windows

Synopsis

  • Lists information about a project:
    lsproj/ect [ –s/hort | –l/ong | –fmt format-string
    | –tre/e [ –fmt format-string] [ –dep/th depth]

    | –anc/estor[ –fmt format-string ] [ –dep/th depth ] ]

    [ –obs/olete ] [–inv/ob vob-selector | –in folder-selector [ –r/ecurse ]

    | –vie/w view-tag | –cvi/ew | project-selector ... ]

  • Lists information about a project template:
    lsproj/ect –template
    [–long | –custom ] [–invob vob-selector]

Description

The lsproject command lists information for one or more projects or for the project template.

Restrictions

None.

Options and arguments

Selecting a display format

Default
A one-line summary.
–s/hort
Displays project names only.
–l/ong
Displays the following detailed information for a project:
  • Name
  • The folder it is in
  • Integration stream
  • Title (if different from the name)
  • Modifiable components
  • Default rebase promotion level
  • Recommended baselines
  • Project model
  • Policies
  • Baseline naming template

And the following additional information for a project enabled for Compass:

  • Compass record ID
  • The name of the Compass user database
  • Compass policies
–fmt format-string
Displays information in the specified format. For details, see the fmt_ccase reference page.
–tre/e [ –fmt format-string ] [ –dep/th depth ]
Displays information for a project, including its hierarchy of streams and activities. You can modify how information is displayed with the –fmt and –depth options.

The –fmt option displays information using the specified format.

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 one or more projects and its parent folders. You can modify how information is displayed with the –fmt and –depth options.

The –fmt option displays information using the specified format.

The –depth option lists the hierarchy of objects to the level specified by the depth argument. The depth argument must be a positive integer.

Listing obsolete projects

Default
List only nonobsolete projects.
–obs/olete
Includes obsolete projects in the listing. Obsolete projects are those that have been processed with lock –obsolete.

Specifying the project

Default
All projects in the project VOB of the current directory.
–inv/ob vob-selector
Displays a list of all projects in the specified project VOB.
–in folder-selector
Displays a list of projects in the specified folder. With –r/ecurse, lists the contents of subfolders.
–vie/w view-tag
Displays information for the project containing the stream attached to the specified view.
–cvi/ew
Displays information for the project containing the stream attached to the current view.
project-selector ...
Specifies one or more projects to list.

Listing information for the project template

–template
Lists information for the project template.
–long
Displays a long description of the project template.
–custom
Displays the custom file for the project template
–invob vob-selector
Displays the project template for the specified project VOB.

Examples

The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you might 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 might 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 system and Linux shells or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.

  • Display a detailed description of project p7, which is not enabled for Compass.

    cmd-context lsproject -long p7
    project "p7"
    2007-02-19T17:43:08 by Sheila Hunt (sheila.user@echo01)
    owner: sheila
    group: user
    folder: RootFolder@/vobs/sheila_testpvob
    integration stream: int7@/vobs/sheila_testpvob
    modifiable components:
      c1@/vobs/sheila_testpvob
      c2@/vobs/sheila_testpvob
    default rebase promotion level: INITIAL
    recommended baselines:
      bld.bl3.161@/vobs/sheila_testpvob (c1@/vobs/sheila_testpvob)
      bld.bl2.181@/vobs/sheila_testpvob (c2@/vobs/sheila_testpvob)
    model: DEFAULT
    policies:
      POLICY_UNIX_INT_SNAP disabled
      POLICY_UNIX_DEV_SNAP disabled
      POLICY_WIN_INT_SNAP disabled
      POLICY_WIN_DEV_SNAP disabled
      POLICY_INTRAPROJECT_DELIVER_FOUNDATION_CHANGES disabled
      POLICY_INTRAPROJECT_DELIVER_ALLOW_MISSING_TGTCOMPS disabled
      POLICY_INTERPROJECT_DELIVER disabled
      POLICY_INTERPROJECT_DELIVER_FOUNDATION_CHANGES disabled
      POLICY_INTERPROJECT_DELIVER_REQUIRE_TGTCOMP_VISIBILITY disabled
      POLICY_INTERPROJECT_DELIVER_ALLOW_NONMOD_TGTCOMPS disabled
    baseline naming template: component_project_date_time

  • Display a detailed description of project P4n, which is enabled for Compass.

    cmd-contextlsproject -l project:P4n@\yuhong_auto_test_pvob1
    project "P4n"
    2007-02-19T16:26:59 by yuhong:Domain Users@qent124b
    owner: ATRIA\yuhong
    group: ATRIA\Domain Users
    folder: RootFolder@\yuhong_auto_test_pvob1
    integration stream: P4_integration@\yuhong_auto_test_pvob1
    modifiable components:
    default rebase promotion level: INITIAL
    recommended baselines:
    model: DEFAULT
    policies:
      POLICY_UNIX_INT_SNAP disabled
      POLICY_UNIX_DEV_SNAP disabled
      POLICY_WIN_INT_SNAP disabled
      POLICY_WIN_DEV_SNAP enabled
      POLICY_DELIVER_REQUIRE_REBASE disabled
      POLICY_DELIVER_NCO_DEVSTR disabled
      POLICY_INTRAPROJECT_DELIVER_FOUNDATION_CHANGES disabled
      POLICY_INTRAPROJECT_DELIVER_ALLOW_MISSING_TGTCOMPS disabled
      POLICY_INTERPROJECT_DELIVER disabled
      POLICY_INTERPROJECT_DELIVER_FOUNDATION_CHANGES disabled
      POLICY_INTERPROJECT_DELIVER_REQUIRE_TGTCOMP_VISIBILITY disabled
      POLICY_INTERPROJECT_DELIVER_ALLOW_NONMOD_TGTCOMPS disabled
    compass record id: P4n
    compass user database name: test
    compass policies:
      "Check assignment before WorkOn" enabled
      "Check before VersionVault delivery" enabled
      "Check Compass Mastership before delivery" disabled
      "Do Compass action after delivery" enabled
    baseline naming template: basename_project_stream_component_date_time

  • Display a one-line summary of the project containing the stream attached to the specified view.

    cmd-context lsproject –view java_int
    2007-09-17T11:24:18 Java_Parser_Project_28174 bill "Java Parser Project"