Ignore:
Timestamp:
Nov 27, 2012, 4:43:17 PM (13 years ago)
Author:
Silvan Scherrer
Message:

Samba Server: updated trunk to 3.6.0

Location:
trunk/server
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • trunk/server

  • trunk/server/docs/htmldocs/Samba3-HOWTO/classicalprinting.html

    r599 r745  
    1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 21. Classical Printing Support</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="The Official Samba 3.5.x HOWTO and Reference Guide"><link rel="up" href="optional.html" title="Part III. Advanced Configuration"><link rel="prev" href="msdfs.html" title="Chapter 20. Hosting a Microsoft Distributed File System Tree"><link rel="next" href="CUPS-printing.html" title="Chapter 22. CUPS Printing Support"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 21. Classical Printing Support</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="msdfs.html">Prev</a> </td><th width="60%" align="center">Part III. Advanced Configuration</th><td width="20%" align="right"> <a accesskey="n" href="CUPS-printing.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 21. Classical Printing Support"><div class="titlepage"><div><div><h2 class="title"><a name="classicalprinting"></a>Chapter 21. Classical Printing Support</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Kurt</span> <span class="surname">Pfeifle</span></h3><div class="affiliation"><span class="orgname">Danka Deutschland GmbH<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:kpfeifle@danka.de">kpfeifle@danka.de</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Gerald</span> <span class="othername">(Jerry)</span> <span class="surname">Carter</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jerry@samba.org">jerry@samba.org</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>&gt;</code></p></div></div></div></div><div><p class="pubdate">May 31, 2003</p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="classicalprinting.html#id389000">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id389202">Technical Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id389339">Client to Samba Print Job Processing</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id389393">Printing-Related Configuration Parameters</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id389487">Simple Print Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id389756">Verifying Configuration with <code class="literal">testparm</code></a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id389938">Rapid Configuration Validation</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id390291">Extended Printing Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id390731">Detailed Explanation Settings</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#cups-msrpc">Printing Developments Since Samba-2.2</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id393257">Point'n'Print Client Drivers on Samba Servers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id393411">The Obsoleted [printer$] Section</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id393521">Creating the [print$] Share</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id393729">[print$] Stanza Parameters</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id394022">The [print$] Share Directory</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id394150">Installing Drivers into [print$]</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id394235">Add Printer Wizard Driver Installation</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#inst-rpc">Installing Print Drivers Using <code class="literal">rpcclient</code></a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id395945">Client Driver Installation Procedure</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id395960">First Client Driver Installation</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#prt-modeset">Setting Device Modes on New Printers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id396470">Additional Client Driver Installation</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id396581">Always Make First Client Connection as root or <span class="quote">&#8220;<span class="quote">printer admin</span>&#8221;</span></a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id396739">Other Gotchas</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id396756">Setting Default Print Options for Client Drivers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397092">Supporting Large Numbers of Printers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397328">Adding New Printers with the Windows NT APW</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397565">Error Message: <span class="quote">&#8220;<span class="quote">Cannot connect under a different Name</span>&#8221;</span></a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397664">Take Care When Assembling Driver Files</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397864">Samba and Printer Ports</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397963">Avoiding Common Client Driver Misconfiguration</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id397996">The Imprints Toolset</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id398034">What Is Imprints?</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id398063">Creating Printer Driver Packages</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id398076">The Imprints Server</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id398090">The Installation Client</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id398206">Adding Network Printers without User Interaction</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id398448">The <code class="literal">addprinter</code> Command</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id398481">Migration of Classical Printing to Samba</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id398612">Publishing Printer Information in Active Directory or LDAP</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id398639">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id398644">I Give My Root Password but I Do Not Get Access</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id398682">My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost</a></span></dt></dl></dd></dl></div><div class="sect1" title="Features and Benefits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id389000"></a>Features and Benefits</h2></div></div></div><p>
    2 <a class="indexterm" name="id389007"></a>
     1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 21. Classical Printing Support</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="The Official Samba 3.5.x HOWTO and Reference Guide"><link rel="up" href="optional.html" title="Part III. Advanced Configuration"><link rel="prev" href="msdfs.html" title="Chapter 20. Hosting a Microsoft Distributed File System Tree"><link rel="next" href="CUPS-printing.html" title="Chapter 22. CUPS Printing Support"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 21. Classical Printing Support</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="msdfs.html">Prev</a> </td><th width="60%" align="center">Part III. Advanced Configuration</th><td width="20%" align="right"> <a accesskey="n" href="CUPS-printing.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 21. Classical Printing Support"><div class="titlepage"><div><div><h2 class="title"><a name="classicalprinting"></a>Chapter 21. Classical Printing Support</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Kurt</span> <span class="surname">Pfeifle</span></h3><div class="affiliation"><span class="orgname">Danka Deutschland GmbH<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:kpfeifle@danka.de">kpfeifle@danka.de</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Gerald</span> <span class="othername">(Jerry)</span> <span class="surname">Carter</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jerry@samba.org">jerry@samba.org</a>&gt;</code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>&gt;</code></p></div></div></div></div><div><p class="pubdate">May 31, 2003</p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="classicalprinting.html#id389000">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id389202">Technical Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id389339">Client to Samba Print Job Processing</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id389393">Printing-Related Configuration Parameters</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id389487">Simple Print Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id389756">Verifying Configuration with <code class="literal">testparm</code></a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id389939">Rapid Configuration Validation</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id390291">Extended Printing Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id390731">Detailed Explanation Settings</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#cups-msrpc">Printing Developments Since Samba-2.2</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id393254">Point'n'Print Client Drivers on Samba Servers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id393408">The Obsoleted [printer$] Section</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id393519">Creating the [print$] Share</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id393726">[print$] Stanza Parameters</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id394019">The [print$] Share Directory</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id394148">Installing Drivers into [print$]</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id394232">Add Printer Wizard Driver Installation</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#inst-rpc">Installing Print Drivers Using <code class="literal">rpcclient</code></a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id395921">Client Driver Installation Procedure</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id395936">First Client Driver Installation</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#prt-modeset">Setting Device Modes on New Printers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id396442">Additional Client Driver Installation</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id396553">Always Make First Client Connection as root or <span class="quote">&#8220;<span class="quote">printer admin</span>&#8221;</span></a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id396711">Other Gotchas</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id396728">Setting Default Print Options for Client Drivers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397064">Supporting Large Numbers of Printers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397300">Adding New Printers with the Windows NT APW</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397538">Error Message: <span class="quote">&#8220;<span class="quote">Cannot connect under a different Name</span>&#8221;</span></a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397636">Take Care When Assembling Driver Files</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397860">Samba and Printer Ports</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id397959">Avoiding Common Client Driver Misconfiguration</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id397992">The Imprints Toolset</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id398030">What Is Imprints?</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id398060">Creating Printer Driver Packages</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id398072">The Imprints Server</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id398086">The Installation Client</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id398202">Adding Network Printers without User Interaction</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id398444">The <code class="literal">addprinter</code> Command</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id398477">Migration of Classical Printing to Samba</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id398608">Publishing Printer Information in Active Directory or LDAP</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id398635">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id398641">I Give My Root Password but I Do Not Get Access</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id398678">My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost</a></span></dt></dl></dd></dl></div><div class="sect1" title="Features and Benefits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id389000"></a>Features and Benefits</h2></div></div></div><p>
     2<a class="indexterm" name="id389008"></a>
    33Printing is often a mission-critical service for the users. Samba can provide this service reliably and
    44seamlessly for a client network consisting of Windows workstations.
     
    77<a class="indexterm" name="id389026"></a>
    88<a class="indexterm" name="id389033"></a>
    9 <a class="indexterm" name="id389039"></a>
     9<a class="indexterm" name="id389040"></a>
    1010<a class="indexterm" name="id389046"></a>
    1111<a class="indexterm" name="id389053"></a>
    1212<a class="indexterm" name="id389060"></a>
    1313<a class="indexterm" name="id389067"></a>
    14 <a class="indexterm" name="id389073"></a>
     14<a class="indexterm" name="id389074"></a>
    1515<a class="indexterm" name="id389080"></a>
    1616<a class="indexterm" name="id389087"></a>
    1717<a class="indexterm" name="id389094"></a>
    1818<a class="indexterm" name="id389101"></a>
    19 <a class="indexterm" name="id389107"></a>
     19<a class="indexterm" name="id389108"></a>
    2020A Samba print service may be run on a standalone or domain member server, side by side with file serving
    2121functions, or on a dedicated print server.  It can be made as tightly or as loosely secured as needs dictate.
     
    9090<a class="indexterm" name="id389401"></a>
    9191<a class="indexterm" name="id389408"></a>
    92 <a class="indexterm" name="id389414"></a>
     92<a class="indexterm" name="id389415"></a>
    9393There are a number of configuration parameters to control Samba's printing behavior. Please refer to the man
    9494page for <code class="filename">smb.conf</code> for an overview of these. As with other parameters, there are global-level (tagged with a
     
    137137<a class="indexterm" name="id389775"></a>
    138138<a class="indexterm" name="id389782"></a>
    139 <a class="indexterm" name="id389788"></a>
     139<a class="indexterm" name="id389789"></a>
    140140<a class="indexterm" name="id389795"></a>
    141141<a class="indexterm" name="id389802"></a>
    142142<a class="indexterm" name="id389809"></a>
    143143<a class="indexterm" name="id389816"></a>
    144 <a class="indexterm" name="id389822"></a>
     144<a class="indexterm" name="id389823"></a>
    145145<a class="indexterm" name="id389829"></a>
    146146<a class="indexterm" name="id389836"></a>
     
    195195<span class="quote">&#8220;<span class="quote">-v</span>&#8221;</span> switch, it only shows you the settings actually written into! To see the complete
    196196configuration used, add the <span class="quote">&#8220;<span class="quote">-v</span>&#8221;</span> parameter to testparm.
    197 </p></div></div><div class="sect2" title="Rapid Configuration Validation"><div class="titlepage"><div><div><h3 class="title"><a name="id389938"></a>Rapid Configuration Validation</h3></div></div></div><p>
     197</p></div></div><div class="sect2" title="Rapid Configuration Validation"><div class="titlepage"><div><div><h3 class="title"><a name="id389939"></a>Rapid Configuration Validation</h3></div></div></div><p>
    198198<a class="indexterm" name="id389947"></a>
    199199<a class="indexterm" name="id389954"></a>
     
    296296<a class="indexterm" name="id390299"></a>
    297297<a class="indexterm" name="id390306"></a>
    298 <a class="indexterm" name="id390312"></a>
     298<a class="indexterm" name="id390313"></a>
    299299<a class="indexterm" name="id390319"></a>
    300300<a class="link" href="classicalprinting.html#extbsdpr" title="Example 21.2. Extended BSD Printing Configuration">Extended BSD Printing Configuration</a> shows a more verbose configuration for
     
    305305are set by default. You could use a much leaner <code class="filename">smb.conf</code> file, or you can use <code class="literal">testparm</code> or
    306306<code class="literal">SWAT</code> to optimize the <code class="filename">smb.conf</code> file to remove all parameters that are set at default.
    307 </p><div class="example"><a name="extbsdpr"></a><p class="title"><b>Example 21.2. Extended BSD Printing Configuration</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id390388"></a><em class="parameter"><code>printing = bsd</code></em></td></tr><tr><td><a class="indexterm" name="id390399"></a><em class="parameter"><code>load printers = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390410"></a><em class="parameter"><code>show add printer wizard = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390422"></a><em class="parameter"><code>printcap name = /etc/printcap</code></em></td></tr><tr><td><a class="indexterm" name="id390434"></a><em class="parameter"><code>printer admin = @ntadmin, root</code></em></td></tr><tr><td><a class="indexterm" name="id390445"></a><em class="parameter"><code>max print jobs = 100</code></em></td></tr><tr><td><a class="indexterm" name="id390457"></a><em class="parameter"><code>lpq cache time = 20</code></em></td></tr><tr><td><a class="indexterm" name="id390468"></a><em class="parameter"><code>use client driver = no</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[printers]</code></em></td></tr><tr><td><a class="indexterm" name="id390489"></a><em class="parameter"><code>comment = All Printers</code></em></td></tr><tr><td><a class="indexterm" name="id390500"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390512"></a><em class="parameter"><code>path = /var/spool/samba</code></em></td></tr><tr><td><a class="indexterm" name="id390523"></a><em class="parameter"><code>browseable = no</code></em></td></tr><tr><td><a class="indexterm" name="id390534"></a><em class="parameter"><code>guest ok = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390546"></a><em class="parameter"><code>public = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390557"></a><em class="parameter"><code>read only = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390569"></a><em class="parameter"><code>writable = no       </code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[my_printer_name]</code></em></td></tr><tr><td><a class="indexterm" name="id390589"></a><em class="parameter"><code>comment = Printer with Restricted Access</code></em></td></tr><tr><td><a class="indexterm" name="id390601"></a><em class="parameter"><code>path = /var/spool/samba_my_printer</code></em></td></tr><tr><td><a class="indexterm" name="id390613"></a><em class="parameter"><code>printer admin = kurt</code></em></td></tr><tr><td><a class="indexterm" name="id390624"></a><em class="parameter"><code>browseable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390636"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390647"></a><em class="parameter"><code>writable = no</code></em></td></tr><tr><td><a class="indexterm" name="id390658"></a><em class="parameter"><code>hosts allow = 0.0.0.0</code></em></td></tr><tr><td><a class="indexterm" name="id390670"></a><em class="parameter"><code>hosts deny = turbo_xp, 10.160.50.23, 10.160.51.60</code></em></td></tr><tr><td><a class="indexterm" name="id390682"></a><em class="parameter"><code>guest ok = no</code></em></td></tr></table></div></div><br class="example-break"><p>
     307</p><div class="example"><a name="extbsdpr"></a><p class="title"><b>Example 21.2. Extended BSD Printing Configuration</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id390388"></a><em class="parameter"><code>printing = bsd</code></em></td></tr><tr><td><a class="indexterm" name="id390399"></a><em class="parameter"><code>load printers = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390411"></a><em class="parameter"><code>show add printer wizard = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390422"></a><em class="parameter"><code>printcap name = /etc/printcap</code></em></td></tr><tr><td><a class="indexterm" name="id390434"></a><em class="parameter"><code>printer admin = @ntadmin, root</code></em></td></tr><tr><td><a class="indexterm" name="id390445"></a><em class="parameter"><code>max print jobs = 100</code></em></td></tr><tr><td><a class="indexterm" name="id390457"></a><em class="parameter"><code>lpq cache time = 20</code></em></td></tr><tr><td><a class="indexterm" name="id390468"></a><em class="parameter"><code>use client driver = no</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[printers]</code></em></td></tr><tr><td><a class="indexterm" name="id390489"></a><em class="parameter"><code>comment = All Printers</code></em></td></tr><tr><td><a class="indexterm" name="id390500"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390512"></a><em class="parameter"><code>path = /var/spool/samba</code></em></td></tr><tr><td><a class="indexterm" name="id390523"></a><em class="parameter"><code>browseable = no</code></em></td></tr><tr><td><a class="indexterm" name="id390535"></a><em class="parameter"><code>guest ok = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390546"></a><em class="parameter"><code>public = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390558"></a><em class="parameter"><code>read only = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390569"></a><em class="parameter"><code>writable = no       </code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[my_printer_name]</code></em></td></tr><tr><td><a class="indexterm" name="id390589"></a><em class="parameter"><code>comment = Printer with Restricted Access</code></em></td></tr><tr><td><a class="indexterm" name="id390601"></a><em class="parameter"><code>path = /var/spool/samba_my_printer</code></em></td></tr><tr><td><a class="indexterm" name="id390613"></a><em class="parameter"><code>printer admin = kurt</code></em></td></tr><tr><td><a class="indexterm" name="id390624"></a><em class="parameter"><code>browseable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390636"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id390647"></a><em class="parameter"><code>writable = no</code></em></td></tr><tr><td><a class="indexterm" name="id390659"></a><em class="parameter"><code>hosts allow = 0.0.0.0</code></em></td></tr><tr><td><a class="indexterm" name="id390670"></a><em class="parameter"><code>hosts deny = turbo_xp, 10.160.50.23, 10.160.51.60</code></em></td></tr><tr><td><a class="indexterm" name="id390682"></a><em class="parameter"><code>guest ok = no</code></em></td></tr></table></div></div><br class="example-break"><p>
    308308<a class="indexterm" name="id390695"></a>
    309309<a class="indexterm" name="id390701"></a>
     
    315315</p><div class="sect2" title="Detailed Explanation Settings"><div class="titlepage"><div><div><h3 class="title"><a name="id390731"></a>Detailed Explanation Settings</h3></div></div></div><p>
    316316The following is a discussion of the settings from <a class="link" href="classicalprinting.html#extbsdpr" title="Example 21.2. Extended BSD Printing Configuration">Extended BSD Printing
    317 Configuration</a> <a class="link" href="classicalprinting.html#extbsdpr" title="Example 21.2. Extended BSD Printing Configuration">Extended BSD Printing Configuration</a>.
    318 </p><div class="sect3" title="The [global] Section"><div class="titlepage"><div><div><h4 class="title"><a name="id390754"></a>The [global] Section</h4></div></div></div><p>
     317Configuration</a>.
     318</p><div class="sect3" title="The [global] Section"><div class="titlepage"><div><div><h4 class="title"><a name="id390748"></a>The [global] Section</h4></div></div></div><p>
     319<a class="indexterm" name="id390755"></a>
    319320<a class="indexterm" name="id390762"></a>
    320321<a class="indexterm" name="id390769"></a>
    321 <a class="indexterm" name="id390775"></a>
    322 <a class="indexterm" name="id390782"></a>
     322<a class="indexterm" name="id390776"></a>
    323323The <em class="parameter"><code>[global]</code></em> section is one of four special sections (along with <em class="parameter"><code>[homes]</code></em>, <em class="parameter"><code>[printers]</code></em>, and <em class="parameter"><code>[print$]</code></em>). The
    324324<em class="parameter"><code>[global]</code></em> contains all parameters that apply to the server as a whole. It is the place
     
    328328globally set share settings and specify other values).
    329329</p><div class="variablelist"><dl><dt><span class="term"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = bsd </a></span></dt><dd><p>
    330 <a class="indexterm" name="id390843"></a>
    331 <a class="indexterm" name="id390850"></a>
    332 <a class="indexterm" name="id390857"></a>
    333 <a class="indexterm" name="id390864"></a>
    334 <a class="indexterm" name="id390870"></a>
    335 <a class="indexterm" name="id390877"></a>
    336 <a class="indexterm" name="id390884"></a>
    337 <a class="indexterm" name="id390891"></a>
    338 <a class="indexterm" name="id390898"></a>
    339 <a class="indexterm" name="id390904"></a>
    340 <a class="indexterm" name="id390911"></a>
    341 <a class="indexterm" name="id390918"></a>
     330<a class="indexterm" name="id390841"></a>
     331<a class="indexterm" name="id390847"></a>
     332<a class="indexterm" name="id390854"></a>
     333<a class="indexterm" name="id390861"></a>
     334<a class="indexterm" name="id390868"></a>
     335<a class="indexterm" name="id390874"></a>
     336<a class="indexterm" name="id390881"></a>
     337<a class="indexterm" name="id390888"></a>
     338<a class="indexterm" name="id390895"></a>
     339<a class="indexterm" name="id390901"></a>
     340<a class="indexterm" name="id390908"></a>
     341<a class="indexterm" name="id390915"></a>
    342342                Causes Samba to use default print commands applicable for the BSD (also known as RFC 1179 style or LPR/LPD)
    343343                printing system. In general, the <em class="parameter"><code>printing</code></em> parameter informs Samba about the print
     
    345345                systems defaults to a different <a class="link" href="smb.conf.5.html#PRINTCOMMAND" target="_top">print command</a> (and other queue control commands).
    346346                </p><div class="caution" title="Caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Caution</h3><p>
    347 <a class="indexterm" name="id390950"></a>
    348 <a class="indexterm" name="id390957"></a>
     347<a class="indexterm" name="id390947"></a>
     348<a class="indexterm" name="id390954"></a>
    349349                The <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> parameter is normally a service-level parameter. Since it is included
    350350                here in the <em class="parameter"><code>[global]</code></em> section, it will take effect for all printer shares that are not
    351351                defined differently. Samba-3 no longer supports the SOFTQ printing system.
    352352                </p></div></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#LOADPRINTERS" target="_top">load printers = yes </a></span></dt><dd><p>
    353 <a class="indexterm" name="id391000"></a>
    354 <a class="indexterm" name="id391006"></a>
    355 <a class="indexterm" name="id391013"></a>
    356 <a class="indexterm" name="id391020"></a>
     353<a class="indexterm" name="id390997"></a>
     354<a class="indexterm" name="id391004"></a>
     355<a class="indexterm" name="id391010"></a>
     356<a class="indexterm" name="id391017"></a>
    357357                Tells Samba to create automatically all available printer shares. Available printer shares are discovered by
    358358                scanning the printcap file. All created printer shares are also loaded for browsing. If you use this
     
    362362                share separately, leaving out some you do not want to be publicly visible and available).
    363363                </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#SHOWADDPRINTERWIZARD" target="_top">show add printer wizard = yes </a></span></dt><dd><p>
    364 <a class="indexterm" name="id391063"></a>
    365 <a class="indexterm" name="id391069"></a>
    366 <a class="indexterm" name="id391076"></a>
    367 <a class="indexterm" name="id391083"></a>
    368 <a class="indexterm" name="id391090"></a>
     364<a class="indexterm" name="id391060"></a>
     365<a class="indexterm" name="id391066"></a>
     366<a class="indexterm" name="id391073"></a>
     367<a class="indexterm" name="id391080"></a>
     368<a class="indexterm" name="id391087"></a>
    369369                Setting is normally enabled by default (even if the parameter is not specified in <code class="filename">smb.conf</code>).  It causes the
    370370                <span class="guiicon">Add Printer Wizard</span> icon to appear in the <span class="guiicon">Printers</span> folder of the Samba
     
    375375                before the action), or exchange a printer's driver for any other previously uploaded driver.
    376376                </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#MAXPRINTJOBS" target="_top">max print jobs = 100 </a></span></dt><dd><p>
    377 <a class="indexterm" name="id391165"></a>
     377<a class="indexterm" name="id391162"></a>
    378378                Sets the upper limit to 100 print jobs being active on the Samba server at any one time. Should a client
    379379                submit a job that exceeds this number, a "no more space available on server" type of error message will be
     
    381381                at all.
    382382                </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#PRINTCAPNAME" target="_top">printcap name = /etc/printcap </a></span></dt><dd><p>
    383 <a class="indexterm" name="id391197"></a>
    384 <a class="indexterm" name="id391204"></a>
    385 <a class="indexterm" name="id391210"></a>
     383<a class="indexterm" name="id391194"></a>
     384<a class="indexterm" name="id391201"></a>
     385<a class="indexterm" name="id391208"></a>
    386386                Tells Samba where to look for a list of available printer names. Where CUPS is used, make sure that a printcap
    387387                file is written. This is controlled by the <code class="constant">Printcap</code> directive in the
    388388                <code class="filename">cupsd.conf</code> file.
    389389        </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#PRINTERADMIN" target="_top">printer admin = @ntadmin </a></span></dt><dd><p>
    390 <a class="indexterm" name="id391246"></a>
    391 <a class="indexterm" name="id391252"></a>
    392 <a class="indexterm" name="id391259"></a>
    393 <a class="indexterm" name="id391266"></a>
     390<a class="indexterm" name="id391243"></a>
     391<a class="indexterm" name="id391249"></a>
     392<a class="indexterm" name="id391256"></a>
     393<a class="indexterm" name="id391263"></a>
    394394                Members of the ntadmin group should be able to add drivers and set printer properties
    395395                (<code class="constant">ntadmin</code> is only an example name; it needs to be a valid UNIX group name); root is
     
    400400                per-share parameter. This permits different groups to administer each printer share.
    401401        </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#LPQCACHETIME" target="_top">lpq cache time = 20 </a></span></dt><dd><p>
    402 <a class="indexterm" name="id391338"></a>
    403 <a class="indexterm" name="id391345"></a>
     402<a class="indexterm" name="id391336"></a>
     403<a class="indexterm" name="id391342"></a>
    404404                Controls the cache time for the results of the lpq command. It prevents the lpq command being called too often
    405405                and reduces the load on a heavily used print server.
    406406        </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#USECLIENTDRIVER" target="_top">use client driver = no </a></span></dt><dd><p>
    407 <a class="indexterm" name="id391372"></a>
     407<a class="indexterm" name="id391369"></a>
    408408                If set to <code class="constant">yes</code>, only takes effect for Windows NT/200x/XP clients (and not for Win
    409409                95/98/ME). Its default value is <code class="constant">No</code> (or <code class="constant">False</code>).  It must
     
    412412                explanations, see the <code class="filename">smb.conf</code> man page.
    413413        </p></dd></dl></div></div><div class="sect3" title="The [printers] Section"><div class="titlepage"><div><div><h4 class="title"><a name="ptrsect"></a>The [printers] Section</h4></div></div></div><p>
    414 <a class="indexterm" name="id391422"></a>
    415 <a class="indexterm" name="id391429"></a>
     414<a class="indexterm" name="id391419"></a>
     415<a class="indexterm" name="id391426"></a>
    416416The printers section is the second special section. If a section with this name appears in the <code class="filename">smb.conf</code>,
    417417users are able to connect to any printer specified in the Samba host's printcap file, because Samba on startup
     
    469469                </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#WRITABLE" target="_top">writable = no </a></span></dt><dd><p>
    470470                Is a synonym for <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only = yes</a>.
    471                 </p></dd></dl></div></div><div class="sect3" title="Any [my_printer_name] Section"><div class="titlepage"><div><div><h4 class="title"><a name="id391782"></a>Any [my_printer_name] Section</h4></div></div></div><p>
    472 <a class="indexterm" name="id391790"></a>
    473 <a class="indexterm" name="id391796"></a>
     471                </p></dd></dl></div></div><div class="sect3" title="Any [my_printer_name] Section"><div class="titlepage"><div><div><h4 class="title"><a name="id391779"></a>Any [my_printer_name] Section</h4></div></div></div><p>
     472<a class="indexterm" name="id391787"></a>
     473<a class="indexterm" name="id391794"></a>
    474474If a <em class="parameter"><code>[my_printer_name]</code></em> section appears in the <code class="filename">smb.conf</code> file, which includes the
    475475parameter <a class="link" href="smb.conf.5.html#PRINTABLE" target="_top">printable = yes</a> Samba will configure it as a printer share.
     
    503503                </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok = no </a></span></dt><dd><p>
    504504                This printer is not open for the guest account.
    505                 </p></dd></dl></div></div><div class="sect3" title="Print Commands"><div class="titlepage"><div><div><h4 class="title"><a name="id392055"></a>Print Commands</h4></div></div></div><p>
    506 <a class="indexterm" name="id392062"></a>
    507 <a class="indexterm" name="id392069"></a>
    508 <a class="indexterm" name="id392076"></a>
    509 <a class="indexterm" name="id392082"></a>
     505                </p></dd></dl></div></div><div class="sect3" title="Print Commands"><div class="titlepage"><div><div><h4 class="title"><a name="id392052"></a>Print Commands</h4></div></div></div><p>
     506<a class="indexterm" name="id392059"></a>
     507<a class="indexterm" name="id392066"></a>
     508<a class="indexterm" name="id392073"></a>
     509<a class="indexterm" name="id392080"></a>
    510510In each section defining a printer (or in the <em class="parameter"><code>[printers]</code></em> section),
    511511a <em class="parameter"><code>print command</code></em> parameter may be defined. It sets a command to process the files
     
    519519make sure you pay attention to the need to remove the files from the Samba spool directory. Otherwise,
    520520your hard disk may soon suffer from shortage of free space.
    521 </p></div><div class="sect3" title="Default UNIX System Printing Commands"><div class="titlepage"><div><div><h4 class="title"><a name="id392122"></a>Default UNIX System Printing Commands</h4></div></div></div><p>
    522 <a class="indexterm" name="id392130"></a>
     521</p></div><div class="sect3" title="Default UNIX System Printing Commands"><div class="titlepage"><div><div><h4 class="title"><a name="id392119"></a>Default UNIX System Printing Commands</h4></div></div></div><p>
     522<a class="indexterm" name="id392127"></a>
    523523You learned earlier that Samba, in most cases, uses its built-in settings for many parameters if it cannot
    524524find an explicitly stated one in its configuration file. The same is true for the <a class="link" href="smb.conf.5.html#PRINTCOMMAND" target="_top">print command</a>. The default print command varies depending on the <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> parameter
     
    529529of key printing options but excludes the special case of CUPS, is discussed in <a class="link" href="CUPS-printing.html" title="Chapter 22. CUPS Printing Support">CUPS Printing Support</a>.
    530530</p><div class="table"><a name="printOptions"></a><p class="title"><b>Table 21.1. Default Printing Settings</b></p><div class="table-contents"><table summary="Default Printing Settings" border="1"><colgroup><col align="left"><col align="left"></colgroup><thead><tr><th align="left">Setting</th><th align="left">Default Printing Commands</th></tr></thead><tbody><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = bsd|aix|lprng|plp</a></td><td align="left">print command is <code class="literal">lpr -r -P%p %s</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = sysv|hpux</a></td><td align="left">print command is <code class="literal">lp -c -P%p %s; rm %s</code></td></tr><tr><td align="left"> <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = qnx</a></td><td align="left">print command is <code class="literal">lp -r -P%p -s %s</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = bsd|aix|lprng|plp</a></td><td align="left">lpq command is <code class="literal">lpq -P%p</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = sysv|hpux</a></td><td align="left">lpq command is <code class="literal">lpstat -o%p</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = qnx</a></td><td align="left">lpq command is <code class="literal">lpq -P%p</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = bsd|aix|lprng|plp</a></td><td align="left">lprm command is <code class="literal">lprm -P%p %j</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = sysv|hpux</a></td><td align="left">lprm command is <code class="literal">cancel %p-%j</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = qnx</a></td><td align="left">lprm command is <code class="literal">cancel %p-%j</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = bsd|aix|lprng|plp</a></td><td align="left">lppause command is <code class="literal">lp -i %p-%j -H hold</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = sysv|hpux</a></td><td align="left">lppause command   (...is empty)</td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = qnx</a></td><td align="left">lppause command   (...is empty)</td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = bsd|aix|lprng|plp</a></td><td align="left">lpresume command is <code class="literal">lp -i %p-%j -H resume</code></td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = sysv|hpux</a></td><td align="left">lpresume command   (...is empty)</td></tr><tr><td align="left"><a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing = qnx</a></td><td align="left">lpresume command   (...is empty)</td></tr></tbody></table></div></div><br class="table-break"><p>
    531 <a class="indexterm" name="id392570"></a>
    532 <a class="indexterm" name="id392577"></a>
    533 <a class="indexterm" name="id392583"></a>
    534 <a class="indexterm" name="id392590"></a>
     531<a class="indexterm" name="id392567"></a>
     532<a class="indexterm" name="id392574"></a>
     533<a class="indexterm" name="id392581"></a>
     534<a class="indexterm" name="id392587"></a>
    535535For <em class="parameter"><code>printing = CUPS</code></em>, if Samba is compiled against libcups, it uses the CUPS API to
    536536submit jobs. (It is a good idea also to set <a class="link" href="smb.conf.5.html#PRINTCAP" target="_top">printcap = cups</a> in case your
     
    539539<code class="literal">lp -c -d%p -oraw; rm %s</code>. With <em class="parameter"><code>printing = cups</code></em>, and if Samba is
    540540compiled against libcups, any manually set print command will be ignored!
    541 </p></div><div class="sect3" title="Custom Print Commands"><div class="titlepage"><div><div><h4 class="title"><a name="id392638"></a>Custom Print Commands</h4></div></div></div><p>
    542 <a class="indexterm" name="id392646"></a>
    543 <a class="indexterm" name="id392653"></a>
     541</p></div><div class="sect3" title="Custom Print Commands"><div class="titlepage"><div><div><h4 class="title"><a name="id392635"></a>Custom Print Commands</h4></div></div></div><p>
     542<a class="indexterm" name="id392643"></a>
     543<a class="indexterm" name="id392650"></a>
    544544After a print job has finished spooling to a service, the <a class="link" href="smb.conf.5.html#PRINTCOMMAND" target="_top">print command</a> will be used
    545545by Samba via a system() call to process the spool file. Usually the command specified will submit the spool
     
    548548that the spool file is deleted after it has been processed.
    549549</p><p>
    550 <a class="indexterm" name="id392677"></a>
    551 <a class="indexterm" name="id392684"></a>
    552 <a class="indexterm" name="id392691"></a>
    553 <a class="indexterm" name="id392698"></a>
     550<a class="indexterm" name="id392675"></a>
     551<a class="indexterm" name="id392681"></a>
     552<a class="indexterm" name="id392688"></a>
     553<a class="indexterm" name="id392695"></a>
    554554There is no difficulty with using your own customized print commands with the traditional printing systems.
    555555However, if you do not wish to roll your own, you should be well informed about the default built-in commands
     
    561561printing, the following ones do have special relevance:
    562562</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><em class="parameter"><code>%s, %f</code></em>  the path to the spool file name.</p></li><li class="listitem"><p><em class="parameter"><code>%p</code></em>  the appropriate printer name.</p></li><li class="listitem"><p><em class="parameter"><code>%J</code></em>  the job name as transmitted by the client.</p></li><li class="listitem"><p><em class="parameter"><code>%c</code></em>  the number of printed pages of the spooled job (if known).</p></li><li class="listitem"><p><em class="parameter"><code>%z</code></em>  the size of the spooled print job (in bytes).</p></li></ul></div><p>
    563 <a class="indexterm" name="id392790"></a>
     563<a class="indexterm" name="id392787"></a>
    564564The print command must contain at least one occurrence of <em class="parameter"><code>%s</code></em> or
    565565<em class="parameter"><code>%f</code></em>. The <em class="parameter"><code>%p</code></em> is optional. If no printer name is supplied,
     
    567567sent to the default printer.
    568568</p><p>
    569 <a class="indexterm" name="id392823"></a>
    570 <a class="indexterm" name="id392830"></a>
     569<a class="indexterm" name="id392820"></a>
     570<a class="indexterm" name="id392827"></a>
    571571If specified in the <em class="parameter"><code>[global]</code></em> section, the print command given will be
    572572used for any printable service that does not have its own print command specified. If there is neither a
     
    574574but not processed! Most importantly, print files will not be removed, so they will consume disk space.
    575575</p><p>
    576 <a class="indexterm" name="id392849"></a>
    577 <a class="indexterm" name="id392856"></a>
     576<a class="indexterm" name="id392846"></a>
     577<a class="indexterm" name="id392853"></a>
    578578Printing may fail on some UNIX systems when using the <span class="emphasis"><em>nobody</em></span> account. If this happens, create an
    579579alternative guest account and give it the privilege to print. Set up this guest account in the
    580580<em class="parameter"><code>[global]</code></em> section with the <em class="parameter"><code>guest account</code></em> parameter.
    581581</p><p>
    582 <a class="indexterm" name="id392883"></a>
    583 <a class="indexterm" name="id392890"></a>
    584 <a class="indexterm" name="id392897"></a>
     582<a class="indexterm" name="id392880"></a>
     583<a class="indexterm" name="id392887"></a>
     584<a class="indexterm" name="id392894"></a>
    585585You can form quite complex print commands. You need to realize that print commands are just
    586586passed to a UNIX shell. The shell is able to expand the included environment variables as
     
    588588in the Samba print command is <em class="parameter"><code>%$variable</code></em>.) To give you a working
    589589<a class="link" href="smb.conf.5.html#PRINTCOMMAND" target="_top">print command</a> example, the following will log a print job
    590 to <code class="filename">/tmp/print.log</code>, print the file, then remove it. The semicolon (<span class="quote">&#8220;<span class="quote">;</span>&#8221;</span>
     590to <code class="filename">/tmp/print.log</code>, print the file, then remove it. The semicolon (<span class="quote">&#8220;<span class="quote">;</span>&#8221;</span>)
    591591is the usual separator for commands in shell scripts:
    592 </p><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="indexterm" name="id392947"></a><em class="parameter"><code>print command = echo Printing %s &gt;&gt; /tmp/print.log; lpr -P %p %s; rm %s</code></em></td></tr></table><p>
     592</p><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="indexterm" name="id392944"></a><em class="parameter"><code>print command = echo Printing %s &gt;&gt; /tmp/print.log; lpr -P %p %s; rm %s</code></em></td></tr></table><p>
    593593You may have to vary your own command considerably from this example depending on how you normally print
    594594files on your system. The default for the <a class="link" href="smb.conf.5.html#PRINTCOMMAND" target="_top">print command</a>
    595595parameter varies depending on the setting of the <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a>
    596596parameter. Another example is:
    597 </p><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="indexterm" name="id392993"></a><em class="parameter"><code>print command = /usr/local/samba/bin/myprintscript %p %s</code></em></td></tr></table></div></div></div><div class="sect1" title="Printing Developments Since Samba-2.2"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cups-msrpc"></a>Printing Developments Since Samba-2.2</h2></div></div></div><p>
    598 <a class="indexterm" name="id393020"></a>
    599 <a class="indexterm" name="id393026"></a>
    600 <a class="indexterm" name="id393033"></a>
     597</p><table border="0" summary="Simple list" class="simplelist"><tr><td><a class="indexterm" name="id392990"></a><em class="parameter"><code>print command = /usr/local/samba/bin/myprintscript %p %s</code></em></td></tr></table></div></div></div><div class="sect1" title="Printing Developments Since Samba-2.2"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="cups-msrpc"></a>Printing Developments Since Samba-2.2</h2></div></div></div><p>
     598<a class="indexterm" name="id393017"></a>
     599<a class="indexterm" name="id393023"></a>
     600<a class="indexterm" name="id393030"></a>
    601601Prior to Samba-2.2.x, print server support for Windows clients was limited to <span class="emphasis"><em>LanMan</em></span>
    602602printing calls. This is the same protocol level as Windows 9x/Me PCs offer when they share printers.
     
    607607The additional functionality provided by the new SPOOLSS support includes:
    608608</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    609 <a class="indexterm" name="id393063"></a>
     609<a class="indexterm" name="id393061"></a>
    610610        Support for downloading printer driver files to Windows 95/98/NT/2000 clients upon
    611611        demand (<span class="emphasis"><em>Point'n'Print</em></span>).
    612612        </p></li><li class="listitem"><p>
    613 <a class="indexterm" name="id393079"></a>
     613<a class="indexterm" name="id393076"></a>
    614614        Uploading of printer drivers via the Windows NT <span class="emphasis"><em>Add Printer Wizard</em></span> (APW)
    615615        or the <a class="ulink" href="http://imprints.sourceforge.net/" target="_top">Imprints</a> tool set.
    616616        </p></li><li class="listitem"><p>       
    617 <a class="indexterm" name="id393101"></a>
    618 <a class="indexterm" name="id393108"></a>
    619 <a class="indexterm" name="id393115"></a>
    620 <a class="indexterm" name="id393121"></a>
    621 <a class="indexterm" name="id393128"></a>
     617<a class="indexterm" name="id393098"></a>
     618<a class="indexterm" name="id393105"></a>
     619<a class="indexterm" name="id393112"></a>
     620<a class="indexterm" name="id393119"></a>
     621<a class="indexterm" name="id393126"></a>
    622622        Support for the native MS-RPC printing calls such as StartDocPrinter, EnumJobs(), and so on. (See the
    623623        <a class="ulink" href="http://msdn.microsoft.com/" target="_top">MSDN documentation</a> for more information on the
    624624        Win32 printing API).
    625625        </p></li><li class="listitem"><p>
    626 <a class="indexterm" name="id393147"></a>
    627 <a class="indexterm" name="id393153"></a>
     626<a class="indexterm" name="id393144"></a>
     627<a class="indexterm" name="id393151"></a>
    628628        Support for NT Access Control Lists (ACL) on printer objects.
    629629        </p></li><li class="listitem"><p>
    630 <a class="indexterm" name="id393165"></a>
     630<a class="indexterm" name="id393162"></a>
    631631        Improved support for printer queue manipulation through the use of internal databases for spooled
    632632        job information (implemented by various <code class="filename">*.tdb</code> files).
    633633        </p></li></ul></div><p>
    634 <a class="indexterm" name="id393183"></a>
    635 <a class="indexterm" name="id393190"></a>
     634<a class="indexterm" name="id393181"></a>
     635<a class="indexterm" name="id393187"></a>
    636636A benefit of updating is that Samba-3 is able to publish its printers to Active Directory (or LDAP).
    637637</p><p>
    638 <a class="indexterm" name="id393201"></a>
     638<a class="indexterm" name="id393198"></a>
    639639A fundamental difference exists between MS Windows NT print servers and Samba operation. Windows NT
    640640permits the installation of local printers that are not shared. This is an artifact of the fact that
     
    642642printers that are made available, either by default or by specific declaration via printer-specific shares.
    643643</p><p>
    644 <a class="indexterm" name="id393214"></a>
    645 <a class="indexterm" name="id393221"></a>
    646 <a class="indexterm" name="id393228"></a>
    647 <a class="indexterm" name="id393235"></a>
    648 <a class="indexterm" name="id393241"></a>
     644<a class="indexterm" name="id393212"></a>
     645<a class="indexterm" name="id393218"></a>
     646<a class="indexterm" name="id393225"></a>
     647<a class="indexterm" name="id393232"></a>
     648<a class="indexterm" name="id393239"></a>
    649649Windows NT/200x/XP Professional clients do not have to use the standard SMB printer share; they can
    650650print directly to any printer on another Windows NT host using MS-RPC. This, of course, assumes that
     
    653653<span class="emphasis"><em>Everyone</em></span> group. (The older clients of type Windows 9x/Me can only print to shared
    654654printers.)
    655 </p><div class="sect2" title="Point'n'Print Client Drivers on Samba Servers"><div class="titlepage"><div><div><h3 class="title"><a name="id393257"></a>Point'n'Print Client Drivers on Samba Servers</h3></div></div></div><p>
    656 <a class="indexterm" name="id393265"></a>
     655</p><div class="sect2" title="Point'n'Print Client Drivers on Samba Servers"><div class="titlepage"><div><div><h3 class="title"><a name="id393254"></a>Point'n'Print Client Drivers on Samba Servers</h3></div></div></div><p>
     656<a class="indexterm" name="id393262"></a>
    657657There is much confusion about what all this means. The question is often asked, <span class="quote">&#8220;<span class="quote">Is it or is
    658658it not necessary for printer drivers to be installed on a Samba host in order to support printing from
    659659Windows clients?</span>&#8221;</span> The answer to this is no, it is not necessary.
    660660</p><p>
    661 <a class="indexterm" name="id393281"></a>
    662 <a class="indexterm" name="id393288"></a>
     661<a class="indexterm" name="id393278"></a>
     662<a class="indexterm" name="id393285"></a>
    663663Windows NT/2000 clients can, of course, also run their APW to install drivers <span class="emphasis"><em>locally</em></span>
    664664(which then connect to a Samba-served print queue). This is the same method used by Windows 9x/Me
     
    666666require that the Samba server possess a valid driver for the printer. This was fixed in Samba 2.2.1).
    667667</p><p>
    668 <a class="indexterm" name="id393304"></a>
    669 <a class="indexterm" name="id393311"></a>
     668<a class="indexterm" name="id393302"></a>
     669<a class="indexterm" name="id393309"></a>
    670670But it is a new capability to install the printer drivers into the <em class="parameter"><code>[print$]</code></em>
    671671share of the Samba server, and a big convenience, too. Then <span class="emphasis"><em>all</em></span> clients
     
    683683        Using <span class="emphasis"><em>cupsaddsmb</em></span> (only works for the CUPS printing system, not for LPR/LPD, LPRng, and so on).
    684684        </p></li></ul></div><p>
    685 <a class="indexterm" name="id393388"></a>
    686 <a class="indexterm" name="id393395"></a>
     685<a class="indexterm" name="id393385"></a>
     686<a class="indexterm" name="id393392"></a>
    687687Samba does not use these uploaded drivers in any way to process spooled files. These drivers are utilized
    688688entirely by the clients who download and install them via the <span class="quote">&#8220;<span class="quote">Point'n'Print</span>&#8221;</span> mechanism
     
    690690(or the UNIX print system) requires. Print files received by Samba are handed over to the UNIX printing
    691691system, which is responsible for all further processing, as needed.
    692 </p></div><div class="sect2" title="The Obsoleted [printer$] Section"><div class="titlepage"><div><div><h3 class="title"><a name="id393411"></a>The Obsoleted [printer$] Section</h3></div></div></div><p>
    693 <a class="indexterm" name="id393419"></a>
    694 <a class="indexterm" name="id393426"></a>
     692</p></div><div class="sect2" title="The Obsoleted [printer$] Section"><div class="titlepage"><div><div><h3 class="title"><a name="id393408"></a>The Obsoleted [printer$] Section</h3></div></div></div><p>
     693<a class="indexterm" name="id393416"></a>
     694<a class="indexterm" name="id393423"></a>
    695695        Versions of Samba prior to 2.2 made it possible to use a share named <em class="parameter"><code>[printer$]</code></em>. This
    696696        name was taken from the same named service created by Windows 9x/Me clients when a printer was shared by them.
     
    702702        be sent to the client.
    703703        </p><p>
    704 <a class="indexterm" name="id393465"></a>
    705 <a class="indexterm" name="id393471"></a>
    706 <a class="indexterm" name="id393478"></a>
     704<a class="indexterm" name="id393462"></a>
     705<a class="indexterm" name="id393469"></a>
     706<a class="indexterm" name="id393476"></a>
    707707        These parameters, including the <em class="parameter"><code>printer driver file</code></em> parameter,
    708708        are now removed and cannot be used in installations of Samba-3. The share name
     
    714714        9x/Me clients are now thrown aside. They can use Samba's <em class="parameter"><code>[print$]</code></em>
    715715        share support just fine.
    716         </p></div><div class="sect2" title="Creating the [print$] Share"><div class="titlepage"><div><div><h3 class="title"><a name="id393521"></a>Creating the [print$] Share</h3></div></div></div><p>
    717 <a class="indexterm" name="id393529"></a>
     716        </p></div><div class="sect2" title="Creating the [print$] Share"><div class="titlepage"><div><div><h3 class="title"><a name="id393519"></a>Creating the [print$] Share</h3></div></div></div><p>
     717<a class="indexterm" name="id393526"></a>
    718718In order to support the uploading and downloading of printer driver files, you must first configure a
    719719file share named <em class="parameter"><code>[print$]</code></em>. The public name of this share is hard coded
     
    725725as <a class="link" href="smb.conf.5.html#PATH" target="_top">path</a>, are arbitrary and should be replaced with appropriate values for your
    726726site). See <a class="link" href="classicalprinting.html#prtdollar" title="Example 21.3. [print$] Example">[print\$] Example</a>.
    727 </p><div class="example"><a name="prtdollar"></a><p class="title"><b>Example 21.3. [print$] Example</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td># members of the ntadmin group should be able to add drivers and set</td></tr><tr><td># printer properties. root is implicitly always a 'printer admin'.</td></tr><tr><td><a class="indexterm" name="id393606"></a><em class="parameter"><code>printer admin = @ntadmin</code></em></td></tr><tr><td># ...</td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[printers]</code></em></td></tr><tr><td># ...</td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[print$]</code></em></td></tr><tr><td><a class="indexterm" name="id393642"></a><em class="parameter"><code>comment = Printer Driver Download Area</code></em></td></tr><tr><td><a class="indexterm" name="id393654"></a><em class="parameter"><code>path = /etc/samba/drivers</code></em></td></tr><tr><td><a class="indexterm" name="id393665"></a><em class="parameter"><code>browseable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id393677"></a><em class="parameter"><code>guest ok = yes</code></em></td></tr><tr><td><a class="indexterm" name="id393688"></a><em class="parameter"><code>read only = yes</code></em></td></tr><tr><td><a class="indexterm" name="id393700"></a><em class="parameter"><code>write list = @ntadmin, root</code></em></td></tr></table></div></div><br class="example-break"><p>
     727</p><div class="example"><a name="prtdollar"></a><p class="title"><b>Example 21.3. [print$] Example</b></p><div class="example-contents"><table border="0" summary="Simple list" class="simplelist"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td># members of the ntadmin group should be able to add drivers and set</td></tr><tr><td># printer properties. root is implicitly always a 'printer admin'.</td></tr><tr><td><a class="indexterm" name="id393603"></a><em class="parameter"><code>printer admin = @ntadmin</code></em></td></tr><tr><td># ...</td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[printers]</code></em></td></tr><tr><td># ...</td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[print$]</code></em></td></tr><tr><td><a class="indexterm" name="id393639"></a><em class="parameter"><code>comment = Printer Driver Download Area</code></em></td></tr><tr><td><a class="indexterm" name="id393651"></a><em class="parameter"><code>path = /etc/samba/drivers</code></em></td></tr><tr><td><a class="indexterm" name="id393663"></a><em class="parameter"><code>browseable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id393674"></a><em class="parameter"><code>guest ok = yes</code></em></td></tr><tr><td><a class="indexterm" name="id393686"></a><em class="parameter"><code>read only = yes</code></em></td></tr><tr><td><a class="indexterm" name="id393697"></a><em class="parameter"><code>write list = @ntadmin, root</code></em></td></tr></table></div></div><br class="example-break"><p>
    728728Of course, you also need to ensure that the directory named by the
    729729<a class="link" href="smb.conf.5.html#PATH" target="_top">path</a> parameter exists on the UNIX file system.
    730 </p></div><div class="sect2" title="[print$] Stanza Parameters"><div class="titlepage"><div><div><h3 class="title"><a name="id393729"></a>[print$] Stanza Parameters</h3></div></div></div><p>
    731 <a class="indexterm" name="id393737"></a>
    732 <a class="indexterm" name="id393743"></a>
    733 <a class="indexterm" name="id393750"></a>
    734 <a class="indexterm" name="id393757"></a>
    735 <a class="indexterm" name="id393764"></a>
     730</p></div><div class="sect2" title="[print$] Stanza Parameters"><div class="titlepage"><div><div><h3 class="title"><a name="id393726"></a>[print$] Stanza Parameters</h3></div></div></div><p>
     731<a class="indexterm" name="id393734"></a>
     732<a class="indexterm" name="id393741"></a>
     733<a class="indexterm" name="id393748"></a>
     734<a class="indexterm" name="id393754"></a>
     735<a class="indexterm" name="id393761"></a>
    736736The <em class="parameter"><code>[print$]</code></em> is a special section in <code class="filename">smb.conf</code>. It contains settings relevant to
    737737potential printer driver download and is used by Windows clients for local print driver installation.
     
    750750</pre><p>
    751751                 you can still mount it from any client. This can also be done from the
    752                 <span class="guimenu">Connect network drive menu&gt;</span> from Windows Explorer.
     752                <span class="guimenu">Connect network drive</span> menu from Windows Explorer.
    753753                </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#GUESTOK" target="_top">guest ok = yes </a></span></dt><dd><p>
    754754                Gives read-only access to this share for all guest users. Access may be granted to
     
    778778                be mentioned in the global <a class="link" href="smb.conf.5.html#PRINTERADMIN" target="_top">printer admin</a>
    779779                parameter. See the <code class="filename">smb.conf</code> man page for more information on configuring file shares.
    780                 </p></dd></dl></div></div><div class="sect2" title="The [print$] Share Directory"><div class="titlepage"><div><div><h3 class="title"><a name="id394022"></a>The [print$] Share Directory</h3></div></div></div><p>
     780                </p></dd></dl></div></div><div class="sect2" title="The [print$] Share Directory"><div class="titlepage"><div><div><h3 class="title"><a name="id394019"></a>The [print$] Share Directory</h3></div></div></div><p>
    781781In order for a Windows NT print server to support the downloading of driver files by multiple client
    782782architectures, you must create several subdirectories within the <em class="parameter"><code>[print$]</code></em>
     
    813813have located the server, navigate to its <span class="guiicon">Printers and Faxes</span> folder. You should see
    814814an initial listing of printers that matches the printer shares defined on your Samba host.
    815 </p></div></div><div class="sect1" title="Installing Drivers into [print$]"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id394150"></a>Installing Drivers into [print$]</h2></div></div></div><p>
     815</p></div></div><div class="sect1" title="Installing Drivers into [print$]"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id394148"></a>Installing Drivers into [print$]</h2></div></div></div><p>
    816816Have you successfully created the <em class="parameter"><code>[print$]</code></em> share in <code class="filename">smb.conf</code>, and have you forced
    817817Samba to reread its <code class="filename">smb.conf</code> file? Good. But you are not yet ready to use the new facility. The client
     
    829829        </p></li></ul></div><p>
    830830The latter option is probably the easier one (even if the process may seem a little bit weird at first).
    831 </p><div class="sect2" title="Add Printer Wizard Driver Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id394235"></a>Add Printer Wizard Driver Installation</h3></div></div></div><p>
     831</p><div class="sect2" title="Add Printer Wizard Driver Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id394232"></a>Add Printer Wizard Driver Installation</h3></div></div></div><p>
    832832The printers initially listed in the Samba host's <span class="guiicon">Printers</span> folder accessed from a
    833833client's Explorer will have no real printer driver assigned to them. By default this driver name is set
     
    880880        </p></li></ol></div><p>
    881881We provide detailed hints for each of these steps in the paragraphs that follow.
    882 </p><div class="sect3" title="Identifying Driver Files"><div class="titlepage"><div><div><h4 class="title"><a name="id394487"></a>Identifying Driver Files</h4></div></div></div><p>
    883 <a class="indexterm" name="id394494"></a>
    884 <a class="indexterm" name="id394501"></a>
    885 <a class="indexterm" name="id394508"></a>
     882</p><div class="sect3" title="Identifying Driver Files"><div class="titlepage"><div><div><h4 class="title"><a name="id394484"></a>Identifying Driver Files</h4></div></div></div><p>
     883<a class="indexterm" name="id394492"></a>
     884<a class="indexterm" name="id394498"></a>
     885<a class="indexterm" name="id394505"></a>
    886886To find out about the driver files, you have two options. You can check the contents of the driver
    887887CDROM that came with your printer. Study the <code class="filename">*.inf</code> files located on the CD-ROM. This
     
    891891extremely difficult to identify the driver files required.
    892892</p><p>
    893 <a class="indexterm" name="id394537"></a>
     893<a class="indexterm" name="id394532"></a>
    894894Then you have the second option. Install the driver locally on a Windows client and
    895895investigate which filenames and paths it uses after they are installed. (You need to repeat
     
    898898clients.)
    899899</p><p>
    900 <a class="indexterm" name="id394556"></a>
     900<a class="indexterm" name="id394550"></a>
    901901A good method to recognize the driver files is to print the test page from the driver's
    902902<span class="guilabel">Properties</span> dialog (<span class="guilabel">General</span> tab). Then look at the list of
     
    906906(this may vary slightly for Windows NT). You need to note all filenames for the next steps.
    907907</p><p>
    908 <a class="indexterm" name="id394610"></a>
    909 <a class="indexterm" name="id394616"></a>
    910 <a class="indexterm" name="id394623"></a>
     908<a class="indexterm" name="id394604"></a>
     909<a class="indexterm" name="id394611"></a>
     910<a class="indexterm" name="id394618"></a>
    911911Another method to quickly test the driver filenames and related paths is provided by the
    912912<code class="literal">rpcclient</code> utility. Run it with <code class="literal">enumdrivers</code> or with the
     
    949949  Defaultdatatype: []
    950950</pre><p>
    951 <a class="indexterm" name="id394731"></a>
    952 <a class="indexterm" name="id394738"></a>
    953 <a class="indexterm" name="id394745"></a>
    954 <a class="indexterm" name="id394752"></a>
     951<a class="indexterm" name="id394726"></a>
     952<a class="indexterm" name="id394732"></a>
     953<a class="indexterm" name="id394739"></a>
     954<a class="indexterm" name="id394746"></a>
    955955You may notice that this driver has quite a large number of <span class="guilabel">Dependent files</span>
    956956(there are worse cases, however). Also, strangely, the
     
    962962Windows PC. This PC can also host the Windows 9x/Me drivers, even if it runs on Windows NT, 2000, or XP.
    963963</p><p>
    964 <a class="indexterm" name="id394796"></a>
    965 <a class="indexterm" name="id394802"></a>
    966 <a class="indexterm" name="id394809"></a>
     964<a class="indexterm" name="id394790"></a>
     965<a class="indexterm" name="id394797"></a>
    967966Since the <em class="parameter"><code>[print$]</code></em> share is usually accessible through the <span class="guiicon">Network
    968967Neighborhood</span>, you can also use the UNC notation from Windows Explorer to poke at it. The Windows
     
    975974the Admin), its native mode for printer drivers is user mode execution. This requires drivers designed
    976975for this purpose. These types of drivers install into the <span class="quote">&#8220;<span class="quote">3</span>&#8221;</span> subdirectory.
    977 </p></div></div><div class="sect3" title="Obtaining Driver Files from Windows Client [print$] Shares"><div class="titlepage"><div><div><h4 class="title"><a name="id394866"></a>Obtaining Driver Files from Windows Client [print$] Shares</h4></div></div></div><p>
     976</p></div></div><div class="sect3" title="Obtaining Driver Files from Windows Client [print$] Shares"><div class="titlepage"><div><div><h4 class="title"><a name="id394855"></a>Obtaining Driver Files from Windows Client [print$] Shares</h4></div></div></div><p>
    978977Now we need to collect all the driver files we identified in our previous step. Where do we get them
    979978from? Well, why not retrieve them from the very PC and the same <em class="parameter"><code>[print$]</code></em>
     
    1000999<code class="literal">smbclient</code> exits again.
    10011000</p><p>
    1002 <a class="indexterm" name="id394964"></a>
     1001<a class="indexterm" name="id394953"></a>
    10031002Remember to repeat the procedure for the <span class="application">WIN40</span> architecture should you need to
    10041003support Windows 9x/Me/XP clients. Remember too, the files for these architectures are in the
    10051004<code class="filename">WIN40/0/</code> subdirectory. Once this is complete, we can run <code class="literal">smbclient. .
    10061005.put</code> to store the collected files on the Samba server's <em class="parameter"><code>[print$]</code></em> share.
    1007 </p></div><div class="sect3" title="Installing Driver Files into [print$]"><div class="titlepage"><div><div><h4 class="title"><a name="id394999"></a>Installing Driver Files into [print$]</h4></div></div></div><p>
     1006</p></div><div class="sect3" title="Installing Driver Files into [print$]"><div class="titlepage"><div><div><h4 class="title"><a name="id394988"></a>Installing Driver Files into [print$]</h4></div></div></div><p>
    10081007We are now going to locate the driver files into the <em class="parameter"><code>[print$]</code></em> share. Remember, the
    10091008UNIX path to this share has been defined previously in your <code class="filename">smb.conf</code> file. You also have created
     
    10181017        (yet) into the <code class="filename">0</code> subdirectory.
    10191018        </p></li></ul></div><p>
    1020 <a class="indexterm" name="id395073"></a>
    1021 <a class="indexterm" name="id395080"></a>
     1019<a class="indexterm" name="id395062"></a>
     1020<a class="indexterm" name="id395069"></a>
    10221021We again use smbclient to transfer the driver files across the network. We specify the same files
    10231022and paths as were leaked to us by running <code class="literal">getdriver</code> against the original
     
    10561055putting file HDNIS01_de.NTF as \W32X86\HDNIS01_de.NTF
    10571056</pre><p>
    1058 <a class="indexterm" name="id395146"></a>
    1059 <a class="indexterm" name="id395153"></a>
    1060 <a class="indexterm" name="id395160"></a>
     1057<a class="indexterm" name="id395126"></a>
     1058<a class="indexterm" name="id395133"></a>
     1059<a class="indexterm" name="id395140"></a>
    10611060Whew  that was a lot of typing! Most drivers are a lot smaller  many have only three generic
    10621061PostScript driver files plus one PPD. While we did retrieve the files from the <code class="filename">2</code>
     
    10651064<code class="literal">adddriver</code> command, which we will run shortly (and do not forget to also put the files
    10661065for the Windows 9x/Me architecture into the <code class="filename">WIN40/</code> subdirectory should you need them).
    1067 </p></div><div class="sect3" title="smbclient to Confirm Driver Installation"><div class="titlepage"><div><div><h4 class="title"><a name="id395202"></a><code class="literal">smbclient</code> to Confirm Driver Installation</h4></div></div></div><p>
    1068 <a class="indexterm" name="id395214"></a>
    1069 <a class="indexterm" name="id395221"></a>
     1066</p></div><div class="sect3" title="smbclient to Confirm Driver Installation"><div class="titlepage"><div><div><h4 class="title"><a name="id395182"></a><code class="literal">smbclient</code> to Confirm Driver Installation</h4></div></div></div><p>
     1067<a class="indexterm" name="id395194"></a>
     1068<a class="indexterm" name="id395201"></a>
    10701069For now we verify that our files are there. This can be done with <code class="literal">smbclient</code>, too
    10711070(but, of course, you can log in via SSH also and do this through a standard UNIX shell access):
     
    11081107              40976 blocks of size 262144. 709 blocks available
    11091108</pre><p>
    1110 <a class="indexterm" name="id395275"></a>
    1111 <a class="indexterm" name="id395282"></a>
    1112 <a class="indexterm" name="id395288"></a>
     1109<a class="indexterm" name="id395255"></a>
     1110<a class="indexterm" name="id395261"></a>
     1111<a class="indexterm" name="id395268"></a>
    11131112Notice that there are already driver files present in the <code class="filename">2</code> subdirectory (probably from a
    11141113previous installation). Once the files for the new driver are there too, you are still a few steps away from
     
    11181117special, namely <span class="emphasis"><em>printer driver files</em></span>, and it does not know to which print queue(s) these
    11191118driver files belong.
    1120 </p></div><div class="sect3" title="Running rpcclient with adddriver"><div class="titlepage"><div><div><h4 class="title"><a name="id395312"></a>Running <code class="literal">rpcclient</code> with <code class="literal">adddriver</code></h4></div></div></div><p>
    1121 <a class="indexterm" name="id395330"></a>
    1122 <a class="indexterm" name="id395337"></a>
    1123 <a class="indexterm" name="id395344"></a>
     1119</p></div><div class="sect3" title="Running rpcclient with adddriver"><div class="titlepage"><div><div><h4 class="title"><a name="id395292"></a>Running <code class="literal">rpcclient</code> with <code class="literal">adddriver</code></h4></div></div></div><p>
     1120<a class="indexterm" name="id395310"></a>
     1121<a class="indexterm" name="id395317"></a>
     1122<a class="indexterm" name="id395324"></a>
    11241123Next, you must tell Samba about the special category of the files you just uploaded into the
    11251124<em class="parameter"><code>[print$]</code></em> share. This is done by the <code class="literal">adddriver</code>
     
    11451144Printer Driver dm9110 successfully installed.
    11461145</pre><p>
    1147 <a class="indexterm" name="id395390"></a>
    1148 <a class="indexterm" name="id395396"></a>
    1149 <a class="indexterm" name="id395403"></a>
     1146<a class="indexterm" name="id395369"></a>
     1147<a class="indexterm" name="id395376"></a>
     1148<a class="indexterm" name="id395383"></a>
    11501149After this step, the driver should be recognized by Samba on the print server. You need to be very
    11511150careful when typing the command. Don't exchange the order of the fields. Some changes would lead to
     
    11541153Hints about the syntax of the adddriver command are in the man page.
    11551154provides a more detailed description, should you need it.
    1156 </p></div><div class="sect3" title="Checking adddriver Completion"><div class="titlepage"><div><div><h4 class="title"><a name="id395422"></a>Checking <code class="literal">adddriver</code> Completion</h4></div></div></div><p>
     1155</p></div><div class="sect3" title="Checking adddriver Completion"><div class="titlepage"><div><div><h4 class="title"><a name="id395402"></a>Checking <code class="literal">adddriver</code> Completion</h4></div></div></div><p>
    11571156One indication for Samba's recognition of the files as driver files is the <code class="computeroutput">successfully
    11581157installed</code> message. Another one is the fact that our files have been moved by the
     
    11991198Another verification is that the timestamp of the printing TDB files is now updated
    12001199(and possibly their file size has increased).
    1201 </p></div><div class="sect3" title="Check Samba for Driver Recognition"><div class="titlepage"><div><div><h4 class="title"><a name="id395502"></a>Check Samba for Driver Recognition</h4></div></div></div><p>
    1202 <a class="indexterm" name="id395510"></a>
     1200</p></div><div class="sect3" title="Check Samba for Driver Recognition"><div class="titlepage"><div><div><h4 class="title"><a name="id395482"></a>Check Samba for Driver Recognition</h4></div></div></div><p>
     1201<a class="indexterm" name="id395490"></a>
    12031202Now the driver should be registered with Samba. We can easily verify this and will do so in a
    12041203moment. However, this driver is not yet associated with a particular printer. We may check the driver
    12051204status of the files by at least three methods:
    12061205</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    1207 <a class="indexterm" name="id395525"></a>
     1206<a class="indexterm" name="id395505"></a>
     1207<a class="indexterm" name="id395512"></a>
     1208<a class="indexterm" name="id395519"></a>
     1209<a class="indexterm" name="id395526"></a>
    12081210<a class="indexterm" name="id395532"></a>
    1209 <a class="indexterm" name="id395539"></a>
    1210 <a class="indexterm" name="id395546"></a>
    1211 <a class="indexterm" name="id395553"></a>
    12121211        From any Windows client browse Network Neighborhood, find the Samba host, and open the Samba
    12131212        <span class="guiicon">Printers and Faxes</span> folder. Select any printer icon, right-click and select
     
    12191218        the list will differ if you look at it from Windows95/98/ME or Windows NT/2000/XP.)
    12201219        </p></li><li class="listitem"><p>
    1221 <a class="indexterm" name="id395591"></a>
     1220<a class="indexterm" name="id395566"></a>
    12221221        From a Windows 200x/XP client (not Windows NT) browse <span class="guiicon">Network Neighborhood</span>,
    12231222        search for the Samba server, open the server's <span class="guiicon">Printers</span> folder,
     
    12481247        95, 98, and Me</span>, you'll have to repeat the whole procedure with the WIN40 architecture
    12491248        and subdirectory.
    1250         </p></li></ul></div></div><div class="sect3" title="Specific Driver Name Flexibility"><div class="titlepage"><div><div><h4 class="title"><a name="id395712"></a>Specific Driver Name Flexibility</h4></div></div></div><p>
    1251 <a class="indexterm" name="id395720"></a>
     1249        </p></li></ul></div></div><div class="sect3" title="Specific Driver Name Flexibility"><div class="titlepage"><div><div><h4 class="title"><a name="id395688"></a>Specific Driver Name Flexibility</h4></div></div></div><p>
     1250<a class="indexterm" name="id395696"></a>
    12521251You can name the driver as you like. If you repeat the <code class="literal">adddriver</code> step with the same
    12531252files as before but with a different driver name, it will work the same:
     
    12721271Printer Driver mydrivername successfully installed.
    12731272</pre><p>
    1274 <a class="indexterm" name="id395759"></a>
    1275 <a class="indexterm" name="id395766"></a>
    1276 <a class="indexterm" name="id395772"></a>
     1273<a class="indexterm" name="id395735"></a>
     1274<a class="indexterm" name="id395742"></a>
     1275<a class="indexterm" name="id395748"></a>
    12771276You will be able to bind that driver to any print queue (however, you are responsible that
    12781277you associate drivers to queues that make sense with respect to target printers). You cannot run the
     
    12811280respective subdirectories, so you must execute an <code class="literal">smbclient ... put</code> command before
    12821281each <code class="literal">rpcclient ... adddriver</code> command.
    1283 </p></div><div class="sect3" title="Running rpcclient with setdriver"><div class="titlepage"><div><div><h4 class="title"><a name="id395814"></a>Running <code class="literal">rpcclient</code> with <code class="literal">setdriver</code></h4></div></div></div><p>
    1284 <a class="indexterm" name="id395832"></a>
    1285 <a class="indexterm" name="id395839"></a>
     1282</p></div><div class="sect3" title="Running rpcclient with setdriver"><div class="titlepage"><div><div><h4 class="title"><a name="id395790"></a>Running <code class="literal">rpcclient</code> with <code class="literal">setdriver</code></h4></div></div></div><p>
     1283<a class="indexterm" name="id395808"></a>
     1284<a class="indexterm" name="id395815"></a>
    12861285Samba needs to know which printer owns which driver. Create a mapping of the driver to a printer, and
    12871286store this information in Samba's memory, the TDB files. The <code class="literal">rpcclient setdriver</code> command
     
    13101309or at least send an HUP signal to all running smbd processes to work around this: <strong class="userinput"><code>kill -HUP
    13111310`pidof smbd`</code></strong>.
    1312 </p></div></div></div></div><div class="sect1" title="Client Driver Installation Procedure"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id395945"></a>Client Driver Installation Procedure</h2></div></div></div><p>
     1311</p></div></div></div></div><div class="sect1" title="Client Driver Installation Procedure"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id395921"></a>Client Driver Installation Procedure</h2></div></div></div><p>
    13131312As Don Quixote said, <span class="quote">&#8220;<span class="quote">The proof of the pudding is in the eating.</span>&#8221;</span> The proof
    13141313for our setup lies in the printing. So let's install the printer driver onto the client PCs. This is
    13151314not as straightforward as it may seem. Read on.
    1316 </p><div class="sect2" title="First Client Driver Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id395960"></a>First Client Driver Installation</h3></div></div></div><p>
     1315</p><div class="sect2" title="First Client Driver Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id395936"></a>First Client Driver Installation</h3></div></div></div><p>
    13171316Especially important is the installation onto the first client PC (for each architectural platform
    13181317separately). Once this is done correctly, all further clients are easy to set up and shouldn't need further
     
    13481347and Faxes</span>).
    13491348</p><p>
    1350 <a class="indexterm" name="id396120"></a>
     1349<a class="indexterm" name="id396093"></a>
    13511350Most likely you are tempted to try to print a test page. After all, you now can open the printer
    13521351properties, and on the <span class="guimenu">General</span> tab there is a button offering to do just that. But
     
    13601359For a printer to be truly usable by a Windows NT/200x/XP client, it must possess:
    13611360</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    1362 <a class="indexterm" name="id396176"></a>
     1361<a class="indexterm" name="id396148"></a>
    13631362        A valid <span class="emphasis"><em>device mode</em></span> generated by the driver for the printer (defining things
    13641363        like paper size, orientation and duplex settings).
    13651364        </p></li><li class="listitem"><p>
    1366 <a class="indexterm" name="id396192"></a>
     1365<a class="indexterm" name="id396164"></a>
    13671366        A complete set of <span class="emphasis"><em>printer driver data</em></span> generated by the driver.
    13681367        </p></li></ul></div><p>
    1369 <a class="indexterm" name="id396207"></a>
    1370 <a class="indexterm" name="id396214"></a>
    1371 <a class="indexterm" name="id396220"></a>
    1372 <a class="indexterm" name="id396227"></a>
    1373 <a class="indexterm" name="id396234"></a>
     1368<a class="indexterm" name="id396179"></a>
     1369<a class="indexterm" name="id396186"></a>
     1370<a class="indexterm" name="id396193"></a>
     1371<a class="indexterm" name="id396199"></a>
     1372<a class="indexterm" name="id396206"></a>
    13741373If either of these is incomplete, the clients can produce less than optimal output at best. In the
    13751374worst cases, unreadable garbage or nothing at all comes from the printer, or it produces a harvest of
     
    13971396effect to happen and feeds back the new device mode to our Samba server. You can use the native Windows
    13981397NT/200x/XP printer properties page from a Window client for this:
    1399 </p><div class="procedure" title="Procedure 21.1. Procedure to Initialize the Printer Driver Settings"><a name="id396308"></a><p class="title"><b>Procedure 21.1. Procedure to Initialize the Printer Driver Settings</b></p><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
     1398</p><div class="procedure" title="Procedure 21.1. Procedure to Initialize the Printer Driver Settings"><a name="id396280"></a><p class="title"><b>Procedure 21.1. Procedure to Initialize the Printer Driver Settings</b></p><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
    14001399        Browse the <span class="guiicon">Network Neighborhood</span>.
    14011400        </p></li><li class="step" title="Step 2"><p>
     
    14271426folder, too, if you are a Samba printer admin user. From now on, printing should work as expected.
    14281427</p><p>
    1429 <a class="indexterm" name="id396452"></a>
     1428<a class="indexterm" name="id396424"></a>
    14301429Samba includes a service-level parameter name <em class="parameter"><code>default devmode</code></em> for generating a default
    14311430device mode for a printer. Some drivers function well with Samba's default set of properties. Others
    14321431may crash the client's spooler service. So use this parameter with caution. It is always better to have
    14331432the client generate a valid device mode for the printer and store it on the server for you.
    1434 </p></div><div class="sect2" title="Additional Client Driver Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id396470"></a>Additional Client Driver Installation</h3></div></div></div><p>
    1435 <a class="indexterm" name="id396478"></a>
     1433</p></div><div class="sect2" title="Additional Client Driver Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id396442"></a>Additional Client Driver Installation</h3></div></div></div><p>
     1434<a class="indexterm" name="id396450"></a>
    14361435Every additional driver may be installed in the same way as just described.  Browse <code class="literal">Network
    14371436Neighborhood</code>, open the <span class="guiicon">Printers</span> folder on Samba server, right-click on
     
    14461445</pre><p>
    14471446or this command on Windows NT 4.0 workstations:
    1448 <a class="indexterm" name="id396539"></a>
     1447<a class="indexterm" name="id396511"></a>
    14491448</p><pre class="screen">
    14501449<strong class="userinput"><code>rundll32 shell32.dll,Control_RunDLL MAIN.CPL @2</code></strong>
     
    14531452You can enter the commands either inside a <span class="guilabel">DOS box</span> window or in the <span class="guimenuitem">Run
    14541453command...</span> field from the <span class="guimenu">Start</span> menu.
    1455 </p></div><div class="sect2" title="Always Make First Client Connection as root or &#8220;printer admin&#8221;"><div class="titlepage"><div><div><h3 class="title"><a name="id396581"></a>Always Make First Client Connection as root or <span class="quote">&#8220;<span class="quote">printer admin</span>&#8221;</span></h3></div></div></div><p>
     1454</p></div><div class="sect2" title="Always Make First Client Connection as root or &#8220;printer admin&#8221;"><div class="titlepage"><div><div><h3 class="title"><a name="id396553"></a>Always Make First Client Connection as root or <span class="quote">&#8220;<span class="quote">printer admin</span>&#8221;</span></h3></div></div></div><p>
    14561455After you installed the driver on the Samba server (in its <em class="parameter"><code>[print$]</code></em> share), you
    14571456should always make sure that your first client installation completes correctly. Make it a habit for yourself
     
    14681467printer for <span class="guiicon">duplex</span> as the default, and so on).
    14691468</p><p>
    1470 <a class="indexterm" name="id396669"></a>
     1469<a class="indexterm" name="id396641"></a>
    14711470To connect as root to a Samba printer, try this command from a Windows 200x/XP DOS box command prompt:
    14721471</p><pre class="screen">
     
    14821481<code class="literal">Point'n'Print</code>) will have the same defaults set for them. If you miss this step, you'll get a
    14831482lot of help desk calls from your users, but maybe you like to talk to people.
    1484 </p></div></div><div class="sect1" title="Other Gotchas"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id396739"></a>Other Gotchas</h2></div></div></div><p>
     1483</p></div></div><div class="sect1" title="Other Gotchas"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id396711"></a>Other Gotchas</h2></div></div></div><p>
    14851484Your driver is installed. It is now ready for Point'n'Print installation by the clients. You may have tried to
    14861485download and use it on your first client machine, but wait. Let's make sure you are acquainted first with a
     
    14881487advised in the preceding paragraphs. Your users complain about various issues (such as, <span class="quote">&#8220;<span class="quote">We need to set
    14891488the paper size for each job from Letter to A4 and it will not store it</span>&#8221;</span>).
    1490 </p><div class="sect2" title="Setting Default Print Options for Client Drivers"><div class="titlepage"><div><div><h3 class="title"><a name="id396756"></a>Setting Default Print Options for Client Drivers</h3></div></div></div><p>
     1489</p><div class="sect2" title="Setting Default Print Options for Client Drivers"><div class="titlepage"><div><div><h3 class="title"><a name="id396728"></a>Setting Default Print Options for Client Drivers</h3></div></div></div><p>
    14911490The last sentence might be viewed with mixed feelings by some users and Admins. They have struggled for hours
    14921491and could not arrive at a point where their settings seemed to be saved. It is not their fault. The confusing
     
    15371536defaults for all users.
    15381537</p><div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>Try (on Windows 200x/XP) to run this command (as a user with the right privileges):
    1539 <a class="indexterm" name="id397022"></a>
     1538<a class="indexterm" name="id396994"></a>
    15401539</p><p><strong class="userinput"><code>
    15411540rundll32 printui.dll,PrintUIEntry /p /t3 /n\\<em class="replaceable"><code>SAMBA-SERVER</code></em>\<em class="replaceable"><code>printersharename</code></em>
     
    15481547button (the one that does not set systemwide defaults), you can
    15491548start the commands from inside a DOS box or from <span class="guimenu">Start</span> -&gt; <span class="guimenuitem">Run</span>.
    1550 </p></div></div><div class="sect2" title="Supporting Large Numbers of Printers"><div class="titlepage"><div><div><h3 class="title"><a name="id397092"></a>Supporting Large Numbers of Printers</h3></div></div></div><p>
     1549</p></div></div><div class="sect2" title="Supporting Large Numbers of Printers"><div class="titlepage"><div><div><h3 class="title"><a name="id397064"></a>Supporting Large Numbers of Printers</h3></div></div></div><p>
    15511550One issue that has arisen during the recent development phase of Samba is the need to support driver
    15521551downloads for hundreds of printers. Using Windows NT APW for this task is somewhat awkward (to say the least). If
     
    16311630the two commas in the description field). After the <code class="literal">setdriver</code> command
    16321631succeeds, all is well.
    1633 </p></div><div class="sect2" title="Adding New Printers with the Windows NT APW"><div class="titlepage"><div><div><h3 class="title"><a name="id397328"></a>Adding New Printers with the Windows NT APW</h3></div></div></div><p>
     1632</p></div><div class="sect2" title="Adding New Printers with the Windows NT APW"><div class="titlepage"><div><div><h3 class="title"><a name="id397300"></a>Adding New Printers with the Windows NT APW</h3></div></div></div><p>
    16341633By default, Samba exhibits all printer shares defined in <code class="filename">smb.conf</code> in the <span class="guiicon">Printers</span>
    16351634folder. Also located in this folder is the Windows NT Add Printer Wizard icon. The APW will be shown only if:
     
    16711670you unwittingly under the wrong privilege. You should check it by using the <code class="literal">smbstatus</code>
    16721671command.
    1673 </p></div><div class="sect2" title="Error Message: &#8220;Cannot connect under a different Name&#8221;"><div class="titlepage"><div><div><h3 class="title"><a name="id397565"></a>Error Message: <span class="quote">&#8220;<span class="quote">Cannot connect under a different Name</span>&#8221;</span></h3></div></div></div><p>
     1672</p></div><div class="sect2" title="Error Message: &#8220;Cannot connect under a different Name&#8221;"><div class="titlepage"><div><div><h3 class="title"><a name="id397538"></a>Error Message: <span class="quote">&#8220;<span class="quote">Cannot connect under a different Name</span>&#8221;</span></h3></div></div></div><p>
    16741673Once you are connected with the wrong credentials, there is no means to reverse the situation other than
    16751674to close all Explorer windows, and perhaps reboot.
    16761675</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    1677 <a class="indexterm" name="id397584"></a>
     1676<a class="indexterm" name="id397556"></a>
    16781677        The <code class="literal">net use \\SAMBA-SERVER\sharename /user:root</code> gives you an error message:
    16791678        <span class="quote">&#8220;<span class="quote">Multiple connections to a server or a shared resource by the same user utilizing
     
    17011700</pre><p>
    17021701This will also disconnect all mapped drives and will allow you create fresh connection as required.
    1703 </p></div><div class="sect2" title="Take Care When Assembling Driver Files"><div class="titlepage"><div><div><h3 class="title"><a name="id397664"></a>Take Care When Assembling Driver Files</h3></div></div></div><p>
     1702</p></div><div class="sect2" title="Take Care When Assembling Driver Files"><div class="titlepage"><div><div><h3 class="title"><a name="id397636"></a>Take Care When Assembling Driver Files</h3></div></div></div><p>
    17041703You need to be extremely careful when you take notes about the files belonging to a particular
    17051704driver. Don't confuse the files for driver version <span class="quote">&#8220;<span class="quote">0</span>&#8221;</span> (for Windows 9x/Me, going into
     
    18321831correct driver files for each driver version. Don't rely on the names alone, and don't interchange files
    18331832belonging to different driver versions.
    1834 </p></div><div class="sect2" title="Samba and Printer Ports"><div class="titlepage"><div><div><h3 class="title"><a name="id397864"></a>Samba and Printer Ports</h3></div></div></div><p>
    1835 <a class="indexterm" name="id397871"></a>
    1836 <a class="indexterm" name="id397878"></a>
    1837 <a class="indexterm" name="id397885"></a>
    1838 <a class="indexterm" name="id397892"></a>
     1833</p></div><div class="sect2" title="Samba and Printer Ports"><div class="titlepage"><div><div><h3 class="title"><a name="id397860"></a>Samba and Printer Ports</h3></div></div></div><p>
     1834<a class="indexterm" name="id397868"></a>
     1835<a class="indexterm" name="id397874"></a>
     1836<a class="indexterm" name="id397881"></a>
     1837<a class="indexterm" name="id397888"></a>
    18391838Windows NT/2000 print servers associate a port with each printer. These normally take the form of
    18401839<code class="filename">LPT1:</code>, <code class="filename">COM1:</code>, <code class="filename">FILE:</code>, and so on. Samba must also
     
    18451844information to keep the Windows clients happy.
    18461845</p><p>
    1847 <a class="indexterm" name="id397931"></a>
     1846<a class="indexterm" name="id397927"></a>
    18481847Samba does not support the concept of <code class="constant">Printer Pooling</code> internally either. Printer
    18491848pooling assigns a logical printer to multiple ports as a form of load balancing or failover.
     
    18521851that they are working with Samba), configure the <a class="link" href="smb.conf.5.html#ENUMPORTSCOMMAND" target="_top">enumports command</a>,
    18531852which can be used to define an external program that generates a listing of ports on a system.
    1854 </p></div><div class="sect2" title="Avoiding Common Client Driver Misconfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="id397963"></a>Avoiding Common Client Driver Misconfiguration</h3></div></div></div><p>
     1853</p></div><div class="sect2" title="Avoiding Common Client Driver Misconfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="id397959"></a>Avoiding Common Client Driver Misconfiguration</h3></div></div></div><p>
    18551854So now the printing works, but there are still problems. Most jobs print well, some do not print at
    18561855all. Some jobs have problems with fonts, which do not look good. Some jobs print fast and some
     
    18591858Chapter</a>, <a class="link" href="CUPS-printing.html#cups-avoidps1" title="Avoiding Critical PostScript Driver Settings on the Client">Avoiding Critical PostScript Driver Settings on the
    18601859Client</a>.
    1861 </p></div></div><div class="sect1" title="The Imprints Toolset"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id397996"></a>The Imprints Toolset</h2></div></div></div><p>
    1862 <a class="indexterm" name="id398003"></a>
     1860</p></div></div><div class="sect1" title="The Imprints Toolset"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id397992"></a>The Imprints Toolset</h2></div></div></div><p>
     1861<a class="indexterm" name="id397999"></a>
    18631862The Imprints tool set provides a UNIX equivalent of the Windows NT APW.  For complete information, please
    18641863refer to the <a class="ulink" href="http://imprints.sourceforge.net/" target="_top">Imprints</a> Web site as well as the
     
    18721871there are prepared packages to use. Packages for more up-to-date print devices are needed if Imprints
    18731872should have a future. Information regarding the Imprints toolset can be obtained from the <a class="ulink" href="http://imprints.sourceforge.net/" target="_top">Imprints</a> home page.
    1874 </p><div class="sect2" title="What Is Imprints?"><div class="titlepage"><div><div><h3 class="title"><a name="id398034"></a>What Is Imprints?</h3></div></div></div><p>
     1873</p><div class="sect2" title="What Is Imprints?"><div class="titlepage"><div><div><h3 class="title"><a name="id398030"></a>What Is Imprints?</h3></div></div></div><p>
    18751874Imprints is a collection of tools for supporting these goals:
    18761875</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
     
    18811880        Providing an installation client that will obtain printer drivers from a central Internet (or intranet) Imprints Server
    18821881        repository and install them on remote Samba and Windows NT4 print servers.
    1883         </p></li></ul></div></div><div class="sect2" title="Creating Printer Driver Packages"><div class="titlepage"><div><div><h3 class="title"><a name="id398063"></a>Creating Printer Driver Packages</h3></div></div></div><p>
     1882        </p></li></ul></div></div><div class="sect2" title="Creating Printer Driver Packages"><div class="titlepage"><div><div><h3 class="title"><a name="id398060"></a>Creating Printer Driver Packages</h3></div></div></div><p>
    18841883The process of creating printer driver packages is beyond the scope of this document (refer to Imprints.txt,
    18851884included with the Samba distribution for more information). In short, an Imprints driver package
    18861885is a gzipped tarball containing the driver files, related INF files, and a control file needed by the
    18871886installation client.
    1888 </p></div><div class="sect2" title="The Imprints Server"><div class="titlepage"><div><div><h3 class="title"><a name="id398076"></a>The Imprints Server</h3></div></div></div><p>
     1887</p></div><div class="sect2" title="The Imprints Server"><div class="titlepage"><div><div><h3 class="title"><a name="id398072"></a>The Imprints Server</h3></div></div></div><p>
    18891888The Imprints server is really a database server that may be queried via standard HTTP mechanisms. Each
    18901889printer entry in the database has an associated URL for the actual downloading of the package. Each
     
    18931892the one referred in the Imprints database. It is strongly recommended that this security check
    18941893not be disabled.
    1895 </p></div><div class="sect2" title="The Installation Client"><div class="titlepage"><div><div><h3 class="title"><a name="id398090"></a>The Installation Client</h3></div></div></div><p>
     1894</p></div><div class="sect2" title="The Installation Client"><div class="titlepage"><div><div><h3 class="title"><a name="id398086"></a>The Installation Client</h3></div></div></div><p>
    18961895More information regarding the Imprints installation client is available from the documentation file
    18971896<code class="filename">Imprints-Client-HOWTO.ps</code> that is included with the Imprints source package. The Imprints
     
    19231922The way of sidestepping this limitation is to require that all Imprints printer driver packages include both the Intel Windows NT and
    1924192395/98 printer drivers and that the NT driver is installed first.
    1925 </p></div></div><div class="sect1" title="Adding Network Printers without User Interaction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398206"></a>Adding Network Printers without User Interaction</h2></div></div></div><p>
     1924</p></div></div><div class="sect1" title="Adding Network Printers without User Interaction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398202"></a>Adding Network Printers without User Interaction</h2></div></div></div><p>
    19261925The following MS Knowledge Base article may be of some help if you need to handle Windows 2000 clients:
    19271926<span class="emphasis"><em>How to Add Printers with No User Interaction in Windows 2000,</em></span> (<a class="ulink" href="http://support.microsoft.com/default.aspx?scid=kb;en-us;189105" target="_top">Microsoft KB 189105</a>).  It also
     
    19821981added, changed, and deleted at will on the server with no user intervention required from the clients
    19831982(you just need to keep the logon scripts up to date).
    1984 </p></div><div class="sect1" title="The addprinter Command"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398448"></a>The <code class="literal">addprinter</code> Command</h2></div></div></div><p>
     1983</p></div><div class="sect1" title="The addprinter Command"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398444"></a>The <code class="literal">addprinter</code> Command</h2></div></div></div><p>
    19851984The <code class="literal">addprinter</code> command can be configured to be a shell script or program executed by
    19861985Samba. It is triggered by running the APW from a client against the Samba print server. The APW asks
     
    19901989by executing the <code class="literal">lpadmin</code> command on more modern systems) and create the associated share,
    19911990then the APW will in effect really create a new printer on Samba and the UNIX print subsystem!
    1992 </p></div><div class="sect1" title="Migration of Classical Printing to Samba"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398481"></a>Migration of Classical Printing to Samba</h2></div></div></div><p>
     1991</p></div><div class="sect1" title="Migration of Classical Printing to Samba"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398477"></a>Migration of Classical Printing to Samba</h2></div></div></div><p>
    19931992The basic NT-style printer driver management has not changed considerably in 3.0 over the 2.2.x releases
    19941993(apart from many small improvements). Here migration should be quite easy, especially if you followed
     
    20202019        using smbclient and rpcclient. See the Imprints installation client on the <a class="ulink" href="http://imprints.sourceforge.net/" target="_top">Imprints</a> web site for example. See also the discussion of
    20212020        rpcclient usage in <a class="link" href="CUPS-printing.html" title="Chapter 22. CUPS Printing Support">CUPS Printing</a>.
    2022         </p></li></ul></div></div><div class="sect1" title="Publishing Printer Information in Active Directory or LDAP"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398612"></a>Publishing Printer Information in Active Directory or LDAP</h2></div></div></div><p>
     2021        </p></li></ul></div></div><div class="sect1" title="Publishing Printer Information in Active Directory or LDAP"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398608"></a>Publishing Printer Information in Active Directory or LDAP</h2></div></div></div><p>
    20232022This topic has also been addressed in <a class="link" href="NetCommand.html" title="Chapter 13. Remote and Local Management: The Net Command">Remote and Local Management  The
    20242023Net Command</a>. If you wish to volunteer your services to help document this further, please contact
    20252024<a class="ulink" href="mail://jht@samba.org" target="_top">John H. Terpstra</a>.
    2026 </p></div><div class="sect1" title="Common Errors"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398639"></a>Common Errors</h2></div></div></div><div class="sect2" title="I Give My Root Password but I Do Not Get Access"><div class="titlepage"><div><div><h3 class="title"><a name="id398644"></a>I Give My Root Password but I Do Not Get Access</h3></div></div></div><p>
     2025</p></div><div class="sect1" title="Common Errors"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id398635"></a>Common Errors</h2></div></div></div><div class="sect2" title="I Give My Root Password but I Do Not Get Access"><div class="titlepage"><div><div><h3 class="title"><a name="id398641"></a>I Give My Root Password but I Do Not Get Access</h3></div></div></div><p>
    20272026Do not confuse the root password, which is valid for the UNIX system (and in most cases stored in the
    20282027form of a one-way hash in a file named <code class="filename">/etc/shadow</code>), with the password used to
     
    20352034Retype new SMB password: secret
    20362035</pre><p>
    2037 </p></div><div class="sect2" title="My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost"><div class="titlepage"><div><div><h3 class="title"><a name="id398682"></a>My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost</h3></div></div></div><p>
     2036</p></div><div class="sect2" title="My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost"><div class="titlepage"><div><div><h3 class="title"><a name="id398678"></a>My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost</h3></div></div></div><p>
    20382037Do not use the existing UNIX print system spool directory for the Samba spool directory. It may seem
    20392038convenient and a savings of space, but it only leads to problems. The two must be separate. The UNIX/Linux
Note: See TracChangeset for help on using the changeset viewer.