1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
3 <!-- SECTION: Specifications -->
5 <TITLE>CUPS Software Test Plan
</TITLE>
6 <LINK REL=
"STYLESHEET" TYPE=
"text/css" HREF=
"../cups-printable.css">
10 <H1 CLASS=
"title">CUPS Software Test Plan
</H1>
12 <P>This software test plan provides detailed tests that are used
13 to evaluate the stability and compliance of CUPS.
</P>
16 <H2 CLASS=
"title"><A NAME=
"PROCEDURE">Test Procedure
</A></H2>
18 <P>The test software and data files are located in the
19 <VAR>test
</VAR> subdirectory of the source distribution. A script
20 is provided to compile the
<CODE>ipptool
</CODE> program and run
21 all of the tests that follow, producing a success/fail
24 <P>The
<CODE>test
</CODE> target of the top-level makefile can be
25 used to run this script:
</P>
31 <P>or you can run the test script directly:
</P>
38 <P>A Software Test Report is stored in a HTML file in the
39 <VAR>test
</VAR> subdirectory at the conclusion of the test.
</P>
42 <H2 CLASS=
"title"><A NAME=
"IPP">IPP Compliance Tests
</A></H2>
44 <P>This section describes the tests used to validate the IPP
45 standards compliance of the CUPS server.
</P>
47 <H3>Request Tests
</H3>
49 <P>These tests verify that the CUPS scheduler only accepts valid
50 IPP requests that start with the
<CODE>attributes-charset
</CODE>
51 and
<CODE>attributes-natural-language
</CODE> attributes and also
52 contain a
<CODE>printer-uri
</CODE> or
<CODE>job-uri
</CODE>
55 <P>It also verifies that the CUPS scheduler always responds with
56 <CODE>attributes-charset
</CODE> and
57 <CODE>attributes-natural-language
</CODE> attributes, using
58 default values if they are not provided by the client.
</P>
60 <H3>CUPS Printer Operation Tests
</H3>
62 <P>These tests verify that the CUPS printer operations are
63 supported and function properly. Two printers called
64 <CODE>Test1
</CODE> and
<CODE>Test2
</CODE> are created, one as a
65 PostScript printer and one as a raster printer.
</P>
67 <H3>Job Operation Tests
</H3>
69 <P>These test verify that the CUPS scheduler accepts print jobs
70 for all supported file formats and that the
71 <CODE>cancel-job
</CODE>,
<CODE>hold-job
</CODE>, and
72 <CODE>resume-job
</CODE> operations work.
</P>
74 <H3>Subscription Operation Tests
</H3>
76 <P>These test verify that the CUPS scheduler accepts
77 subscriptions with print jobs and that all subscription
78 operations work as required by the IPP notification and mailto
82 <H2 CLASS=
"title"><A NAME=
"COMMAND">Command Tests
</A></H2>
84 <P>This section describes the tests used to validate the Berkeley
85 and System V commands included with CUPS.
</P>
89 <P>This test verifies that printers can be added, modified, and
90 defaulted using the
<CODE>lpadmin
</CODE> command.
</P>
94 <P>This test verifies that the
<CODE>lpc
</CODE> command can show
95 the current status of all print queues.
</P>
99 <P>This test verifies that the
<CODE>lpq
</CODE> command lists
100 any jobs in the queue.
</P>
104 <P>This test verifies that the
<CODE>lpstat
</CODE> command works
105 with all reports using the
"<CODE>-t</CODE>" option.
</P>
109 <P>This test verifies that the
<CODE>lp
</CODE> command works with
110 both the default destination and a specific destination.
</P>
114 <P>This test verifies that the
<CODE>lpr
</CODE> command works
115 with both the default destination and a specific destination.
</P>
119 <P>This test verifies that the
<CODE>lprm
</CODE> command can
120 properly cancel a job.
</P>
124 <P>This test verifies that the
<CODE>cancel
</CODE> command can
125 properly cancel a job or all jobs.
</P>
129 <P>This test verifies that the
<CODE>lpinfo
</CODE> command
130 returns a list of available printer drivers and devices.
</P>