Directory (Command Line)

See Also

Shows a list of all the files and projects in the specified project, or in the current project. Available only from the command line.

Syntax

ss Dir project path [-C] [-D] [-E] [-F-] [-H] [-I-] [-N] [-O] [-R] [-V] [-Y] [-?]

Examples

Shows a directory of the project $/WORD:

ss Dir $/WORD

Shows a directory of the current project:

ss Dir

Equivalent to the MS-DOS dir command:

ss ls

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

Option Description
-D Display deleted files instead of nondeleted files.
-O Paginate or redirect the command output.
-R Recursively display an entire project list.
-E Display extended display, including check out information.
-V Display a directory of an earlier version of a project.
-C Display files and projects in columns.
-F- Display projects only; do not display files.
-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 Read access right to use this command.

Remarks

The Directory command in VSS functions very much like the MS-DOS dir command, and displays all the files and subprojects in a project. If a project is sharing a specific version of a file (rather than the most recent version), the version number of the file is shown. The Directory command sets the operating system exit code for use in batch files and scripts.

The -R option displays a recursive folder, that is, shows subprojects, the files and subprojects inside them, and so on.

The -D option displays all files and subprojects that have been deleted. This can be useful, for instance, for obtaining a list of files that you want to recover or purge.

The -E option displays check out information for any checked-out files. The Dir -E is similar to the Status command on the command line, with one notable difference: Status shows only checked-out files; Dir -E shows all files, but notes the check out status of the ones that are checked out.

The -F- option shows projects only, and does not show files ss Dir $/ -F -R creates a complete list of all the projects in the VSS database without listing any files.