]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | <HTML> |
2 | <HEAD> | |
3 | <META NAME="Description" CONTENT="Common UNIX Printing System Software Test Plan"> | |
4 | <META NAME="COPYRIGHT" CONTENT="Copyright 1997-2003, All Rights Reserved"> | |
5 | <META NAME="DOCNUMBER" CONTENT="CUPS-STP-1.2"> | |
6 | <META NAME="Author" CONTENT="Easy Software Products"> | |
7 | <TITLE>CUPS Software Test Plan</TITLE> | |
8 | </HEAD> | |
9 | <BODY> | |
10 | ||
11 | <H1>Scope</H1> | |
12 | ||
13 | <H2>Identification</H2> | |
14 | ||
15 | <P>This software test plan provides detailed tests that are used | |
16 | to evaluate the stability and compliance of the Common UNIX | |
17 | Printing System ("CUPS") Version 1.2. | |
18 | ||
19 | <EMBED SRC="system-overview.shtml"> | |
20 | ||
21 | <H2>Document Overview</H2> | |
22 | ||
23 | <P>This software test plan is organized into the following sections: | |
24 | ||
25 | <UL> | |
26 | <LI>1 - Scope</LI> | |
27 | <LI>2 - References</LI> | |
28 | <LI>3 - Test Procedure</LI> | |
29 | <LI>4 - IPP Compliance Tests</LI> | |
30 | <LI>5 - Command Tests</LI> | |
31 | <LI>A - Glossary</LI> | |
32 | </UL> | |
33 | ||
34 | <EMBED SRC="references.shtml"> | |
35 | ||
36 | <H1>Test Procedure</H1> | |
37 | ||
38 | <P>The test software and data files are located in the <VAR>test</VAR> | |
39 | subdirectory of the source distribution. A script is provided to compile | |
40 | the <CODE>ipptest</CODE> program and run all of the tests that follow, | |
41 | producing a success/fail report. | |
42 | ||
43 | <P>The <CODE>test</CODE> target of the top-level makefile can be used to | |
44 | run this script: | |
45 | ||
46 | <UL><PRE> | |
47 | make test | |
48 | </PRE></UL> | |
49 | ||
50 | <P>or you can run the test script directly: | |
51 | ||
52 | <UL><PRE> | |
53 | cd test | |
54 | ./run-stp-tests | |
55 | </PRE></UL> | |
56 | ||
57 | <P>A Software Test Report is stored in HTML and PDF files that | |
58 | are generated using the | |
59 | <A HREF="http://www.easysw.com/htmldoc">HTMLDOC</A> software. | |
60 | ||
61 | <H1>IPP Compliance Tests</H1> | |
62 | ||
63 | <P>This section describes the tests used to validate the IPP | |
64 | standards compliance of the CUPS server. | |
65 | ||
66 | <H2>Request Tests</H2> | |
67 | ||
68 | <P>These tests verify that the CUPS scheduler only accepts valid | |
69 | IPP requests that start with the <CODE>attributes-charset</CODE> | |
70 | and <CODE>attributes-natural-language</CODE> attributes and also | |
71 | contain a <CODE>printer-uri</CODE> or <CODE>job-uri</CODE> attribute. | |
72 | ||
73 | <P>It also verifies that the CUPS scheduler always responds with | |
74 | <CODE>attributes-charset</CODE> and | |
75 | <CODE>attributes-natural-language</CODE> attributes, using | |
76 | default values if they are not provided by the client. | |
77 | ||
78 | <H2>CUPS Printer Operation Tests</H2> | |
79 | ||
80 | <P>These tests verify that the CUPS printer operations are supported | |
81 | and function properly. Two printers called <CODE>Test1</CODE> and | |
82 | <CODE>Test2</CODE> are created, one as a PostScript printer and one | |
83 | as a raster printer. | |
84 | ||
85 | <H2>Job Operation Tests</H2> | |
86 | ||
87 | <P>These test verify that the CUPS scheduler accepts print jobs for | |
88 | all supported file formats and that the <CODE>cancel-job</CODE>, | |
89 | <CODE>hold-job</CODE>, and <CODE>resume-job</CODE> operations work. | |
90 | ||
91 | <H1>Command Tests</H1> | |
92 | ||
93 | <P>This section describes the tests used to validate the | |
94 | Berkeley and System V commands included with CUPS. | |
95 | ||
96 | <H2>lpadmin</H2> | |
97 | ||
98 | <P>This test verifies that printers can be added, modified, and | |
99 | defaulted using the <CODE>lpadmin</CODE> command. | |
100 | ||
101 | <H2>lpc</H2> | |
102 | ||
103 | <P>This test verifies that the <CODE>lpc</CODE> command can show | |
104 | the current status of all print queues. | |
105 | ||
106 | <H2>lpq</H2> | |
107 | ||
108 | <P>This test verifies that the <CODE>lpq</CODE> command lists | |
109 | any jobs in the queue. | |
110 | ||
111 | <H2>lpstat</H2> | |
112 | ||
113 | <P>This test verifies that the <CODE>lpstat</CODE> command works | |
114 | with all reports using the "<CODE>-t</CODE>" option. | |
115 | ||
116 | <H2>lp</H2> | |
117 | ||
118 | <P>This test verifies that the <CODE>lp</CODE> command works | |
119 | with both the default destination and a specific destination. | |
120 | ||
121 | <H2>lpr</H2> | |
122 | ||
123 | <P>This test verifies that the <CODE>lpr</CODE> command works | |
124 | with both the default destination and a specific destination. | |
125 | ||
126 | <H2>lprm</H2> | |
127 | ||
128 | <P>This test verifies that the <CODE>lprm</CODE> command can | |
129 | properly cancel a job. | |
130 | ||
131 | <H2>cancel</H2> | |
132 | ||
133 | <P>This test verifies that the <CODE>cancel</CODE> command can | |
134 | properly cancel a job or all jobs. | |
135 | ||
136 | <H2>lpinfo</H2> | |
137 | ||
138 | <P>This test verifies that the <CODE>lpinfo</CODE> command | |
139 | returns a list of available printer drivers and devices. | |
140 | ||
141 | <EMBED SRC="glossary.shtml"> | |
142 | ||
143 | </BODY> | |
144 | </HTML> |