vet(8) — Maintenance
NAME
vet − Starts a DEC Verifier and Exerciser Tool(VET) session.
SYNOPSIS
/usr/sbin/vet [−d device-list] [−F] [−f scriptfile] [−g group-list] /usr/sbin/vet [−p passcount] [−r runtime] [−s] [−nw] [−display] [−h] /usr/sbin/vet [−[no]sizer]
DESCRIPTION
The DEC Verifier and Exerciser Tool (DEC VET) is a state-of-the-art installation verification procedure (IVP) and system exerciser. It has a set of generic exercisers designed to ensure the proper installation of hardware and base operating system software. DEC VET supports various exerciser configurations, ranging from a single device exerciser to full system loading.
Prior to invoking VET you need to set up the VET database by running the /usr/sbin/vetsetup script file.
If the −d flag is specified, DEC VET tests the specified devices, then exits. If the −f or −F flags are specified, DEC VET runs the specified script file and exits. Otherwise, DEC VET prompts for user commands.
To run DEC VET in distributed mode (that is, having DEC VET on one system control DEC VET on other systems), DEC VET must be installed on all systems and you must specify distributed support setup on all systems, when you run /usr/sbin/vetsetup. Each system must be running TCP/IP and contain knowledge of the other systems via BIND or the /etc/hosts file. See the DEC Verifier and Exerciser Tool User’s Guide for more information on system setup and distributed mode operation.
Depending on your session environment setup, DEC VET either enters command mode or displays its main window using DECwindows Motif. You can also control how DEC VET is initialized with command-line flags. See the DEC Verifier and Exerciser Tool User’s Guide for descriptions of the DEC VET user commands.
FLAGS
−nwInvokes DEC VET in command mode.
−display dispname
Specifies the display screen on which DEC VET displays its windows. If the display option is not specified, DEC VET uses the display screen specified by your DISPLAY environment variable. The dispname argument has the format hostname:number.
−d device-list
Specifies the devices to be tested. DEC VET tests the devices and then exits. The device-list argument is a list of one or more devices. A blank character (space) must separate items in the list and a multi-item list must be delimited by quotation marks.
Device names have a combination of letters and numbers, for example, rrz1c and rmt0h, and include the path name to the device, such as /dev/rrz1c.
If you enter "all" for device-list, DEC VET acts on all devices. You issue the show devices all command when running DEC VET in command mode to find the names of devices connected to your system.
−f scriptfile
Specifies a script file containing commands to be executed by DEC VET. DEC VET executes the commands in the script and then exits.
−FSpecifies the default script file (vet_script.com) to be executed by DEC VET. DEC VET executes the commands in the script and then exits.
−g group-list
Specifies the test groups to run on the devices specified with the −d flag. Each group has a name that can consist of letters, numbers, and the underscore character, for example, memexer_2.
The group-list argument is a list of one or more groups. A blank character (space) must separate items in the list and a multi-item list must be delimited with quotation marks.
Issue the show groups all for all command when running DEC VET in command mode to display the names of all test groups. If this flag is absent, the default group is executed.
−hDisplays the vet usage message.
−p passcount
Runs the test groups for the number of passes specified in pass count. If this option is absent, the test groups run for a default pass count of 1 or the specified run time, whichever completes first. Used only if −d, −f, or −F is specified.
−r runtime
Specifies the amount of time for which the test groups run. If absent, the test groups run for the specified pass count. Used only if −d, −f, or −F is specified.
The runtime argument can take the following forms: mm, hh:mm, or hh:mm:ss, where hh is a whole number indicating the hours, mm is a whole number indicating the minutes, and ss is a whole number indicating the seconds.
If you specify one number without the delimiter (:), DEC VET interprets the argument as minutes. There is no practical limit to number. If you specify 4:344:97987 as a time, DEC VET interprets the argument correctly.
−sSpecifies that DEC VET display a run summary after the run has completed.
−[no]sizer
Specifies that DEC VET does not run or does run the sizer when it starts. If the sizer is not run, you must connect the devices to be tested before any tests can be run. By default, the sizer runs unless −nosizer is specified.
X Defaults
The DEC VET application uses the values in the .Xdefaults file when you logged in and uses the appropriate resource specification to customize the appearance or characteristics of its displayed DEC VET windows. The format for a resource specification in the .Xdefaults file is: [name.]resource: value
nameSpecifies the application name or the name string that restricts the resource assignment to that application or to a component of an application. If this argument is not specified, the resource assignment is globally available to all X applications.
resourceSpecifies the X resource.
valueSpecifies the value that is to be assigned to the resource.
In most cases, the period (.) delimiter should be replaced by an asterisk (∗). For more information, see X(1X).
Because each toolkit-based application can consist of a combination of widgets (for example, push buttons and a scroll bar), you can form the name string by adding widget class and name identifiers to the string.
For DEC VET, the following application class names are supported:
VetDEC VET Main window and its dialogs
Vet_run
DEC VET Run window
Vet_summary
DEC VET Summary window
DEC VET supports the general resources listed in X(1X). For example, to set the foreground and background colors for the DEC VET Main window, add the following two entries to your .Xdefaults file:
Vet∗background: lightblue
Vet∗foreground: navyblue
RESTRICTIONS
You must invoke /usr/sbin/vetsetup to set up the proper databases before issuing the shell-level vet command.
You cannot use -display in conjunction with −d, −f, or −F.
EXAMPLES
1.The following example illustrates issuing a vet command with display options. When the user issues the vet command with the −nw flag, DEC VET starts a new session in command mode. The user terminates the DEC VET session, and control returns to the operating system.
csh> vet -nw
VET_setup>
.
.
.
VET_setup> exit
csh>
2.The following example illustrates issuing the vet command to exercise tape drives /dev/rmt0h and /dev/rmt2h using the default test group; the user specifies that the run will last for 30 passes or 15 minutes, whichever completes first. Once the run has completed, DEC VET returns control to the operating system.
csh> vet -d "/dev/rmt0h /dev/rmt2h" -p 30 -r 15
...testing completed. Total errors = 0.
csh>
RETURN VALUES
DEC VET returns the number of errors encountered during the run as the exit status.
FILES
/usr/lib/x11/app-defaults/Vet
/usr/sbin/vetsetup