lsrolemap

Lists rolemaps

Applicability

Product

Command type

VersionVault

cleartool subcommand

Platform

UNIX®

Linux®

Windows®

Synopsis

  • List rolemaps:
    lsrolemap [ -long | -short | -nostatus ] [ -obsolete ]
    [ -principal principal | -me ]
    [ [ -invob vob-selector [ -unsorted ] ] | rolemap-selector ... ]
  • Output rolemap listing to a file:
    lsrolemap [ -fmt format | -out output_pname ] [ -obsolete ]
    [ -principal principal | -me ]
    [ [ -invob vob-selector [ -unsorted ] ] | rolemap-selector ... ]

Description

The lsrolemap command lists information about the rolemaps in a VOB.

Restrictions

Authorization

The principal must have the following permissions on each rolemap that is to be listed:
  • For default behavior: read-name and read-info
  • For lsrolemap -short: read-name
Rolemaps for which a principal lacks the required permissions are omitted from the listing.

Mastership

(Replicated VOBs only) No mastership restrictions.

Options and arguments

Customizing the listing

-long
Lists detailed information about each rolemap in the VOB.
-short
Lists only rolemap names.
-nostatus
Implies the -short option and prints out all rolemap names regardless of lock status.
-obsolete
Lists obsolete (locked) rolemaps.
-principal principal
Lists only those rolemaps that contain the specified principal.
-me
Lists only those rolemaps where the current user or one of the current user's groups is explicitly contained in the rolemap .
-fmt format-string
Lists information using the specified format string. Additional format specifiers are supported, %[objects_protected]CQNp: space-separated list objects protected by this rolemap, optionally separated by comma (C), new-line (N), and optionally enclosed in quotes (Q), %[policy]Xp: a policy that this rolemap implements, optionally displayed in long format (X).
-out output-pname
Writes a text representation of the rolemap to the named file. The file contents are suitable for passing to mkrolemap -set.
-invob vob-selector
Lists rolemaps in the specified VOB.
-unsorted
Displays an unsorted list of rolemaps.

Specifying the rolemap

Default: all rolemaps in the VOB.

rolemap-selector
The rolemap that is to be listed.

Examples

The UNIX system and Linux 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 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 all rolemaps in the current VOB with the Developer role

    cmd-context  cleartool lsrolemap -principal Role:Developer

  • Displays all my effective ACLs for element.

    cmd-context  cleartool lsrolemap -me -kind element