get

Copies a specified version of a file element into a snapshot view

APPLICABILITY

ProductCommand type
ClearCasecleartool subcommand
ClearCase LTcleartool subcommand

Platform
UNIX
Windows

SYNOPSIS

get –to dest-pname pname

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.

RESTRICTIONS

None.

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.

    cmd-context get –to foo.c.temp foo.c 

  • Copy /dev/hello_world/foo.c@@/main/2 into the current directory.

    cmd-context get –to foo.c.temp /dev/hello_world/foo.c@@/main/2 

  • Copy \dev\hello_world\foo.c@@\main\2 into the C:\build directory.

    cmd-context get –to C:\build\foo.c.temp \dev\hello_world\foo.c@@\main\2

SEE ALSO

checkin, checkout, config_spec, update, version_selector



Copyright© 2003 Rational Software. All Rights Reserved.