si archiveinfo
displays information about an archive
Synopsis
si archiveinfo [--[no]labels] [--[no]locks] [(-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]] member...
Description
si archiveinfo displays global information about an archive. For example,
si archiveinfo --locks --lockrecordformat={locker} c:/Documentation/Man_Pages/xml_man/si_add.1.xml
The command does not contain any per-revision information. For example:
Member Name: c:\Documentation\Man_Pages\xml_man\si_add.1.xml
Sandbox Name: c:\Documentation\Man_Pages\project.pj
Archive Name: \rd\doc\Man_Pages\xml_man\rcs\si_add.1.xml
Archive Type: Text
Shared
Exclusive Lock Mandatory
Archive Description:
Labels:
TechReview1 1.7
PeerReview_1 1.6
|
|
Shared displays only if other members share the archive and you are using the database repository.
|
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]labels
controls whether to show labels and associated revision IDs.
• --[no]locks
controls whether to show locks and associated revision IDs.
• --lockRecordFormat=value
defines the format for displaying lock information for the archive. 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.
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:
