NAME

usat − ULTRIX-11 System Acceptance Test

SYNTAX

usat [ help ] [ key... ]

DESCRIPTION

The usat facility tests and verifies the existence and correct operation of various ULTRIX-11 commands.  Without an argument, usat lists the names of the tests which are available. 

The usat facility runs each specified command using a test input file.  After executing the command, it compares the output with a file containing the known, correct result.  Files used for each test are located in /usr/lib/usat/test, where “test” is the command name directory. 

Multiple copies of usat may be run in the same directory without fear of collisions.  Two exceptions, however, are running simultaneous “yacc” tests, or simultaneous “misc” tests in the same directory.  Because common output files are generated, usat cannot guarantee consistent results in these two cases. 

KEYS

a Runs awk test. 

b Runs bc and dc test. 

c Runs cc test. 

d Runs doc preparation test. 

f Runs f77 test. 

h Displays brief explanations of each test. 

l Runs lint test. 

m Tests miscellaneous user commands. 

p Runs Pascal test. 

r Runs learn test. 

s Runs sed test. 

x Runs lex test. 

y Runs yacc test. 

z Displays system statistics: who, ps, pstat, memstat, bufstat, iostat, df commands. 

all Runs all of the above tests. 

EXAMPLE

The following example runs the C compiler test, the awk test, and finally, the lint test. 

usat c a l

A short C program found in /usr/lib/usat/cc/cc.in.c is used to generate a table of temperatures. The input file “cc.in.c” is compiled and executed. This output is then compared with the known, correct output found in cc.sout. The “.sout” filename notation represents a (s)aved (out)put file. If the output files fail to compare, then the cc test is considered to have failed, and a warning message is printed. The awk test and lint tests work similar to the cc test as described above.

FILES

/usr/bin/usat
/usr/lib/usat/*/*
/tmp/???

SEE ALSO

usep(8)
ULTRIX-11 System Management Guide