[thirdparty/cups.git] / doc / help / spec-stp.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<!-- SECTION: Specifications -->
<HEAD>
	<TITLE>CUPS Software Test Plan</TITLE>
</HEAD>
<BODY>

<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.</P>


<H2 CLASS="title"><A NAME="PROCEDURE">Test Procedure</A></H2>

<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>

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

<PRE CLASS="command">
make test
</PRE>

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

<PRE CLASS="command">
cd test
./run-stp-tests
</PRE>

<P>A Software Test Report is stored in a HTML file in the
<VAR>test</VAR> subdirectory at the conclusion of the test.</P>


<H2 CLASS="title"><A NAME="IPP">IPP Compliance Tests</A></H2>

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

<H3>Request Tests</H3>

<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>

<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.</P>

<H3>CUPS Printer Operation Tests</H3>

<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.</P>

<H3>Job Operation Tests</H3>

<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.</P>

<H3>Subscription Operation Tests</H3>

<P>These test verify that the CUPS scheduler accepts
subscriptions with print jobs and that all subscription
operations work as required by the IPP notification and mailto
specifications.</P>


<H2 CLASS="title"><A NAME="COMMAND">Command Tests</A></H2>

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

<H3>lpadmin</H3>

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

<H3>lpc</H3>

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

<H3>lpq</H3>

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

<H3>lpstat</H3>

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

<H3>lp</H3>

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

<H3>lpr</H3>

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

<H3>lprm</H3>

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

<H3>cancel</H3>

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

<H3>lpinfo</H3>

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

</BODY>
</HTML>
Commit	Line	Data
745129be	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
4744bd90	2	<HTML>
	3	<!-- SECTION: Specifications -->
	4	<HEAD>
	5	<TITLE>CUPS Software Test Plan</TITLE>
	6	</HEAD>
	7	<BODY>
	8
	9	<P>This software test plan provides detailed tests that are used
	10	to evaluate the stability and compliance of the Common UNIX
	11	Printing System ("CUPS") Version 1.2.</P>
	12
	13
	14	<H2 CLASS="title"><A NAME="PROCEDURE">Test Procedure</A></H2>
	15
	16	<P>The test software and data files are located in the
	17	<VAR>test</VAR> subdirectory of the source distribution. A script
	18	is provided to compile the <CODE>ipptest</CODE> program and run
	19	all of the tests that follow, producing a success/fail
	20	report.</P>
	21
	22	<P>The <CODE>test</CODE> target of the top-level makefile can be
	23	used to run this script:</P>
	24
	25	<PRE CLASS="command">
	26	make test
	27	</PRE>
	28
	29	<P>or you can run the test script directly:</P>
	30
	31	<PRE CLASS="command">
	32	cd test
	33	./run-stp-tests
	34	</PRE>
	35
	36	<P>A Software Test Report is stored in a HTML file in the
	37	<VAR>test</VAR> subdirectory at the conclusion of the test.</P>
	38
	39
	40	<H2 CLASS="title"><A NAME="IPP">IPP Compliance Tests</A></H2>
	41
	42	<P>This section describes the tests used to validate the IPP
	43	standards compliance of the CUPS server.</P>
	44
	45	<H3>Request Tests</H3>
	46
	47	<P>These tests verify that the CUPS scheduler only accepts valid
	48	IPP requests that start with the <CODE>attributes-charset</CODE>
	49	and <CODE>attributes-natural-language</CODE> attributes and also
	50	contain a <CODE>printer-uri</CODE> or <CODE>job-uri</CODE>
	51	attribute.</P>
	52
	53	<P>It also verifies that the CUPS scheduler always responds with
	54	<CODE>attributes-charset</CODE> and
	55	<CODE>attributes-natural-language</CODE> attributes, using
	56	default values if they are not provided by the client.</P>
	57
	58	<H3>CUPS Printer Operation Tests</H3>
	59
	60	<P>These tests verify that the CUPS printer operations are
	61	supported and function properly. Two printers called
	62	<CODE>Test1</CODE> and <CODE>Test2</CODE> are created, one as a
	63	PostScript printer and one as a raster printer.</P>
	64
	65	<H3>Job Operation Tests</H3>
66
67	<P>These test verify that the CUPS scheduler accepts print jobs
68	for all supported file formats and that the
69	<CODE>cancel-job</CODE>, <CODE>hold-job</CODE>, and
70	<CODE>resume-job</CODE> operations work.</P>
71
72	<H3>Subscription Operation Tests</H3>
73
74	<P>These test verify that the CUPS scheduler accepts
75	subscriptions with print jobs and that all subscription
76	operations work as required by the IPP notification and mailto
77	specifications.</P>
78
79
80	<H2 CLASS="title"><A NAME="COMMAND">Command Tests</A></H2>
81
82	<P>This section describes the tests used to validate the Berkeley
83	and System V commands included with CUPS.</P>
84
85	<H3>lpadmin</H3>
86
87	<P>This test verifies that printers can be added, modified, and
88	defaulted using the <CODE>lpadmin</CODE> command.</P>
89
90	<H3>lpc</H3>
91
92	<P>This test verifies that the <CODE>lpc</CODE> command can show
93	the current status of all print queues.</P>
94
95	<H3>lpq</H3>
96
97	<P>This test verifies that the <CODE>lpq</CODE> command lists
98	any jobs in the queue.</P>
99
100	<H3>lpstat</H3>
101
102	<P>This test verifies that the <CODE>lpstat</CODE> command works
103	with all reports using the "<CODE>-t</CODE>" option.</P>
104
105	<H3>lp</H3>
106
107	<P>This test verifies that the <CODE>lp</CODE> command works with
108	both the default destination and a specific destination.</P>
109
110	<H3>lpr</H3>
111
112	<P>This test verifies that the <CODE>lpr</CODE> command works
113	with both the default destination and a specific destination.</P>
114
115	<H3>lprm</H3>
116
117	<P>This test verifies that the <CODE>lprm</CODE> command can
118	properly cancel a job.</P>
119
120	<H3>cancel</H3>
121
122	<P>This test verifies that the <CODE>cancel</CODE> command can
123	properly cancel a job or all jobs.</P>
124
125	<H3>lpinfo</H3>
126
127	<P>This test verifies that the <CODE>lpinfo</CODE> command
128	returns a list of available printer drivers and devices.</P>
129
130	</BODY>
131	</HTML>