si addmemberfromarchive
adds a member from a server archive
Synopsis
si addmemberfromarchive [--archive=value] [--[no]createSubprojects] [--[no]defer] [--[no|confirm]includeFormers] [--include=file:pattern,dir:pattern...] [--exclude=file:pattern,dir:pattern...] [--cpid=ID|--changePackageId=ID] [--[no|confirm]closeCP] [--issueId=value] [--[no]failOnAmbiguousProject] [--devpath=value] [-P|--project=value] [-r|--revision=value] [-S|--sandbox=value] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-Ffile|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] nonmember...
Description
si addmemberfromarchive adds members from server archives.
The si addmemberfromarchive command can be used for the following:
• Add previously dropped members without requiring a Sandbox working file, while preserving the member history.
From the Sandbox directory, for example, and assuming the three specified members have just been mistakenly dropped, the following command will re-add them:
si addmemberfromarchive label.c button.c panel.c
• Add a member that shares the history of another existing member, where the source member can be located in another project from the added member.
From the Sandbox directory, for example, the following command will add a member named largeLabel.c that shares the history with all members already linked to the specified archive location.
si addmemberfromarchive --archive=/anotherproject/rcs/label.c largeLabel.c
|
|
Note the following about the command:
• can be deferred when performed from a Sandbox
• may be part of change package review (displayed as pending members in the project)
• supports multiple selection of archives using the wizard
|
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.
• --archive=value
a non-default archive location (the specified archive must exist on the server). To add several members with non-default archive locations in one operation, use the GUI wizard (si addmemberfromarchive -g ).
• -r=value
• --revision=value
specifies the revision at which the member is to be added. This must be an existing revision in the archive. By default, the member is added at the latest revision on the main branch.
• --[no]createSubprojects
controls whether to create subprojects for each subdirectory encountered when adding members. This option is commonly used where you anticipate working with a large directory structure, because multiple subprojects are easier to manage than many subdirectories within one project. For example, specifying:
si addmemberfromarchive --createSubprojects --description="Button Application" \buttons\activebutton.c
creates a subproject for the \buttons directory and adds the file activebutton.c. Without the --createSubprojects option, the file and its path simply would be added to the project in the current directory.
• --[no]defer
controls whether to delay the add member from archive operation in the project until the deferred operation is submitted. The operation in the Sandbox still takes place immediately.
If the change package reviews are mandatory, specify the --defer option to create a pending entry for this operation at the time of change package submission. If the --defer option is not specified, Integrity Lifecycle Manager creates the pending entry at the completion of this operation. When a deferred import member operation is submitted as part of a review, a pending member is created For more information, see the Integrity Lifecycle Manager Help Center.
• --[no|confirm]includeFormers
controls whether to include former members. Former members are members that have been dropped but whose working files still reside in the Sandbox directory.
• --exclude=file:pattern,dir:pattern...
• specifies a file that contains a glob pattern for excluding members.
• --include=file:pattern,dir:pattern...
specifies a file that contains a glob pattern for including members.
• --[no|confirm]closeCP
closes the change package after command completion.
• nonmember...
identifies non-members to add; use spaces to specify more than one non-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
