si revisioninfo
displays revision information
Synopsis
si revisioninfo [--[no]changePackage] [--[no]labels] [(-r rev|--revision=rev)] [(-P project|--project=project)] [(-S sandbox|--sandbox=sandbox)] [--[no]failOnAmbiguousProject] [--lockRecordFormat=value] [--devpath=path] [--projectRevision=rev] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] [--[no]locate] member...
Description
si revisioninfo displays revision information for a member, for example:
si revisioninfo c:\Documentation\Man_Pages\xml_man\si_add.1.xml
displays
Member Name: c:\Documentation\Man_Pages\xml_man\si_add.1.xml
Sandbox Name: c:\Documentation\Man_Pages\project.pj
Revision: 1.7
Created By: pmolinas on Dec 21, 2012 - 11:00 AM
State: state_a
Revision Description:
Updated for Technical Review
Has Checksum: Yes
Labels:
TechReview1
Change Package:
ID: 1:1
Member Revision:
In project C:\Aurora_Program\Documentation\project.pj, this revision
is member revision on:
development path:Service Pack 1
Options
This command takes the universal options available to all
si commands, as well as some general options. See the
options reference page for descriptions.
• --[no]changePackage
controls whether to display change package information (applies only when change packages are enabled).
• --[no]labels
controls whether to display member labels.
• --[no]locate
controls whether to display the project and development path that the member is a member revision in.
|
|
If a revision is member revision in a shared subproject, only the original (canonical) project path displays. Any projects where the subproject was added as shared do not display.
|
Only projects that you have the OpenProject permission for display.
• --lockRecordFormat=value
defines the format for displaying lock information for the revision. Specify a format string using keywords to represent the information you want to display. You can specify any of the following keywords:
◦ {revision}
displays the revision that is locked.
◦ {locker}
displays the user who locked the revision.
◦ {locktype}
displays the type of lock on the revision (exclusive or non-exclusive).
◦ {locktimestamp}
displays the time when the revision was locked.
◦ {lockcpid}
displays the change package associated with the lock on the revision.
◦ {project}
displays the name and path of the project where the member revision was locked from. If the member revision was locked from a shared subproject, it is the subproject name and path that are displayed.
◦ {devpath}
displays the name of the development path where the lock on the revision was made from.
◦ {sandbox}
displays the name of the Sandbox where the lock on the revision was made. This is relevant when viewing the information from the locker host.
◦ {hostname}
displays the hostname of the computer that locked the the revision.
◦ {hascpid}
◦ displays 1 if the lock has a change package associated with it, 0 if there is no associated change package.
◦ {hassandbox}
displays 1 if there is Sandbox information available for the lock, 0 if no Sandbox information is available.
◦ {hasdevpath}
displays 1 if the lock was made from a development path, 0 if it wasn't.
◦ {member}
displays the name of the locked revision.
• member...
identifies a specific member; use spaces to specify more than one member.
Diagnostics
See the
diagnostics reference page for possible exit status values.
Preferences
Using
si setprefs or
si viewprefs, you are able to set or view the preference keys for this command.
See Also
• Commands:
• Miscellaneous:
