testipr(1)
testipr - test an Impressario printer
As shipped in IRIX 6.5.5. Unchanged since IRIX 6.5.
NAME testipr - test an Impressario printer SYNOPSIS testipr [-c all | className[,className,...]] [-t #[,#...]] [-p classPath] [-l logPathName] [-d] [-h] printerName DESCRIPTION testipr 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" 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. -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 ALSO testiconfig(1), impressario(1), X Window System by Gettys and Scheifler