TESTIPR(1) Impressario TESTIPR(1)NAMEtestipr - test an Impressario printer
SYNOPSIStestipr [-c all | className[,className,...]] [-t #[,#...]]
[-p classPath] [-l logPathName] [-d] [-h]
printerName
DESCRIPTIONtestipr tests an Impressario supported printer. When a printer is
supported by Impressario, it can print a wide range of file formats and
offers a large selection of printing options for each file format.
Testing each supported file format and each printing option is a daunting
task if done manually one test case at a time. The testipr program
automates the testing process by printing a set of standard test files
according to a standard test plan.
testipr is located in the directory /usr/impressario/tests/print.
Typically, the program is run from that directory. printerName is the
name of a printer installed on the system. It is recommended that the
printer be physically connected to the system on which testipr is run.
During testing, the printer should not be used by other users. It is the
responsibility of the user to ensure that both of these test conditions
are satisfied.
On startup testipr looks in the /usr/impressario/tests/print directory
for test configuration files. These files are identified by a .ipr suffix
and a basename corresponding to the test class name. There are three
standard configuration files: text.ipr, image.ipr and postscript.ipr.
These files comprise the text, image and postscript test classes
respectively. Each configuration file describes a set of tests to be run
by testipr. These files should not be modified. If you wish to create
your own test cases, you can copy the existing configuration files to a
new location, modify them to suit your needs and use the -p command line
option to tell testipr where to find the files.
The format of the configuration file follows that of the X Window System
resource file. For example:
! This is a comment in an example .ipr file
test.basePath: /usr/impressario/data
test.1.file: testfile.sgi
test.1.options: -rotate 90 -gamma 3.5
test.1.desc: "SGI Image File - rotated 90, gamma 3.5"
test.2.file: testfile.sgi
test.2.options: -rotate 90 -gamma 3.5
test.2.desc: "SGI Image File - rotated 90, gamma 3.5"
Page 1
TESTIPR(1) Impressario TESTIPR(1)
Each resource must start with the keyword test. basePath is an optional
resource that specifies a directory path. If it is specified, the path
will be prepended to each file resource. The file resource specifies a
test file to print. Typically, these test files will come from
/usr/impressario/test/data. The options resource specifies the actual -o
model file options to be used in the test. Note that the -o should not be
specified. The testipr program automatically prepends the nobanner option
to all option strings. The option string is passed as the argument to the
lp command's -o option. The desc resource provides a description of the
test. This string will be written to the test log file. Each test case
must be numbered consecutively starting with one.
The file specified in each test is submitted for printing using the
specified printing options. A log file is created called
/var/tmp/testipr.<printerName>.log. This log file contains general
information about the printer being tested and its host environment. The
log also contains a detailed list of all tests performed and their
corresponding spooling system print job IDs. A complete test record
consists of the printer output, the corresponding log file and the
/var/spool/lp/log file.
The testipr program provides the following command line options.
-c className[,className,...]
By default, testipr runs all tests for all test classes.
The -c option provides the ability to run specific test
classes. Multiple class names may be specified by
separating each with a comma and no whitespace. The
keyword all may be specified to indicate that all test
classes should be run; this is the default. To obtain a
list of available classes use the -h option.
-t #[,#,...] By default, testipr runs all tests in a given class. The
-t option may be used to run specific tests within a
class. Multiple test numbers may be specified by
separating with a comma and no whitespace. The test
numbers are applied to all test classes. If a given class
does not contain a test, a warning is printed to the log
file and testing continues.
-p classPath By default, testipr looks for test class configuration
files in the directory /usr/impressario/tests/print. The
-p option allows a different configuration directory to be
specified. A configuration directory can also be specified
using the IPR_CLASS_PATH environment variable. The -p
option takes precedence over the environment variable.
-l logPath By default, the testipr program creates the log file
/var/tmp/testipr.<printerName>.log. The -l option allows a
different log file pathname to be specified. Note that
the logPath specifies both the name and directory of the
log file.
Page 2
TESTIPR(1) Impressario TESTIPR(1)-d The testipr program produces a large amount of printer
output. The -d option allows the program to be run in a
dry-run mode. In dry-run mode no print jobs are submitted
but all other program operations are performed including
the creation of a log file. In dry-run mode a check is
also done to ensure that each test file can be read.
-h This option provides help for running the testipr program.
If the -h option is specified, the program displays a list
of all printers available on the system and all available
test classes.
WARNING
By default the testipr program produces a large quantity of printed
output. A large portion of this output is text. Use the -c and -t options
to reduce the amount of output when running testipr on printers that
primarily print image files.
FILES
/usr/impressario/tests/print/testipr Program file.
/usr/impressario/tests/print Default configuration file
directory.
/usr/impressario/tests/data Test file directory.
/var/tmp/testipr.<printerName>.log Default log file.
SEE ALSOtesticonfig(1), impressario(1), X Window System by Gettys and Scheifler
Page 3
