Get (Command Line)

See Also

Retrieves a read-only copy of the specified VSS file(s).

Syntax

ss Get VSS items [-G] [-H] [-I-] [-N] [-O] [-R] [-V] [-W] [-Y] [-?]

Examples

Retrieves a read-only copy of the file TEST.C in the current project:

ss Get TEST.C

Retrieves read-only copies of all the files in the current project:

ss Get *

Retrieves read-only copies of all the files in the project $/WORD, and all its subprojects:

ss Get $/WORD -R

The following table describes the command-line options available with this command.

Option Description
-O Paginate or redirect the command output.
-R Recursively get an entire project list.
-V Get an old file or project version.
-G Set options for the retrieved local copy.
-W Make the retrieved local copy writable.
-I- Ignore: Do not ask for input under any circumstances.
-N Change between long and short file name mode.
-Y Specify a username and/or password.
-?, -H Request online Help on a command.

Access Rights

You must have the Read access right to use this command.

Remarks

The Get Latest Version command places files into your working folder. Used recursively on a project (the -R option), VSS gets all the files in the project and subprojects, and places them into subfolders of the same name. If you set the SS.INI variable Force_Dir to Yes, subprojects go into their respective working folders instead of into subfolders of the same name.

By default, Get Latest Version retrieves the most recent version of the files or projects you specify. However, you can get earlier versions as well by using the -V option. (Note that "ss Get -V*" does not work.)

Note   Getting an earlier version of a project gets the files that were in the project at a particular time, as they were at that time. For instance, if you use the Get Latest Version command to retrieve version 7 of the project $/WORD, you may get TEST.C version 3, HELP.C version 10, and TEST.H version 5.