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 [ -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.
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.
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 29 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

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