Locate (Command Line)

See Also

Searches through VSS projects for file or project names. Available only from the command line. In the Explorer, you can use the Search Wildcard Search command to get equivalent information.

Syntax

ss Locate filename [-H] [-I-] [-N] [-O] [-Y] [-?]

Examples

Looks for files called TEST.C:

ss Locate TEST.C

Looks for file names that match the wildcard mask *.old:

ss Locate *.OLD

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

Option Description
-O Paginate or redirect the command output.
-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

This command locates only files in projects for which you have the Read access right.

Remarks

The Locate command searches through the entire VSS project hierarchy for a file name you specify, and displays the project path to any matches it finds. In many respects, the results are similar to the results on the Links tab. For instance, if several projects share the file TEST.C, both commands give you a list of all those projects. However, if a project contains a file that is unrelated to the file TEST.C in your project, but has the same name, Locate finds the file; Links ignores it.

You can also use Locate to find a file when you do not know any of the projects it is in, whereas the Links tab requires that you start with one specific file.