Load components from a repository workspace into a local
workspace.
Purpose
The scm load subcommand
loads the components in a repository workspace into a local workspace.
The local workspace is created if it does not exist.
Synopsis
- To run scm load after you have used scm login to
create stored credentials:
scm load workspace [ -r
| --repository-uri ] repository URI or nickname
[ -d | --dir ] workspace-path { [ -q | --quiet ] [ -f | --force ] }
- To run scm load and supply credentials on the
command line:
scm load workspace [ -r | --repository-uri ] repository URI [ -u | --username ] user ID in repository [ -P | --password ] password for user ID in repository [ -d | --dir ] workspace-path { [ -q | --quiet ] [ -f | --force ] }
Options and arguments
- workspace
- The name, alias, or UUID of the repository workspace to load.
- [ --all ]
- Selects all components. Priority is given
to explicitely selected components in the case of a conflict.
- [ -d | --dir ] workspace-path
- Files and folders from the specified workspace will
be loaded into this path name. The path name is created if it does
not already exist. If this option is omitted, scm load creates
a new local folder as a subdirectory of the current working directory.
The new folder has the name of the specified workspace.
- [ -f | --force ]
- Overwrite existing files when loading.
- [ -i
| --include-root ]
- Load component roots as directories
in the filesystem.
- [ -L | --local-rules ] Load
rule path
- Load rule path specifies the path name of the
load rules file for a component in the local workspace. Not valid
when more than one component is specified.
- [ -P | --password ] password for user ID in repository
- The password for the specified user ID in
the named repository. If this option is not included on the command
line, you are prompted for a password. If you specified a repository
URI or nickname for which you have stored credentials using the scm
login command, this option is ignored.
- [ -q | --quiet ]
- Suppress most informational messages while
operating.
- [ -R | --remote-rules ] Load
rule path
- Load rule path specifies the path name of the
load rules file for a component in the repository workspace. Not valid
when more than one component is specified.
- [ -r | --repository-uri ] repository URI
- Specifies the repository in which to take
this action. If you have stored repository credentials using the scm
login command, you can use the nickname you supplied for
these stored credentials
- [ -t
| --target ] arg
- Optional local path where changes should
be loaded.
- [ -u | --username ] user ID in repository
- Specifies a user ID that exists in the named
repository. If you specified a repository URI or nickname for which
you have stored credentials using the scm login command,
this option is ignored.
- component...
- A space-separated list of components to load. Specify components
by name, alias, or UUID. If this option is omitted, all components
in the specified workspace are loaded.
Examples
Load the entire contents of repository
workspace named HelloJazz, using stored credentials for the repository
nicknamed jazzhost, into a new subdirectory of
C:\local-workspaces:
C:\local-workspaces> scm load -r jazzhost HelloJazz
Downloading /com.example.hellojazz.rcp.ui/.project (689 B)
Downloading /com.example.hellojazz.rcp.ui/build.properties (109 B)
Downloading /com.example.hellojazz.service/plugin.xml (529 B)
Downloading /com.example.hellojazz.service/.project (690 B)
Downloading /com.example.hellojazz.service/build.properties (109 B)
Downloading /com.example.hellojazz.client.tests/TestHelloJazz.launch (2.6 KB)
Downloading /com.example.hellojazz.rcp.ui/.classpath (307 B)
Downloading /com.example.hellojazz.rcp.ui/HelloJazzClient.launch (1.7 KB)