AccuRev® Command-Line Reference : show

show
list objects of a particular kind
Usage
show [ -fx ] accuwork
show [ -fx ] depots
show [ -f<format> ] groups
show [ -fx ] locks
show [ -fx ] [ -g <group-name> ] members
show [ -f<format(s)> ] refs 9
show [ -fx ] sessions
show [ -f<format(s)> ] slices
show [ -f<format(s)> ] [ -p <depot> ] [ -d ] [ -t <time-spec> ]
[ -s <stream> [ -m[<match-type>] ] [ -r | -R | -1 ] ] streams
show [ -f<format(s)> ] [ -p <depot> ] [ -d ] [ -t <time-spec> ]
[ -l <list-file> [ -m[<match-type>] ] [ -r | -R | -1 ] ] streams
show [ -fx ] [ -p <depot> ] -s <depot> stream_rules
show [ -f<format(s)> ] [ -p <depot> ] triggers
show [ -f<format(s)> ] users
show [ -f<format(s)> ] [ -a ] wspaces
Description
The show command displays information about all objects of a particular type:
accuwork: Lists the depots in the repository that contain AccuWork issues. Displays the same information as depots.
depots: For each AccuRev depot, displays (Depot) the depot name, (Depot#) the depot number, and (Slice#) the slice number.
groups: For each group, displays (Group#) the group number and (Group) the group name.
locks: Displays a line for each stream lock, in this form:
{to|from|all} <stream-name> [ {except|only} for <user-or-group-name> ] [ <comment> ]
members (of groups): For each user who belongs to any group — or to the particular group specified with the -g option — displays (User) the user’s principal-name and (Group) the group name.
refs (reference trees): Similar to the wspaces display (see below). The Stream# value identifies the stream or snapshot that the reference tree is based on. The workspace type value (next-to-last number) is always 3.
sessions: Lists all the active login sessions for your AccuRev Server, indicating the IP address of the user’s client machine and the duration of the session (in minutes).
slices: For each AccuRev depot, displays (Slice#) the slice number, and (Location) the full pathname to the directory within the repository that stores the data for that depot.
streams: For each stream in the repository — or a subset of the streams specified by the -p, -s, -R, -r, -1, -d, -m, -l, and/or -t options — displays:
(Stream) the stream name
(Backing Stream) the name of the stream’s backing/parent stream
(Depot) the name of the depot to which the stream belongs
(Stream#) the stream number
(Dyn) a “Y” if the stream is dynamic
(Basis Time) the basis time, if any, for a dynamic stream
The listing includes all kinds of streams, including workspace streams, pass-through streams, and snapshots.
stream_rules: For the stream specified by the -p and -s options, lists the workflows and workflow rules associated with the stream that dictate:
By default, output is in XML format, regardless of whether or not the -fx option is used.
triggers: For each trigger created with the mktrig command, displays the type of trigger and the name or pathname of the trigger executable (script or program). Use the -p option to limit the listing to a particular depot’s triggers. Triggers that are enabled by creating a script at a well-known pathname (e.g. server_admin_trig) are not listed by this command.
users: For each user, displays (User#) the unique user-ID number and (User) the principal-name.
wspaces (workspaces): For each workspace that belongs to you — or for all workspaces in the repository — displays
(Workspace) the workspace name
(Storage) the full pathname to the workspace tree
(Host) the name of the machine where the workspace tree resides
(Stream#) the stream number of the workspace stream, and four additional items:
target level and update level: The target level indicates how up-to-date the workspace should be; the update level indicates how up-to-date the workspace actually is. Usually, these two levels are the same. See Update Level and Scan Threshold in the update reference page.
workspace type: One of the following: 1 (standard workspace), 9 (exclusive-file locking), 17 (anchor-required).
Text-file EOL type: One of the following: 0 (platform-appropriate), 1 (UNIX/Linux style: NL), 2 (Windows style: CR-LF)
Options
-1
(“dash-one”) Also lists the immediate children of the specified stream(s) when you use show streams with the -s or -l option.
-a
Display all workspaces. By default, show displays only workspaces that belong to you (i.e. to your principal-name).
-d
Restrict the display to streams with non-empty default groups.
-f <format(s)>
Use one or more of the following format letters:
-i: Include deactivated (removed) items in the listing.
-I: Include deactivated (removed) items, and include old definitions of all items. Cannot be used with the -d option, nor with the -1, -m, -r, or -R options in show streams.
-v: Add a Kind column to show users output, indicating whether the user is licensed for use of “full” (both configuration management and issue management) or “dispatch” (issue management only).
-x: Display the results in XML format.
-xg: (valid for show streams) Display the results in XML format. This variant includes the hasDefaultGroup attribute, which indicates whether each stream has a default group. Requires the -p option.
-g <group-name>
Restrict a member listing to the specified group.
-l <list-file>
Process the streams listed in the specified file (or streams matching the stream patterns in the file if using the -m option). The file must be text only, containing one stream name or number per line. This option can also be used with one of -1 (“dash-one”), -r, or -R. You cannot also specify streams using the -s option.
-m<match-type>
Indicates how the character string(s) specified with -s or -l are to be used in selecting streams to be listed. You can use any one of the following “match types”:
-mx: (default, if -m not specified) Selects a stream if its name exactly matches the string specified with -s or any of the strings in the list-file specified with -l.
-mc: Like -mx, but a specified string can occur anywhere within a stream name.
-me: Like -mx, but a specified string must match the end of a stream name.
-ms: Like -mx, but a specified string must match the start of a stream name.
With -mx or no -m option, matches are made with both active and removed streams; with all other -m options, matches are made only with active streams, unless you also specify the -fi option.
-p <depot>
Restrict a stream or trigger listing to the specified depot. The depot can be specified by name or number.
-r
Also list the stream path and all children of the selected stream(s). Must be used in combination with the -s or -l option.
-R
Also list all children of the selected stream(s). Must be used in combination with the -s or -l option.
-s <stream>  or  -s <stream-pattern>

(show streams only) Restrict the scope to the specified stream — or streams matching the stream pattern that you specify with -m. You can use -1 (“dash-one”), -r, or -R along with this option. The stream can be specified by name or number. If you specify a stream by number, you must also specify a depot with the -p option.
(show stream_rules only) Restrict the scope to the specified stream. The stream can be specified by name or number. If you specify a stream by number, you must also specify a depot with the -p option.
In either case, if you use -s, you cannot also specify a list of streams (or stream-patterns) using the -l option.
-t <time-spec>
Show the streams that existed at the specified time. You must also use one of the -l, -s, or -p options. Note that a renamed stream may appear under its new or old name, depending on the <time-spec> you specify.
A time-spec can be any of the following:
Time in <YYYY/MM/DD HH:MM:SS> format: e.g. 2004/06/07 20:27:15.
Note that you might need to use quotes in composing the argument following -t; the entire argument must be interpreted by the command shell as a single token.
When using the –t option, take into account the possibility of a timewarp. The AC_SYNC environment variable (see AccuRev User Preferences on page 6) determines how a timewarp will be handled. See also section System Clock Synchronization on page 31 of the AccuRev Administrator’s Guide.
Examples
Display the names of all depots in the repository:
> accurev show depots
Display the principal-names of all AccuRev users:
> accurev show users
Display the names of all streams in depot gizmo:
> accurev show -p gizmo streams
Display the names of the streams that existed in depot gizmo at the time of transaction 248:
> accurev show -p gizmo -t 248 streams
Display the name of the stream renamed_stream (renamed in transaction 100) at the time of transaction number 50:
> accurev show -t 50 -s renamed_stream streams
Display the stream path and all children for stream devt_brass in depot gizmo:
> accurev show -p gizmo -s devt_brass -r streams
Display the workflow rules for stream devt_brass in depot gizmo:
> accurev show -fx -p gizmo -s devt_brass stream_rules
<?xml version="1.0" encoding="utf-8"?>
<AcResponse
Command="show stream_rules">
<Stream
Name="devt_brass"
allow_incomplete_issues="yes">
<EntryRules>
<Workflows>
<Workflow
Name="defects"
restrict_stages="no">
<Transitions>
<Transition
from_stage="WIP"
to_stage="New"/>
<Transition
from_stage="Dev Complete"
to_stage="Deferred"/>
</Transitions>
</Workflow>
<Workflow
Name="workflow_check_conditions"
restrict_stages="no">
<Transitions>
<Transition
from_stage="New"
to_stage="Scheduled"/>
<Transition
from_stage="Scheduled"
to_stage="WIP"/>
<Transition
from_stage="WIP"
to_stage="Dev Complete"/>
</Transitions>
</Workflow>
</Workflows>
</EntryRules>
<ExitRules>
<Workflows>
<Workflow
Name="enhancements"
restrict_stages="no">
<Transitions>
<Transition
from_stage="Deferred"
to_stage="Closed"/>
<Transition
from_stage="Dev Complete"
to_stage="Deferred"/>
</Transitions>
</Workflow>
</Workflows>
</ExitRules>
</Stream>
</AcResponse>

AccuRev, Inc.
Phone: 781-861-8700
Fax: 781-861-8704
support@accurev.com