Blame doc/help/spec-stp.html

Packit 2fc92b
Packit 2fc92b
<HTML>
Packit 2fc92b
Packit 2fc92b
<HEAD>
Packit 2fc92b
	<TITLE>CUPS Software Test Plan</TITLE>
Packit 2fc92b
	<LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
Packit 2fc92b
</HEAD>
Packit 2fc92b
<BODY>
Packit 2fc92b
Packit 2fc92b

CUPS Software Test Plan

Packit 2fc92b
Packit 2fc92b

This software test plan provides detailed tests that are used

Packit 2fc92b
to evaluate the stability and compliance of CUPS.

Packit 2fc92b
Packit 2fc92b
Packit 2fc92b

Test Procedure

Packit 2fc92b
Packit 2fc92b

The test software and data files are located in the

Packit 2fc92b
test subdirectory of the source distribution. A script
Packit 2fc92b
is provided to compile the ipptool program and run
Packit 2fc92b
all of the tests that follow, producing a success/fail
Packit 2fc92b
report.

Packit 2fc92b
Packit 2fc92b

The test target of the top-level makefile can be

Packit 2fc92b
used to run this script:

Packit 2fc92b
Packit 2fc92b
Packit 2fc92b
make test
Packit 2fc92b
Packit 2fc92b
Packit 2fc92b

or you can run the test script directly:

Packit 2fc92b
Packit 2fc92b
Packit 2fc92b
cd test
Packit 2fc92b
./run-stp-tests
Packit 2fc92b
Packit 2fc92b
Packit 2fc92b

A Software Test Report is stored in a HTML file in the

Packit 2fc92b
test subdirectory at the conclusion of the test.

Packit 2fc92b
Packit 2fc92b
Packit 2fc92b

IPP Compliance Tests

Packit 2fc92b
Packit 2fc92b

This section describes the tests used to validate the IPP

Packit 2fc92b
standards compliance of the CUPS server.

Packit 2fc92b
Packit 2fc92b

Request Tests

Packit 2fc92b
Packit 2fc92b

These tests verify that the CUPS scheduler only accepts valid

Packit 2fc92b
IPP requests that start with the attributes-charset
Packit 2fc92b
and attributes-natural-language attributes and also
Packit 2fc92b
contain a printer-uri or job-uri
Packit 2fc92b
attribute.

Packit 2fc92b
Packit 2fc92b

It also verifies that the CUPS scheduler always responds with

Packit 2fc92b
attributes-charset and
Packit 2fc92b
attributes-natural-language attributes, using
Packit 2fc92b
default values if they are not provided by the client.

Packit 2fc92b
Packit 2fc92b

CUPS Printer Operation Tests

Packit 2fc92b
Packit 2fc92b

These tests verify that the CUPS printer operations are

Packit 2fc92b
supported and function properly. Two printers called
Packit 2fc92b
Test1 and Test2 are created, one as a
Packit 2fc92b
PostScript printer and one as a raster printer.

Packit 2fc92b
Packit 2fc92b

Job Operation Tests

Packit 2fc92b
Packit 2fc92b

These test verify that the CUPS scheduler accepts print jobs

Packit 2fc92b
for all supported file formats and that the
Packit 2fc92b
cancel-job, hold-job, and
Packit 2fc92b
resume-job operations work.

Packit 2fc92b
Packit 2fc92b

Subscription Operation Tests

Packit 2fc92b
Packit 2fc92b

These test verify that the CUPS scheduler accepts

Packit 2fc92b
subscriptions with print jobs and that all subscription
Packit 2fc92b
operations work as required by the IPP notification and mailto
Packit 2fc92b
specifications.

Packit 2fc92b
Packit 2fc92b
Packit 2fc92b

Command Tests

Packit 2fc92b
Packit 2fc92b

This section describes the tests used to validate the Berkeley

Packit 2fc92b
and System V commands included with CUPS.

Packit 2fc92b
Packit 2fc92b

lpadmin

Packit 2fc92b
Packit 2fc92b

This test verifies that printers can be added, modified, and

Packit 2fc92b
defaulted using the lpadmin command.

Packit 2fc92b
Packit 2fc92b

lpc

Packit 2fc92b
Packit 2fc92b

This test verifies that the lpc command can show

Packit 2fc92b
the current status of all print queues.

Packit 2fc92b
Packit 2fc92b

lpq

Packit 2fc92b
Packit 2fc92b

This test verifies that the lpq command lists

Packit 2fc92b
any jobs in the queue.

Packit 2fc92b
Packit 2fc92b

lpstat

Packit 2fc92b
Packit 2fc92b

This test verifies that the lpstat command works

Packit 2fc92b
with all reports using the "-t" option.

Packit 2fc92b
Packit 2fc92b

lp

Packit 2fc92b
Packit 2fc92b

This test verifies that the lp command works with

Packit 2fc92b
both the default destination and a specific destination.

Packit 2fc92b
Packit 2fc92b

lpr

Packit 2fc92b
Packit 2fc92b

This test verifies that the lpr command works

Packit 2fc92b
with both the default destination and a specific destination.

Packit 2fc92b
Packit 2fc92b

lprm

Packit 2fc92b
Packit 2fc92b

This test verifies that the lprm command can

Packit 2fc92b
properly cancel a job.

Packit 2fc92b
Packit 2fc92b

cancel

Packit 2fc92b
Packit 2fc92b

This test verifies that the cancel command can

Packit 2fc92b
properly cancel a job or all jobs.

Packit 2fc92b
Packit 2fc92b

lpinfo

Packit 2fc92b
Packit 2fc92b

This test verifies that the lpinfo command

Packit 2fc92b
returns a list of available printer drivers and devices.

Packit 2fc92b
Packit 2fc92b
</BODY>
Packit 2fc92b
</HTML>