doc/help/sharing.html

   1 <html>
   2 <!-- SECTION: Getting Started -->
   3 <head>
   4         <title>Printer Sharing</title>
   5         <LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
   6 </HEAD>
   7 <BODY>
   8
   9 <H1 CLASS="title">Printer Sharing</H1>
  10
  11 <p>This document discusses several ways to configure printer sharing.</p>
  12
  13 <h2><a name="BASICS">The Basics</h2>
  14
  15 <p>A "server" is any machine that communicates directly to a printer. A "client" is any machine that sends print jobs to a server for final printing. Clients can also be servers if they communicate directly with any printers of their own.</p>
  16
  17 <p>By default, CUPS uses the Internet Printing Protocol (IPP) to send jobs from a client to a server. When printing to legacy print servers you may also use the Line Printer Daemon (LPD) protocol when printing to older UNIX-based servers or Server Message Block (SMB) when printing to Windows<sup>&reg;</sup> servers.</p>
  18
  19 <p>Clients can automatically discover and access shared printers via DNS Service Discovery (DNS-SD a.k.a. Bonjour<sup>&reg;</sup>). SMB browsing can also be used to manually discover and access shared printers when <a href="http://www.samba.org/">Samba</a> is installed.</p>
  20
  21
  22 <h2><a name="SERVER_CONFIG">Configuring the Server</a></h2>
  23
  24 <p>You must enable printer sharing on the server before clients can print through it. The simplest way to do this is to use the <a href="man-cupsctl.html">cupsctl(8)</a> command on the server:</p>
  25
  26 <pre class="command">
  27 cupsctl --share-printers
  28 </pre>
  29
  30 <p>By default, the above command will allow printing from other clients on the same subnet as your server. To allow printing from any subnet, use the following command instead:</p>
  31
  32 <pre class="command">
  33 cupsctl --share-printers --remote-any
  34 </pre>
  35
  36 <p>Next, tag each printer that you want to share using the <a href="man-lpadmin.html">lpadmin(8)</a> command on the server, for example:</p>
  37
  38 <pre class="command">
  39 lpadmin -p printer -o printer-is-shared=true
  40 </pre>
  41
  42 <p>You can require authentication for shared printing by setting the policy on each printer, for example:</p>
  43
  44 <pre class="command">
  45 lpadmin -p printer -o printer-op-policy=authenticated
  46 </pre>
  47
  48
  49 <h2><a name="AUTO_IPP">Automatic Configuration using IPP</a></h2>
  50
  51 <blockquote><b>Note:</b>
  52 <p>This method of configuration does not work on macOS 10.7 or later because sandboxed applications do not always have direct network access.</p>
  53 </blockquote>
  54
  55 <p>CUPS can be configured to run without a local spooler and send all jobs to a
  56 single server. However, if that server goes down then all printing will be
  57 disabled. Use this configuration only as absolutely necessary.</p>
  58
  59 <p>The default server is normally the local system ("localhost"). To override
  60 the default server create a file named <var>/etc/cups/client.conf</var> with a
  61 line as follows:</p>
  62
  63 <pre class='example'>
  64 ServerName <em>server</em>
  65 </pre>
  66
  67 <p>The <var>server</var> name can be the hostname or IP address of the default
  68 server. If the server is not using the default IPP port (631), you can add the
  69 port number at the end like this:</p>
  70
  71 <pre class='example'>
  72 ServerName <em>server:port</em>
  73 </pre>
  74
  75 <p>The default server can also be customized on a per-user basis. To set a
  76 user-specific server create a file named <var>~/.cups/client.conf</var> instead.
  77 The user <var>client.conf</var> file takes precedence over the system one.</p>
  78
  79 <p>Finally, you can set the <code>CUPS_SERVER</code> environment variable to
  80 override the default server for a single process, for example:</p>
  81
  82 <pre class='command'>
  83 CUPS_SERVER=server:port firefox http://www.cups.org
  84 </pre>
  85
  86 <p>will run the Firefox web browser pointed to the specified server and
  87 port. The environment variable overrides both the user and system
  88 <var>client.conf</var> files, if any.</p>
  89
  90
  91 <h2><a name="MANUAL">Manual Configuration of Print Queues</a></h2>
  92
  93 <blockquote><b>Note:</b>
  94 <p>This method of configuration does not work on macOS 10.7 or later because sandboxed applications do not always have direct network access.</p>
  95 </blockquote>
  96
  97 <p>The most tedious method of configuring client machines is to configure
  98 each remote queue by hand using the <a href="man-lpadmin.html">lpadmin(8)</a>
  99 command:</p>
 100
 101 <pre class='command'>
 102 lpadmin -p <em>printer</em> -E -v ipp://<em>server</em>/printers/<em>printer</em>
 103 </pre>
 104
 105 <p>The <var>printer</var> name is the name of the printer on the server machine.
 106 The <var>server</var> name is the hostname or IP address of the server machine.
 107 Repeat the <b>lpadmin</b> command for each remote printer you wish to use.</p>
 108
 109
 110 </body>
 111 </html>