get
Copies a specified version of a
file element into a snapshot view
DESCRIPTION
Use the get command to copy
a specified version of a file element into your snapshot view. You must issue
the get command from the root directory of a snapshot view
or any directory below it.
You can use this command as follows:
- To read
versions of file elements that are not selected by the view's config spec,
either because the element is not specified by a load rule or because you
want to see a version of a loaded element other than the one currently in
the view. You cannot perform ClearCase or ClearCase LT operations on
these nonloaded versions copied into your view with the get command.
- To get
an updated copy of a version currently loaded in your view.
The get command copies only
file elements into a view.
OPTIONS AND ARGUMENTS
Specifying the Destination File Name
- Default
- None.
- dest-pname
- Specifies a pathname for the version. If you
do not specify a directory name, the file is copied into the current directory.
By requiring a destination pathname, the get command is
prevented from overwriting any version already loaded into your view.
Specifying the File to Copy
- Default
- None.
- pname
- Specifies the version of the file element to
copy into the view. Use a version-extended pathname to copy a version other
than the one currently loaded in the view. Specifying a pathname that contains
a symbolic link causes the link target to be downloaded.
EXAMPLES
The UNIX examples in this section are written for use in csh.
If you use another shell, you may need to use different quoting and escaping
conventions.
The Windows examples that include wildcards or quoting are written for
use in cleartool interactive mode. If you use cleartool single-command
mode, you may need to change the wildcards and quoting to make your command
interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents
the UNIX shell or Windows command interpreter prompt, followed by the cleartool command.
In cleartool interactive mode, cmd-context represents
the interactive cleartool prompt.
- Copy the
version loaded in the view into the current directory.
- Copy /dev/hello_world/foo.c@@/main/2 into
the current directory.
- Copy \dev\hello_world\foo.c@@\main\2 into
the C:\build directory.