SSRestor

See Also

SSRestor.exe restores information from a previously created archive.

Syntax

SSRESTOR [-pProject] [-l] [-t] [-s] [-o] [-i-] [-y] [-x] [-c] <archive file to restore> [files/projects]

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

Option Description
[-p] Specifies a project to restore into.
[-l] List.
[-la] List all
[-t] Test the archive file for corruption, but do nothing else.
[-s] Specifies a path to SRCSAFE.INI and the data directory.
[-o] Redirects output (standard VSS parameter).
[-i-] No input (standard VSS parameter).
[-y] Username,Password (standard VSS parameter).
[-x] Identifies which item to restore when the item has been deleted from the project.  -x means restore the deleted item.  For example, assume you have both a deleted and non-deleted $/a/b.  If you archive and delete $/a, you actually get three projects ($/a, $/a/b, and $/a/b) deleted.  What, therefore, does ssrestor $/a/b really mean?  If you don't specify -x, it means use the non-deleted $/a/b.  If you do specify -x, it means restore the deleted $/a/b.  Even though they have the same name, these are two different projects.
[-c] Specifies the comment applied to the history entry for the restored item(s).

The -p option specifies a project to restore into. For instance, if you archive off $/A/BAR.C and then restore it, it will be restored as $/A/BAR.C. Use the -p parameter only if you want to restore the file into a different project.

Note   If restoring attempts to create a duplicate file or project name, the restore fails.

The -l option specifies “don’t restore anything, just list what’s in this archive file.” Suppose you archived $/A into this archive file. If you use –l, it will simply tell you that $/A is there.  If you use –la, it will actually show you all the files and subprojects under $/A.  In general, -l only shows you the items you explicitly put into the file; -la shows you all the child projects and files.

The -t option is analogous to pkunzip -t. It says, “don’t actually restore this archive, just let me know whether it is corrupt.”

The -s option is described in detail under SSARC.EXE.

The –o and -i- options are standard VSS options.

As with SSARC, the -y option lets you specify the administrator’s password. For example:

-yAdmin,Moggy