doc/stp.shtml

   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>