SymStore Command-Line Options

The following syntax forms are supported for SymStore transactions. The first parameter is add, query or del. Use /? to display the available options.

symstore add [/r] [/p [/l] [-:MSG Message] [-:REL] [-:NOREFS]] /f File /s Store /t Product [/v Version] [/o] [/c Comment] [/d LogFile] [/compress]

symstore add [/r] [/p [/l] [-:REL] [-:NOREFS]] /g Share /f File /x IndexFile [/a] [/o] [/d LogFile] 

symstore add /y IndexFile /g Share /s Store [/p [-:MSG Message] [-:REL] [-:NOREFS]] /t Product [/v Version] [/o] [/c Comment] [/d LogFile] [/compress]

symstore query [/r] /f File /s Store [/o] [/d LogFile]

symstore del /i ID /s Store [/o] [/d LogFile] 

symstore /? 

Parameters

/f File
Specifies the network path of files or directories to add.

/g Share
Specifies the server and share where the symbol files were originally stored. When used with /f, Share should be identical to the beginning of the File specifier. When used with /y, Share should be the location of the original symbol files (not the index file). This allows you to later change this portion of the file path in case you move the symbol files to a different server and share.

/s Store
Specifies the root directory for the symbol store.

/m Prefix
Causes SymStore to prefer using symbols from paths beginning with Prefix when storing files or updating pointers. This option cannot be used with the /x option.

/h { PUB | PRI }
Causes SymStore to prefer using public symbols (if PUB is specified), or private symbols (if PRI is specified) when storing or updating symbols. This option has no effect on binary files.

/i ID
Specifies the transaction ID string.

/p
Causes SymStore to store a pointer to the file, rather than the file itself.

/l
Allows the file specified by File to be in a local directory rather than a network path. (This option can only be used when both /f and /p are used.)

-:MSG Message
Adds the specified Message to each file. (This option can only be used when /p is used.)

-:REL
Allows the paths in the file pointers to be relative. This option implies the /l option. (This option can only be used when /p is used.)

-:NOREFS
Omits the creation of reference pointer files for the files and pointers being stored. This option is only valid during the initial creation of a symbol store if the store being changed was created with this option. (This option can only be used when /p is used.)

/r
Causes SymStore to add files or directories recursively.

/t Product
Specifies the name of the product.

/v Version
Specifies the version of the product.

/c Comment
Specifies a comment for the transaction.

/d LogFile
Specifies a log file to be used for command output. If this is not included, transaction information and other output is sent to stdout.

/o
Causes SymStore to display verbose output.

/x IndexFile
Causes SymStore not to store the actual symbol files. Instead, SymStore records information in the IndexFile that will enable SymStore to access the symbol files at a later time.

/a
Causes SymStore to append new indexing information to an existing index file. (This option is only used with the /x option.)

/y IndexFile
Causes SymStore to read the data from a file created with /x.

/yi IndexFile
Appends a comment with the transaction ID to the end of an index file created with the /x option.

/z { PUB | PRI }
Causes SymStore to index only the type of symbols specified. If PUB is specified, then only the symbols that have had the full source information stripped will be indexed. If PRI is specified, then only the symbols that contain the full source information will be indexed. SymStore will always index binary symbols.

/compress [CAB|ZIP]
Causes SymStore to create a compressed version of each file copied to the symbol store instead of using an uncompressed copy of the file. This option is only valid when storing files and not pointers, and consequently cannot be used when the /p option is used. Has two optional arguments "CAB" and "ZIP" to specify the compression type to use. Defaults to CAB compression if none is specified.

/?
Displays help text for the SymStore command.

Additional Information

For more information about SymStore, see Using Symbol Servers and Symbol Stores.