[thirdparty/cups.git] / doc / stp.shtml

<HTML>
<HEAD>
	<META NAME="Description" CONTENT="Common UNIX Printing System Software Test Plan">
	<META NAME="COPYRIGHT" CONTENT="Copyright 1997-2003, All Rights Reserved">
	<META NAME="DOCNUMBER" CONTENT="CUPS-STP-1.2">
	<META NAME="Author" CONTENT="Easy Software Products">
	<TITLE>CUPS Software Test Plan</TITLE>
</HEAD>
<BODY>

<H1>Scope</H1>

<H2>Identification</H2>

<P>This software test plan provides detailed tests that are used
to evaluate the stability and compliance of the Common UNIX
Printing System ("CUPS") Version 1.2.

<EMBED SRC="system-overview.shtml">

<H2>Document Overview</H2>

<P>This software test plan is organized into the following sections:

<UL>
	<LI>1 - Scope</LI>
	<LI>2 - References</LI>
	<LI>3 - Test Procedure</LI>
	<LI>4 - IPP Compliance Tests</LI>
	<LI>5 - Command Tests</LI>
	<LI>A - Glossary</LI>
</UL>

<EMBED SRC="references.shtml">

<H1>Test Procedure</H1>

<P>The test software and data files are located in the <VAR>test</VAR>
subdirectory of the source distribution. A script is provided to compile
the <CODE>ipptest</CODE> program and run all of the tests that follow,
producing a success/fail report.

<P>The <CODE>test</CODE> target of the top-level makefile can be used to
run this script:

<UL><PRE>
make test
</PRE></UL>

<P>or you can run the test script directly:

<UL><PRE>
cd test
./run-stp-tests
</PRE></UL>

<P>A Software Test Report is stored in HTML and PDF files that
are generated using the
<A HREF="http://www.easysw.com/htmldoc">HTMLDOC</A> software.

<H1>IPP Compliance Tests</H1>

<P>This section describes the tests used to validate the IPP
standards compliance of the CUPS server.

<H2>Request Tests</H2>

<P>These tests verify that the CUPS scheduler only accepts valid
IPP requests that start with the <CODE>attributes-charset</CODE>
and <CODE>attributes-natural-language</CODE> attributes and also
contain a <CODE>printer-uri</CODE> or <CODE>job-uri</CODE> attribute.

<P>It also verifies that the CUPS scheduler always responds with
<CODE>attributes-charset</CODE> and
<CODE>attributes-natural-language</CODE> attributes, using
default values if they are not provided by the client.

<H2>CUPS Printer Operation Tests</H2>

<P>These tests verify that the CUPS printer operations are supported
and function properly. Two printers called <CODE>Test1</CODE> and
<CODE>Test2</CODE> are created, one as a PostScript printer and one
as a raster printer.

<H2>Job Operation Tests</H2>

<P>These test verify that the CUPS scheduler accepts print jobs for
all supported file formats and that the <CODE>cancel-job</CODE>,
<CODE>hold-job</CODE>, and <CODE>resume-job</CODE> operations work.

<H1>Command Tests</H1>

<P>This section describes the tests used to validate the
Berkeley and System V commands included with CUPS.

<H2>lpadmin</H2>

<P>This test verifies that printers can be added, modified, and
defaulted using the <CODE>lpadmin</CODE> command.

<H2>lpc</H2>

<P>This test verifies that the <CODE>lpc</CODE> command can show
the current status of all print queues.

<H2>lpq</H2>

<P>This test verifies that the <CODE>lpq</CODE> command lists
any jobs in the queue.

<H2>lpstat</H2>

<P>This test verifies that the <CODE>lpstat</CODE> command works
with all reports using the "<CODE>-t</CODE>" option.

<H2>lp</H2>

<P>This test verifies that the <CODE>lp</CODE> command works
with both the default destination and a specific destination.

<H2>lpr</H2>

<P>This test verifies that the <CODE>lpr</CODE> command works
with both the default destination and a specific destination.

<H2>lprm</H2>

<P>This test verifies that the <CODE>lprm</CODE> command can
properly cancel a job.

<H2>cancel</H2>

<P>This test verifies that the <CODE>cancel</CODE> command can
properly cancel a job or all jobs.

<H2>lpinfo</H2>

<P>This test verifies that the <CODE>lpinfo</CODE> command
returns a list of available printer drivers and devices.

<EMBED SRC="glossary.shtml">

</BODY>
</HTML>
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>