doc/help/admin.html

   1 <!DOCTYPE html>
   2 <html>
   3   <!-- SECTION: Getting Started -->
   4   <head>
   5     <title>Command-Line Printer Administration</title>
   6     <link rel="stylesheet" type="text/css" href="../cups-printable.css">
   7   </head>
   8   <body>
   9     <h1 class="title">Command-Line Printer Administration</h1>
  10
  11     <p>This help document describes how to configure and manage printers with CUPS.</p>
  12
  13     <h2 class="title"><a name="INTRO">Introduction</a></h2>
  14
  15     <p>CUPS currently uses PPD (PostScript Printer Description) files that describe printer capabilities and driver programs needed for each printer.  The <code>everywhere</code> PPD is used for nearly all modern networks printers sold since about 2009.  For example, the following command creates a print queue for a printer at address 11.22.33.44:
  16
  17     <pre class="command">lpadmin -p printername -E -v ipp://11.22.33.44/ipp/print -m everywhere</pre>
  18
  19     <p>CUPS also includes several sample PPD files you can use for "legacy" printers:</p>
  20
  21     <div class="table"><table>
  22       <thead>
  23         <tr><th>Driver</th><th>PPD Name</th></tr>
  24       </thead>
  25       <tbody>
  26         <tr><td>Dymo Label Printers</td><td>drv:///sample.drv/dymo.ppd</td></tr>
  27         <tr><td>Intellitech Intellibar</td><td>drv:///sample.drv/intelbar.ppd</td></tr>
  28         <tr><td>EPSON 9-pin Series</td><td>drv:///sample.drv/epson9.ppd</td></tr>
  29         <tr><td>EPSON 24-pin Series</td><td>drv:///sample.drv/epson24.ppd</td></tr>
  30         <tr><td>Generic PCL Laser Printer</td><td>drv:///sample.drv/generpcl.ppd</td></tr>
  31         <tr><td>Generic PostScript Printer</td><td>drv:///sample.drv/generic.ppd</td></tr>
  32         <tr><td>HP DeskJet Series</td><td>drv:///sample.drv/deskjet.ppd</td></tr>
  33         <tr><td>HP LaserJet Series</td><td>drv:///sample.drv/laserjet.ppd</td></tr>
  34         <tr><td>OKIDATA 9-Pin Series</td><td>drv:///sample.drv/okidata9.ppd</td></tr>
  35         <tr><td>OKIDATA 24-Pin Series</td><td>drv:///sample.drv/okidat24.ppd</td></tr>
  36         <tr><td>Zebra CPCL Label Printer</td><td>drv:///sample.drv/zebracpl.ppd</td></tr>
  37         <tr><td>Zebra EPL1 Label Printer</td><td>drv:///sample.drv/zebraep1.ppd</td></tr>
  38         <tr><td>Zebra EPL2 Label Printer</td><td>drv:///sample.drv/zebraep2.ppd</td></tr>
  39         <tr><td>Zebra ZPL Label Printer</td><td>drv:///sample.drv/zebra.ppd</td></tr>
  40       </tbody>
  41     </table></div>
  42
  43     <p>You can run the <code>lpinfo -m</code> command to list all of the available drivers:</p>
  44
  45     <pre class="command">lpinfo -m</pre>
  46
  47     <p>Run the <code>lpinfo -v</code> command to list the available printers:</p>
  48
  49     <pre class="command">lpinfo -v</pre>
  50
  51     <p>Then use the correct URI to add the printer using the <code>lpadmin</code> command:</p>
  52
  53     <pre class="command">lpadmin -p printername -E -v device-uri -m ppd-name</pre>
  54
  55     <p>Current network printers typically use <code>ipp</code> or <code>ipps</code> URIS:</p>
  56
  57     <pre class="command">lpadmin -p printername -E -v ipp://11.22.33.44/ipp/print -m everywhere
  58 lpadmin -p printername -E -v ipps://11.22.33.44/ipp/print -m everywhere</pre>
  59
  60     <p>Older network printers typically use <code>socket</code> or <code>lpd</code> URIs:</p>
  61
  62     <pre class="command">lpadmin -p printername -E -v socket://11.22.33.44 -m ppd-name
  63 lpadmin -p printername -E -v lpd://11.22.33.44/ -m ppd-name</pre>
  64
  65     <p>The sample drivers provide basic printing capabilities, but generally do not exercise the full potential of the printers or CUPS. Other drivers provide greater printing capabilities.</p>
  66   </body>
  67 </html>