VSD Command-Line Syntax

Previous chapter

This section presents the formal command syntax and the available command-line options.

vsd [ -b color ] [ -A | --a | -u ] [ dir ] [ file+ ]

vsd -h | -v

-a

Open and append (as if they were one file) one or more files listed on the command line.

-A

Open and append (as if they were one file) one or more files listed on the command line. In addition, enable continuous appending with auto-append mode.

-color

Set the master background color. Color may be a hex RGB value (e.g.: #d3d3ff) or a valid color name (e.g.: white). The list of recognized color names may be found at: http://www.tcl.tk/man/tcl8.6/TkCmd/colors.htm

-h

Displays a usage line and exits.

-u

Open one or more files as separate files. In addition, enable continuous appending with auto-append mode

-v

Print version information and exit.

dir is the name of a directory; VSD will set this as the working directory for the executable, and after startup, opens the Open Statmonitor File dialog on this directory.

file is the name of a statmonitor file to be loaded as part of startup. If the -a or -A argument is specified, multiple files will be appended, otherwise, they will be loaded separately.

Order of Loading Multiple Files

Note that if you are loading multiple files using a wild card *, these files will be loaded in the operating system sort order.

By escaping the command line *, VSD can sort the files from oldest to newest, and load in that order.

For example, to load and append a set of files and allow auto-append of new files:

vsd -A $GEMSTONE/statmons/\*.gz

On windows, you can escape the path separator using the caret, for example:

vsd -a C:\statmons\stat^*.gz

Previous chapter