- Timestamp:
- May 20, 2009, 6:46:53 PM (16 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.2.x/docs/htmldocs/Samba3-HOWTO/classicalprinting.html
r149 r204 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.73.1"><link rel="start" href="index.html" title="The Official Samba 3.2.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" lang="en"><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"><<a class="email" href="mailto:kpfeifle@danka.de">kpfeifle@danka.de</a>></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"><<a class="email" href="mailto:jerry@samba.org">jerry@samba.org</a>></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"><<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>></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#id26150 70">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2615294">Technical Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2615445">Client to Samba Print Job Processing</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2615504">Printing-Related Configuration Parameters</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2615605">Simple Print Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2615888">Verifying Configuration with <code class="literal">testparm</code></a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2616085">Rapid Configuration Validation</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2616484">Extended Printing Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2616940">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#id2619653">Point'n'Print Client Drivers on Samba Servers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2619823">The Obsoleted [printer$] Section</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2619944">Creating the [print$] Share</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2620161">[print$] Stanza Parameters</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2620481">The [print$] Share Directory</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2620624">Installing Drivers into [print$]</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2620717">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#id2622652">Client Driver Installation Procedure</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2622669">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#id2623246">Additional Client Driver Installation</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2623365">Always Make First Client Connection as root or “<span class="quote">printer admin</span>”</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2623538">Other Gotchas</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2623558">Setting Default Print Options for Client Drivers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2623925">Supporting Large Numbers of Printers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624182">Adding New Printers with the Windows NT APW</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624441">Error Message: “<span class="quote">Cannot connect under a different Name</span>”</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624555">Take Care When Assembling Driver Files</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624864">Samba and Printer Ports</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624974">Avoiding Common Client Driver Misconfiguration</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2625011">The Imprints Toolset</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2625068">What Is Imprints?</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2625102">Creating Printer Driver Packages</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2625118">The Imprints Server</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2625135">The Installation Client</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2625268">Adding Network Printers without User Interaction</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2625539">The <code class="literal">addprinter</code> Command</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2625578">Migration of Classical Printing to Samba</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2625727">Publishing Printer Information in Active Directory or LDAP</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2625756">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2625762">I Give My Root Password but I Do Not Get Access</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2625803">My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2615070"></a>Features and Benefits</h2></div></div></div><p>2 <a class="indexterm" name="id26150 78"></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.73.1"><link rel="start" href="index.html" title="The Official Samba 3.2.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" lang="en"><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"><<a class="email" href="mailto:kpfeifle@danka.de">kpfeifle@danka.de</a>></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"><<a class="email" href="mailto:jerry@samba.org">jerry@samba.org</a>></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"><<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>></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#id2615084">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2615307">Technical Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2615458">Client to Samba Print Job Processing</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2615518">Printing-Related Configuration Parameters</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2615618">Simple Print Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2615901">Verifying Configuration with <code class="literal">testparm</code></a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2616098">Rapid Configuration Validation</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2616498">Extended Printing Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2616953">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#id2619666">Point'n'Print Client Drivers on Samba Servers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2619836">The Obsoleted [printer$] Section</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2619957">Creating the [print$] Share</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2620174">[print$] Stanza Parameters</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2620495">The [print$] Share Directory</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2620637">Installing Drivers into [print$]</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2620730">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#id2622666">Client Driver Installation Procedure</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2622682">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#id2623259">Additional Client Driver Installation</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2623378">Always Make First Client Connection as root or “<span class="quote">printer admin</span>”</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2623551">Other Gotchas</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2623572">Setting Default Print Options for Client Drivers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2623939">Supporting Large Numbers of Printers</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624195">Adding New Printers with the Windows NT APW</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624455">Error Message: “<span class="quote">Cannot connect under a different Name</span>”</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624568">Take Care When Assembling Driver Files</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624877">Samba and Printer Ports</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2624987">Avoiding Common Client Driver Misconfiguration</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2625024">The Imprints Toolset</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2625081">What Is Imprints?</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2625115">Creating Printer Driver Packages</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2625131">The Imprints Server</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2625148">The Installation Client</a></span></dt></dl></dd><dt><span class="sect1"><a href="classicalprinting.html#id2625282">Adding Network Printers without User Interaction</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2625553">The <code class="literal">addprinter</code> Command</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2625591">Migration of Classical Printing to Samba</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2625740">Publishing Printer Information in Active Directory or LDAP</a></span></dt><dt><span class="sect1"><a href="classicalprinting.html#id2625769">Common Errors</a></span></dt><dd><dl><dt><span class="sect2"><a href="classicalprinting.html#id2625775">I Give My Root Password but I Do Not Get Access</a></span></dt><dt><span class="sect2"><a href="classicalprinting.html#id2625816">My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2615084"></a>Features and Benefits</h2></div></div></div><p> 2 <a class="indexterm" name="id2615092"></a> 3 3 Printing is often a mission-critical service for the users. Samba can provide this service reliably and 4 4 seamlessly for a client network consisting of Windows workstations. 5 5 </p><p> 6 <a class="indexterm" name="id2615092"></a> 7 <a class="indexterm" name="id2615098"></a> 8 <a class="indexterm" name="id2615106"></a> 6 <a class="indexterm" name="id2615105"></a> 9 7 <a class="indexterm" name="id2615112"></a> 10 8 <a class="indexterm" name="id2615119"></a> … … 14 12 <a class="indexterm" name="id2615147"></a> 15 13 <a class="indexterm" name="id2615154"></a> 16 <a class="indexterm" name="id2615161"></a> 17 <a class="indexterm" name="id2615168"></a> 18 <a class="indexterm" name="id2615175"></a> 19 <a class="indexterm" name="id2615182"></a> 14 <a class="indexterm" name="id2615160"></a> 15 <a class="indexterm" name="id2615167"></a> 16 <a class="indexterm" name="id2615174"></a> 17 <a class="indexterm" name="id2615181"></a> 18 <a class="indexterm" name="id2615188"></a> 19 <a class="indexterm" name="id2615195"></a> 20 20 A Samba print service may be run on a standalone or domain member server, side by side with file serving 21 21 functions, or on a dedicated print server. It can be made as tightly or as loosely secured as needs dictate. … … 31 31 supported by the newer Common UNIX Printing System (CUPS) as the print subsystem underneath the Samba hood. 32 32 </p><p> 33 <a class="indexterm" name="id26152 33"></a>34 <a class="indexterm" name="id26152 39"></a>33 <a class="indexterm" name="id2615246"></a> 34 <a class="indexterm" name="id2615252"></a> 35 35 This chapter outlines the fundamentals of Samba printing as implemented by the more traditional UNIX 36 36 BSD- and System V-style printing systems. Much of the information in this chapter applies also to CUPS. If … … 38 38 do. For further information refer to <a class="link" href="CUPS-printing.html" title="Chapter 22. CUPS Printing Support">CUPS Printing Support</a>. 39 39 </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p> 40 <a class="indexterm" name="id26152 65"></a>41 <a class="indexterm" name="id26152 72"></a>42 <a class="indexterm" name="id26152 79"></a>40 <a class="indexterm" name="id2615278"></a> 41 <a class="indexterm" name="id2615285"></a> 42 <a class="indexterm" name="id2615292"></a> 43 43 Most of the following examples have been verified on Windows XP Professional clients. Where this document 44 44 describes the responses to commands given, bear in mind that Windows 200x/XP clients are quite similar but may 45 45 differ in minor details. Windows NT4 is somewhat different again. 46 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2615294"></a>Technical Introduction</h2></div></div></div><p> 47 <a class="indexterm" name="id2615302"></a> 48 <a class="indexterm" name="id2615308"></a> 46 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2615307"></a>Technical Introduction</h2></div></div></div><p> 49 47 <a class="indexterm" name="id2615315"></a> 48 <a class="indexterm" name="id2615322"></a> 49 <a class="indexterm" name="id2615329"></a> 50 50 Samba's printing support always relies on the installed print subsystem of the UNIX OS it runs on. Samba is a 51 51 <code class="literal">middleman.</code> It takes print files from Windows (or other SMB) clients and passes them to the real … … 55 55 features and are accessed differently. 56 56 </p><p> 57 <a class="indexterm" name="id26153 41"></a>58 <a class="indexterm" name="id26153 48"></a>57 <a class="indexterm" name="id2615354"></a> 58 <a class="indexterm" name="id2615361"></a> 59 59 This chapter deals with the traditional way of UNIX printing. The next chapter covers in great detail the more 60 60 modern CUPS. 61 61 </p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p> 62 <a class="indexterm" name="id26153 61"></a>62 <a class="indexterm" name="id2615374"></a> 63 63 CUPS users, be warned: do not just jump on to the next chapter. You might miss important information only found here! 64 64 </p></div><p> 65 <a class="indexterm" name="id26153 73"></a>66 <a class="indexterm" name="id26153 80"></a>67 <a class="indexterm" name="id2615 387"></a>68 <a class="indexterm" name="id2615 394"></a>65 <a class="indexterm" name="id2615386"></a> 66 <a class="indexterm" name="id2615393"></a> 67 <a class="indexterm" name="id2615400"></a> 68 <a class="indexterm" name="id2615407"></a> 69 69 It is apparent from postings on the Samba mailing list that print configuration is one of the most problematic 70 70 aspects of Samba administration today. Many new Samba administrators have the impression that Samba performs … … 72 72 do any form of print filtering. 73 73 </p><p> 74 <a class="indexterm" name="id2615410"></a>75 <a class="indexterm" name="id2615417"></a>76 74 <a class="indexterm" name="id2615424"></a> 77 <a class="indexterm" name="id2615431"></a> 75 <a class="indexterm" name="id2615430"></a> 76 <a class="indexterm" name="id2615437"></a> 77 <a class="indexterm" name="id2615444"></a> 78 78 Samba obtains from its clients a data stream (print job) that it spools to a local spool area. When the entire 79 79 print job has been received, Samba invokes a local UNIX/Linux print command and passes the spooled file to it. 80 80 It is up to the local system printing subsystems to correctly process the print job and to submit it to the 81 81 printer. 82 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26154 45"></a>Client to Samba Print Job Processing</h3></div></div></div><p>82 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2615458"></a>Client to Samba Print Job Processing</h3></div></div></div><p> 83 83 Successful printing from a Windows client via a Samba print server to a UNIX 84 84 printer involves six (potentially seven) stages: … … 87 87 to the UNIX print subsystem's spooling area.</p></li><li><p>The UNIX print subsystem processes the print job.</p></li><li><p>The print file may need to be explicitly deleted 88 88 from the Samba spooling area. This item depends on your print spooler 89 configuration settings.</p></li></ol></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2615504"></a>Printing-Related Configuration Parameters</h3></div></div></div><p> 90 <a class="indexterm" name="id2615513"></a> 91 <a class="indexterm" name="id2615520"></a> 89 configuration settings.</p></li></ol></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2615518"></a>Printing-Related Configuration Parameters</h3></div></div></div><p> 92 90 <a class="indexterm" name="id2615526"></a> 91 <a class="indexterm" name="id2615533"></a> 92 <a class="indexterm" name="id2615540"></a> 93 93 There are a number of configuration parameters to control Samba's printing behavior. Please refer to the man 94 94 page for <code class="filename">smb.conf</code> for an overview of these. As with other parameters, there are global-level (tagged with a … … 104 104 setting defined for the same parameter, thus overriding the 105 105 global default). 106 </p></dd></dl></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26156 05"></a>Simple Print Configuration</h2></div></div></div><p>107 <a class="indexterm" name="id26156 13"></a>108 <a class="indexterm" name="id26156 20"></a>109 <a class="indexterm" name="id26156 27"></a>110 <a class="indexterm" name="id26156 34"></a>106 </p></dd></dl></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2615618"></a>Simple Print Configuration</h2></div></div></div><p> 107 <a class="indexterm" name="id2615626"></a> 108 <a class="indexterm" name="id2615633"></a> 109 <a class="indexterm" name="id2615640"></a> 110 <a class="indexterm" name="id2615647"></a> 111 111 <a class="link" href="classicalprinting.html#simpleprc" title="Example 21.1. Simple Configuration with BSD Printing">Simple Configuration with BSD Printing</a> shows a simple printing configuration. 112 112 If you compare this with your own, you may find additional parameters that have been preconfigured by your OS … … 114 114 parameters. However, in many environments these are enough to provide a valid <code class="filename">smb.conf</code> file that enables 115 115 all clients to print. 116 </p><div class="example"><a name="simpleprc"></a><p class="title"><b>Example 21.1. Simple Configuration with BSD Printing</b></p><div class="example-contents"><table class="simplelist" border="0" summary="Simple list"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id26156 86"></a><em class="parameter"><code>printing = bsd</code></em></td></tr><tr><td><a class="indexterm" name="id2615697"></a><em class="parameter"><code>load printers = yes</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="id2615718"></a><em class="parameter"><code>path = /var/spool/samba</code></em></td></tr><tr><td><a class="indexterm" name="id2615730"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2615741"></a><em class="parameter"><code>public = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2615753"></a><em class="parameter"><code>writable = no</code></em></td></tr></table></div></div><br class="example-break"><p>117 <a class="indexterm" name="id26157 68"></a>118 <a class="indexterm" name="id26157 74"></a>119 <a class="indexterm" name="id26157 82"></a>116 </p><div class="example"><a name="simpleprc"></a><p class="title"><b>Example 21.1. Simple Configuration with BSD Printing</b></p><div class="example-contents"><table class="simplelist" border="0" summary="Simple list"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2615699"></a><em class="parameter"><code>printing = bsd</code></em></td></tr><tr><td><a class="indexterm" name="id2615710"></a><em class="parameter"><code>load printers = yes</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="id2615731"></a><em class="parameter"><code>path = /var/spool/samba</code></em></td></tr><tr><td><a class="indexterm" name="id2615743"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2615754"></a><em class="parameter"><code>public = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2615766"></a><em class="parameter"><code>writable = no</code></em></td></tr></table></div></div><br class="example-break"><p> 117 <a class="indexterm" name="id2615781"></a> 118 <a class="indexterm" name="id2615788"></a> 119 <a class="indexterm" name="id2615795"></a> 120 120 This is only an example configuration. Samba assigns default values to all configuration parameters. The 121 121 defaults are conservative and sensible. When a parameter is specified in the <code class="filename">smb.conf</code> file, this overwrites … … 125 125 pager program. 126 126 </p><p> 127 <a class="indexterm" name="id26158 23"></a>128 <a class="indexterm" name="id26158 30"></a>129 <a class="indexterm" name="id26158 38"></a>127 <a class="indexterm" name="id2615837"></a> 128 <a class="indexterm" name="id2615844"></a> 129 <a class="indexterm" name="id2615851"></a> 130 130 The syntax for the configuration file is easy to grasp. You should know that is not very picky about its 131 131 syntax. As has been explained elsewhere in this book, Samba tolerates some spelling errors (such as … … 133 133 case-insensitive. It is permissible to use <em class="parameter"><code>Yes/No</code></em> or <em class="parameter"><code>True/False</code></em> 134 134 for Boolean settings. Lists of names may be separated by commas, spaces, or tabs. 135 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2615888"></a>Verifying Configuration with <code class="literal">testparm</code></h3></div></div></div><p> 136 <a class="indexterm" name="id2615901"></a> 137 <a class="indexterm" name="id2615908"></a> 138 <a class="indexterm" name="id2615915"></a> 135 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2615901"></a>Verifying Configuration with <code class="literal">testparm</code></h3></div></div></div><p> 136 <a class="indexterm" name="id2615914"></a> 139 137 <a class="indexterm" name="id2615921"></a> 140 138 <a class="indexterm" name="id2615928"></a> 141 139 <a class="indexterm" name="id2615935"></a> 142 <a class="indexterm" name="id261594 2"></a>143 <a class="indexterm" name="id261594 9"></a>140 <a class="indexterm" name="id2615941"></a> 141 <a class="indexterm" name="id2615948"></a> 144 142 <a class="indexterm" name="id2615955"></a> 145 143 <a class="indexterm" name="id2615962"></a> 146 144 <a class="indexterm" name="id2615969"></a> 145 <a class="indexterm" name="id2615976"></a> 146 <a class="indexterm" name="id2615982"></a> 147 147 To see all (or at least most) printing-related settings in Samba, including the implicitly used ones, try the 148 148 command outlined below. This command greps for all occurrences of <code class="constant">lp</code>, … … 195 195 “<span class="quote">-v</span>” switch, it only shows you the settings actually written into! To see the complete 196 196 configuration used, add the “<span class="quote">-v</span>” parameter to testparm. 197 </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26160 85"></a>Rapid Configuration Validation</h3></div></div></div><p>198 <a class="indexterm" name="id2616 093"></a>199 <a class="indexterm" name="id26161 00"></a>200 <a class="indexterm" name="id26161 07"></a>201 <a class="indexterm" name="id26161 14"></a>197 </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2616098"></a>Rapid Configuration Validation</h3></div></div></div><p> 198 <a class="indexterm" name="id2616106"></a> 199 <a class="indexterm" name="id2616113"></a> 200 <a class="indexterm" name="id2616120"></a> 201 <a class="indexterm" name="id2616127"></a> 202 202 Should you need to troubleshoot at any stage, please always come back to this point first and verify if 203 203 <code class="literal">testparm</code> shows the parameters you expect. To give you a warning from personal experience, … … 212 212 load printers = Yes 213 213 </pre><p> 214 <a class="indexterm" name="id26161 70"></a>215 <a class="indexterm" name="id26161 77"></a>214 <a class="indexterm" name="id2616183"></a> 215 <a class="indexterm" name="id2616190"></a> 216 216 I assumed that commenting out of this setting should prevent Samba from 217 217 publishing my printers, but it still did. It took some time to figure out … … 227 227 load printers = No 228 228 </pre><p> 229 <a class="indexterm" name="id26162 20"></a>229 <a class="indexterm" name="id2616234"></a> 230 230 Only when the parameter is explicitly set to <a class="link" href="smb.conf.5.html#LOADPRINTERS">load printers = No</a> would 231 231 Samba conform with my intentions. So, my strong advice is: … … 238 238 [printers] 239 239 </pre><p> 240 <a class="indexterm" name="id2616 289"></a>241 <a class="indexterm" name="id2616 295"></a>240 <a class="indexterm" name="id2616302"></a> 241 <a class="indexterm" name="id2616309"></a> 242 242 This example should show that you can use <code class="literal">testparm</code> to test any Samba configuration file. 243 243 Actually, we encourage you <span class="emphasis"><em>not</em></span> to change your working system (unless you know exactly … … 277 277 <code class="literal">testparm</code> issued two warnings: 278 278 </p><div class="itemizedlist"><ul type="disc"><li><p>We did not specify the <em class="parameter"><code>[printers]</code></em> section as printable.</p></li><li><p>We did not tell Samba which spool directory to use.</p></li></ul></div><p> 279 <a class="indexterm" name="id26164 00"></a>280 <a class="indexterm" name="id26164 07"></a>281 <a class="indexterm" name="id26164 12"></a>282 <a class="indexterm" name="id26164 18"></a>279 <a class="indexterm" name="id2616413"></a> 280 <a class="indexterm" name="id2616420"></a> 281 <a class="indexterm" name="id2616425"></a> 282 <a class="indexterm" name="id2616431"></a> 283 283 However, this was not fatal, and Samba will default to values that will work. Please, do not rely on this and 284 284 do not use this example. This was included to encourage you to be careful to design and specify your setup to … … 289 289 clearly says: <code class="literal">Internal whitespace in a parameter value is retained verbatim.</code> This means 290 290 that a line consisting of, for example, 291 </p><table class="simplelist" border="0" summary="Simple list"><tr><td># This defines LPRng as the printing system</td></tr><tr><td><a class="indexterm" name="id26164 58"></a><em class="parameter"><code>printing = lprng</code></em></td></tr></table><p>291 </p><table class="simplelist" border="0" summary="Simple list"><tr><td># This defines LPRng as the printing system</td></tr><tr><td><a class="indexterm" name="id2616471"></a><em class="parameter"><code>printing = lprng</code></em></td></tr></table><p> 292 292 </p><p> 293 293 will regard the whole of the string after the <code class="literal">=</code> sign as the value you want to define. This 294 294 is an invalid value that will be ignored, and a default value will be used in its place. 295 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2616484"></a>Extended Printing Configuration</h2></div></div></div><p> 296 <a class="indexterm" name="id2616493"></a> 297 <a class="indexterm" name="id2616500"></a> 298 <a class="indexterm" name="id2616507"></a> 295 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2616498"></a>Extended Printing Configuration</h2></div></div></div><p> 296 <a class="indexterm" name="id2616506"></a> 299 297 <a class="indexterm" name="id2616513"></a> 298 <a class="indexterm" name="id2616520"></a> 299 <a class="indexterm" name="id2616527"></a> 300 300 <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 301 301 print-related settings in a BSD-style printing environment. What follows is a discussion and explanation of … … 305 305 are 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 306 306 <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 class="simplelist" border="0" summary="Simple list"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2616 587"></a><em class="parameter"><code>printing = bsd</code></em></td></tr><tr><td><a class="indexterm" name="id2616599"></a><em class="parameter"><code>load printers = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616611"></a><em class="parameter"><code>show add printer wizard = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616623"></a><em class="parameter"><code>printcap name = /etc/printcap</code></em></td></tr><tr><td><a class="indexterm" name="id2616635"></a><em class="parameter"><code>printer admin = @ntadmin, root</code></em></td></tr><tr><td><a class="indexterm" name="id2616647"></a><em class="parameter"><code>max print jobs = 100</code></em></td></tr><tr><td><a class="indexterm" name="id2616659"></a><em class="parameter"><code>lpq cache time = 20</code></em></td></tr><tr><td><a class="indexterm" name="id2616670"></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="id2616691"></a><em class="parameter"><code>comment = All Printers</code></em></td></tr><tr><td><a class="indexterm" name="id2616703"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616714"></a><em class="parameter"><code>path = /var/spool/samba</code></em></td></tr><tr><td><a class="indexterm" name="id2616726"></a><em class="parameter"><code>browseable = no</code></em></td></tr><tr><td><a class="indexterm" name="id2616738"></a><em class="parameter"><code>guest ok = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616749"></a><em class="parameter"><code>public = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616761"></a><em class="parameter"><code>read only = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616773"></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="id2616793"></a><em class="parameter"><code>comment = Printer with Restricted Access</code></em></td></tr><tr><td><a class="indexterm" name="id2616805"></a><em class="parameter"><code>path = /var/spool/samba_my_printer</code></em></td></tr><tr><td><a class="indexterm" name="id2616817"></a><em class="parameter"><code>printer admin = kurt</code></em></td></tr><tr><td><a class="indexterm" name="id2616829"></a><em class="parameter"><code>browseable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616841"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616852"></a><em class="parameter"><code>writable = no</code></em></td></tr><tr><td><a class="indexterm" name="id2616864"></a><em class="parameter"><code>hosts allow = 0.0.0.0</code></em></td></tr><tr><td><a class="indexterm" name="id2616876"></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="id2616888"></a><em class="parameter"><code>guest ok = no</code></em></td></tr></table></div></div><br class="example-break"><p>308 <a class="indexterm" name="id26169 02"></a>309 <a class="indexterm" name="id26169 07"></a>310 <a class="indexterm" name="id26169 12"></a>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 class="simplelist" border="0" summary="Simple list"><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2616600"></a><em class="parameter"><code>printing = bsd</code></em></td></tr><tr><td><a class="indexterm" name="id2616612"></a><em class="parameter"><code>load printers = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616624"></a><em class="parameter"><code>show add printer wizard = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616636"></a><em class="parameter"><code>printcap name = /etc/printcap</code></em></td></tr><tr><td><a class="indexterm" name="id2616648"></a><em class="parameter"><code>printer admin = @ntadmin, root</code></em></td></tr><tr><td><a class="indexterm" name="id2616660"></a><em class="parameter"><code>max print jobs = 100</code></em></td></tr><tr><td><a class="indexterm" name="id2616672"></a><em class="parameter"><code>lpq cache time = 20</code></em></td></tr><tr><td><a class="indexterm" name="id2616684"></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="id2616704"></a><em class="parameter"><code>comment = All Printers</code></em></td></tr><tr><td><a class="indexterm" name="id2616716"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616728"></a><em class="parameter"><code>path = /var/spool/samba</code></em></td></tr><tr><td><a class="indexterm" name="id2616739"></a><em class="parameter"><code>browseable = no</code></em></td></tr><tr><td><a class="indexterm" name="id2616751"></a><em class="parameter"><code>guest ok = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616763"></a><em class="parameter"><code>public = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616774"></a><em class="parameter"><code>read only = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616786"></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="id2616807"></a><em class="parameter"><code>comment = Printer with Restricted Access</code></em></td></tr><tr><td><a class="indexterm" name="id2616819"></a><em class="parameter"><code>path = /var/spool/samba_my_printer</code></em></td></tr><tr><td><a class="indexterm" name="id2616830"></a><em class="parameter"><code>printer admin = kurt</code></em></td></tr><tr><td><a class="indexterm" name="id2616842"></a><em class="parameter"><code>browseable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616854"></a><em class="parameter"><code>printable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2616866"></a><em class="parameter"><code>writable = no</code></em></td></tr><tr><td><a class="indexterm" name="id2616877"></a><em class="parameter"><code>hosts allow = 0.0.0.0</code></em></td></tr><tr><td><a class="indexterm" name="id2616889"></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="id2616901"></a><em class="parameter"><code>guest ok = no</code></em></td></tr></table></div></div><br class="example-break"><p> 308 <a class="indexterm" name="id2616915"></a> 309 <a class="indexterm" name="id2616920"></a> 310 <a class="indexterm" name="id2616926"></a> 311 311 This is an example configuration. You may not find all the settings that are in the configuration file that 312 312 was provided by the OS vendor. Samba configuration parameters, if not explicitly set, default to a sensible 313 313 value. To see all settings, as <code class="constant">root</code> use the <code class="literal">testparm</code> utility. 314 314 <code class="literal">testparm</code> gives warnings for misconfigured settings. 315 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26169 40"></a>Detailed Explanation Settings</h3></div></div></div><p>315 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2616953"></a>Detailed Explanation Settings</h3></div></div></div><p> 316 316 The 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 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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2616964"></a>The [global] Section</h4></div></div></div><p> 319 <a class="indexterm" name="id2616972"></a> 320 <a class="indexterm" name="id2616979"></a> 318 </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2616978"></a>The [global] Section</h4></div></div></div><p> 321 319 <a class="indexterm" name="id2616986"></a> 322 <a class="indexterm" name="id2616993"></a> 320 <a class="indexterm" name="id2616992"></a> 321 <a class="indexterm" name="id2616999"></a> 322 <a class="indexterm" name="id2617006"></a> 323 323 The <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 324 324 <em class="parameter"><code>[global]</code></em> contains all parameters that apply to the server as a whole. It is the place … … 328 328 globally set share settings and specify other values). 329 329 </p><div class="variablelist"><dl><dt><span class="term"><a class="link" href="smb.conf.5.html#PRINTING">printing = bsd </a></span></dt><dd><p> 330 <a class="indexterm" name="id2617060"></a>331 <a class="indexterm" name="id2617066"></a>332 330 <a class="indexterm" name="id2617073"></a> 333 331 <a class="indexterm" name="id2617080"></a> 334 <a class="indexterm" name="id261708 7"></a>332 <a class="indexterm" name="id2617086"></a> 335 333 <a class="indexterm" name="id2617093"></a> 336 334 <a class="indexterm" name="id2617100"></a> 337 <a class="indexterm" name="id261710 7"></a>338 <a class="indexterm" name="id261711 4"></a>335 <a class="indexterm" name="id2617106"></a> 336 <a class="indexterm" name="id2617113"></a> 339 337 <a class="indexterm" name="id2617120"></a> 340 338 <a class="indexterm" name="id2617127"></a> 341 <a class="indexterm" name="id2617134"></a> 339 <a class="indexterm" name="id2617133"></a> 340 <a class="indexterm" name="id2617140"></a> 341 <a class="indexterm" name="id2617147"></a> 342 342 Causes Samba to use default print commands applicable for the BSD (also known as RFC 1179 style or LPR/LPD) 343 343 printing system. In general, the <em class="parameter"><code>printing</code></em> parameter informs Samba about the print … … 345 345 systems defaults to a different <a class="link" href="smb.conf.5.html#PRINTCOMMAND">print command</a> (and other queue control commands). 346 346 </p><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Caution</h3><p> 347 <a class="indexterm" name="id26171 70"></a>348 <a class="indexterm" name="id26171 76"></a>347 <a class="indexterm" name="id2617183"></a> 348 <a class="indexterm" name="id2617190"></a> 349 349 The <a class="link" href="smb.conf.5.html#PRINTING">printing</a> parameter is normally a service-level parameter. Since it is included 350 350 here in the <em class="parameter"><code>[global]</code></em> section, it will take effect for all printer shares that are not 351 351 defined differently. Samba-3 no longer supports the SOFTQ printing system. 352 352 </p></div></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#LOADPRINTERS">load printers = yes </a></span></dt><dd><p> 353 <a class="indexterm" name="id2617225"></a> 354 <a class="indexterm" name="id2617231"></a> 355 <a class="indexterm" name="id2617237"></a> 353 <a class="indexterm" name="id2617238"></a> 356 354 <a class="indexterm" name="id2617244"></a> 355 <a class="indexterm" name="id2617251"></a> 356 <a class="indexterm" name="id2617258"></a> 357 357 Tells Samba to create automatically all available printer shares. Available printer shares are discovered by 358 358 scanning the printcap file. All created printer shares are also loaded for browsing. If you use this … … 362 362 share separately, leaving out some you do not want to be publicly visible and available). 363 363 </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#SHOWADDPRINTERWIZARD">show add printer wizard = yes </a></span></dt><dd><p> 364 <a class="indexterm" name="id2617293"></a>365 <a class="indexterm" name="id2617299"></a>366 364 <a class="indexterm" name="id2617306"></a> 367 <a class="indexterm" name="id261731 2"></a>365 <a class="indexterm" name="id2617313"></a> 368 366 <a class="indexterm" name="id2617319"></a> 367 <a class="indexterm" name="id2617326"></a> 368 <a class="indexterm" name="id2617332"></a> 369 369 Setting is normally enabled by default (even if the parameter is not specified in <code class="filename">smb.conf</code>). It causes the 370 370 <span class="guiicon">Add Printer Wizard</span> icon to appear in the <span class="guiicon">Printers</span> folder of the Samba … … 375 375 before the action), or exchange a printer's driver for any other previously uploaded driver. 376 376 </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#MAXPRINTJOBS">max print jobs = 100 </a></span></dt><dd><p> 377 <a class="indexterm" name="id26174 02"></a>377 <a class="indexterm" name="id2617415"></a> 378 378 Sets the upper limit to 100 print jobs being active on the Samba server at any one time. Should a client 379 379 submit a job that exceeds this number, a "no more space available on server" type of error message will be … … 381 381 at all. 382 382 </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#PRINTCAPNAME">printcap name = /etc/printcap </a></span></dt><dd><p> 383 <a class="indexterm" name="id26174 38"></a>384 <a class="indexterm" name="id26174 44"></a>385 <a class="indexterm" name="id26174 50"></a>383 <a class="indexterm" name="id2617451"></a> 384 <a class="indexterm" name="id2617457"></a> 385 <a class="indexterm" name="id2617464"></a> 386 386 Tells Samba where to look for a list of available printer names. Where CUPS is used, make sure that a printcap 387 387 file is written. This is controlled by the <code class="constant">Printcap</code> directive in the 388 388 <code class="filename">cupsd.conf</code> file. 389 389 </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#PRINTERADMIN">printer admin = @ntadmin </a></span></dt><dd><p> 390 <a class="indexterm" name="id2617489"></a>391 <a class="indexterm" name="id2617495"></a>392 390 <a class="indexterm" name="id2617502"></a> 393 391 <a class="indexterm" name="id2617508"></a> 392 <a class="indexterm" name="id2617515"></a> 393 <a class="indexterm" name="id2617522"></a> 394 394 Members of the ntadmin group should be able to add drivers and set printer properties 395 395 (<code class="constant">ntadmin</code> is only an example name; it needs to be a valid UNIX group name); root is … … 400 400 per-share parameter. This permits different groups to administer each printer share. 401 401 </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#LPQCACHETIME">lpq cache time = 20 </a></span></dt><dd><p> 402 <a class="indexterm" name="id2617 590"></a>403 <a class="indexterm" name="id2617 596"></a>402 <a class="indexterm" name="id2617603"></a> 403 <a class="indexterm" name="id2617609"></a> 404 404 Controls the cache time for the results of the lpq command. It prevents the lpq command being called too often 405 405 and reduces the load on a heavily used print server. 406 406 </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#USECLIENTDRIVER">use client driver = no </a></span></dt><dd><p> 407 <a class="indexterm" name="id26176 25"></a>407 <a class="indexterm" name="id2617638"></a> 408 408 If set to <code class="constant">yes</code>, only takes effect for Windows NT/200x/XP clients (and not for Win 409 409 95/98/ME). Its default value is <code class="constant">No</code> (or <code class="constant">False</code>). It must … … 412 412 explanations, see the <code class="filename">smb.conf</code> man page. 413 413 </p></dd></dl></div></div><div class="sect3" lang="en"><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="id26176 77"></a>415 <a class="indexterm" name="id26176 83"></a>414 <a class="indexterm" name="id2617690"></a> 415 <a class="indexterm" name="id2617697"></a> 416 416 The printers section is the second special section. If a section with this name appears in the <code class="filename">smb.conf</code>, 417 417 users are able to connect to any printer specified in the Samba host's printcap file, because Samba on startup … … 469 469 </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#WRITABLE">writable = no </a></span></dt><dd><p> 470 470 Is a synonym for <a class="link" href="smb.conf.5.html#READONLY">read only = yes</a>. 471 </p></dd></dl></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id26180 70"></a>Any [my_printer_name] Section</h4></div></div></div><p>472 <a class="indexterm" name="id26180 78"></a>473 <a class="indexterm" name="id26180 85"></a>471 </p></dd></dl></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2618083"></a>Any [my_printer_name] Section</h4></div></div></div><p> 472 <a class="indexterm" name="id2618092"></a> 473 <a class="indexterm" name="id2618098"></a> 474 474 If a <em class="parameter"><code>[my_printer_name]</code></em> section appears in the <code class="filename">smb.conf</code> file, which includes the 475 475 parameter <a class="link" href="smb.conf.5.html#PRINTABLE">printable = yes</a> Samba will configure it as a printer share. … … 503 503 </p></dd><dt><span class="term"><a class="link" href="smb.conf.5.html#GUESTOK">guest ok = no </a></span></dt><dd><p> 504 504 This printer is not open for the guest account. 505 </p></dd></dl></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2618365"></a>Print Commands</h4></div></div></div><p> 506 <a class="indexterm" name="id2618372"></a> 507 <a class="indexterm" name="id2618379"></a> 505 </p></dd></dl></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2618378"></a>Print Commands</h4></div></div></div><p> 508 506 <a class="indexterm" name="id2618386"></a> 509 <a class="indexterm" name="id2618393"></a> 507 <a class="indexterm" name="id2618392"></a> 508 <a class="indexterm" name="id2618399"></a> 509 <a class="indexterm" name="id2618406"></a> 510 510 In each section defining a printer (or in the <em class="parameter"><code>[printers]</code></em> section), 511 511 a <em class="parameter"><code>print command</code></em> parameter may be defined. It sets a command to process the files … … 519 519 make sure you pay attention to the need to remove the files from the Samba spool directory. Otherwise, 520 520 your hard disk may soon suffer from shortage of free space. 521 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id26184 41"></a>Default UNIX System Printing Commands</h4></div></div></div><p>522 <a class="indexterm" name="id26184 48"></a>521 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2618454"></a>Default UNIX System Printing Commands</h4></div></div></div><p> 522 <a class="indexterm" name="id2618462"></a> 523 523 You learned earlier that Samba, in most cases, uses its built-in settings for many parameters if it cannot 524 524 find an explicitly stated one in its configuration file. The same is true for the <a class="link" href="smb.conf.5.html#PRINTCOMMAND">print command</a>. The default print command varies depending on the <a class="link" href="smb.conf.5.html#PRINTING">printing</a> parameter … … 529 529 of 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>. 530 530 </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">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">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">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">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">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">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">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">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">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">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">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">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">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">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">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="id2618912"></a>532 <a class="indexterm" name="id2618918"></a>533 531 <a class="indexterm" name="id2618925"></a> 534 532 <a class="indexterm" name="id2618932"></a> 533 <a class="indexterm" name="id2618938"></a> 534 <a class="indexterm" name="id2618946"></a> 535 535 For <em class="parameter"><code>printing = CUPS</code></em>, if Samba is compiled against libcups, it uses the CUPS API to 536 536 submit jobs. (It is a good idea also to set <a class="link" href="smb.conf.5.html#PRINTCAP">printcap = cups</a> in case your … … 539 539 <code class="literal">lp -c -d%p -oraw; rm %s</code>. With <em class="parameter"><code>printing = cups</code></em>, and if Samba is 540 540 compiled against libcups, any manually set print command will be ignored! 541 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id26189 84"></a>Custom Print Commands</h4></div></div></div><p>542 <a class="indexterm" name="id261 8992"></a>543 <a class="indexterm" name="id261 8999"></a>541 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2618998"></a>Custom Print Commands</h4></div></div></div><p> 542 <a class="indexterm" name="id2619006"></a> 543 <a class="indexterm" name="id2619012"></a> 544 544 After a print job has finished spooling to a service, the <a class="link" href="smb.conf.5.html#PRINTCOMMAND">print command</a> will be used 545 545 by Samba via a system() call to process the spool file. Usually the command specified will submit the spool … … 548 548 that the spool file is deleted after it has been processed. 549 549 </p><p> 550 <a class="indexterm" name="id2619029"></a>551 <a class="indexterm" name="id2619036"></a>552 550 <a class="indexterm" name="id2619042"></a> 553 551 <a class="indexterm" name="id2619049"></a> 552 <a class="indexterm" name="id2619056"></a> 553 <a class="indexterm" name="id2619063"></a> 554 554 There is no difficulty with using your own customized print commands with the traditional printing systems. 555 555 However, if you do not wish to roll your own, you should be well informed about the default built-in commands … … 561 561 printing, the following ones do have special relevance: 562 562 </p><div class="itemizedlist"><ul type="disc"><li><p><em class="parameter"><code>%s, %f</code></em> the path to the spool file name.</p></li><li><p><em class="parameter"><code>%p</code></em> the appropriate printer name.</p></li><li><p><em class="parameter"><code>%J</code></em> the job name as transmitted by the client.</p></li><li><p><em class="parameter"><code>%c</code></em> the number of printed pages of the spooled job (if known).</p></li><li><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="id26191 48"></a>563 <a class="indexterm" name="id2619161"></a> 564 564 The print command must contain at least one occurrence of <em class="parameter"><code>%s</code></em> or 565 565 <em class="parameter"><code>%f</code></em>. The <em class="parameter"><code>%p</code></em> is optional. If no printer name is supplied, … … 567 567 sent to the default printer. 568 568 </p><p> 569 <a class="indexterm" name="id26191 84"></a>570 <a class="indexterm" name="id2619 191"></a>569 <a class="indexterm" name="id2619197"></a> 570 <a class="indexterm" name="id2619204"></a> 571 571 If specified in the <em class="parameter"><code>[global]</code></em> section, the print command given will be 572 572 used for any printable service that does not have its own print command specified. If there is neither a … … 574 574 but not processed! Most importantly, print files will not be removed, so they will consume disk space. 575 575 </p><p> 576 <a class="indexterm" name="id26192 13"></a>577 <a class="indexterm" name="id26192 20"></a>576 <a class="indexterm" name="id2619226"></a> 577 <a class="indexterm" name="id2619233"></a> 578 578 Printing may fail on some UNIX systems when using the <span class="emphasis"><em>nobody</em></span> account. If this happens, create an 579 579 alternative guest account and give it the privilege to print. Set up this guest account in the 580 580 <em class="parameter"><code>[global]</code></em> section with the <em class="parameter"><code>guest account</code></em> parameter. 581 581 </p><p> 582 <a class="indexterm" name="id26192 50"></a>583 <a class="indexterm" name="id26192 57"></a>584 <a class="indexterm" name="id26192 64"></a>582 <a class="indexterm" name="id2619263"></a> 583 <a class="indexterm" name="id2619270"></a> 584 <a class="indexterm" name="id2619277"></a> 585 585 You can form quite complex print commands. You need to realize that print commands are just 586 586 passed to a UNIX shell. The shell is able to expand the included environment variables as … … 590 590 to <code class="filename">/tmp/print.log</code>, print the file, then remove it. The semicolon (“<span class="quote">;</span>” 591 591 is the usual separator for commands in shell scripts: 592 </p><table class="simplelist" border="0" summary="Simple list"><tr><td><a class="indexterm" name="id26193 19"></a><em class="parameter"><code>print command = echo Printing %s >> /tmp/print.log; lpr -P %p %s; rm %s</code></em></td></tr></table><p>592 </p><table class="simplelist" border="0" summary="Simple list"><tr><td><a class="indexterm" name="id2619332"></a><em class="parameter"><code>print command = echo Printing %s >> /tmp/print.log; lpr -P %p %s; rm %s</code></em></td></tr></table><p> 593 593 You may have to vary your own command considerably from this example depending on how you normally print 594 594 files on your system. The default for the <a class="link" href="smb.conf.5.html#PRINTCOMMAND">print command</a> 595 595 parameter varies depending on the setting of the <a class="link" href="smb.conf.5.html#PRINTING">printing</a> 596 596 parameter. Another example is: 597 </p><table class="simplelist" border="0" summary="Simple list"><tr><td><a class="indexterm" name="id2619370"></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" lang="en"><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="id2619396"></a> 599 <a class="indexterm" name="id2619403"></a> 597 </p><table class="simplelist" border="0" summary="Simple list"><tr><td><a class="indexterm" name="id2619383"></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" lang="en"><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> 600 598 <a class="indexterm" name="id2619409"></a> 599 <a class="indexterm" name="id2619416"></a> 600 <a class="indexterm" name="id2619423"></a> 601 601 Prior to Samba-2.2.x, print server support for Windows clients was limited to <span class="emphasis"><em>LanMan</em></span> 602 602 printing calls. This is the same protocol level as Windows 9x/Me PCs offer when they share printers. … … 607 607 The additional functionality provided by the new SPOOLSS support includes: 608 608 </p><div class="itemizedlist"><ul type="disc"><li><p> 609 <a class="indexterm" name="id26194 45"></a>609 <a class="indexterm" name="id2619458"></a> 610 610 Support for downloading printer driver files to Windows 95/98/NT/2000 clients upon 611 611 demand (<span class="emphasis"><em>Point'n'Print</em></span>). 612 612 </p></li><li><p> 613 <a class="indexterm" name="id26194 61"></a>613 <a class="indexterm" name="id2619475"></a> 614 614 Uploading of printer drivers via the Windows NT <span class="emphasis"><em>Add Printer Wizard</em></span> (APW) 615 615 or the <a class="ulink" href="http://imprints.sourceforge.net/" target="_top">Imprints</a> tool set. 616 616 </p></li><li><p> 617 <a class="indexterm" name="id26194 84"></a>618 <a class="indexterm" name="id2619 491"></a>619 <a class="indexterm" name="id2619 498"></a>620 <a class="indexterm" name="id26195 05"></a>621 <a class="indexterm" name="id26195 12"></a>617 <a class="indexterm" name="id2619497"></a> 618 <a class="indexterm" name="id2619504"></a> 619 <a class="indexterm" name="id2619511"></a> 620 <a class="indexterm" name="id2619518"></a> 621 <a class="indexterm" name="id2619525"></a> 622 622 Support for the native MS-RPC printing calls such as StartDocPrinter, EnumJobs(), and so on. (See the 623 623 <a class="ulink" href="http://msdn.microsoft.com/" target="_top">MSDN documentation</a> for more information on the 624 624 Win32 printing API). 625 625 </p></li><li><p> 626 <a class="indexterm" name="id26195 32"></a>627 <a class="indexterm" name="id26195 38"></a>626 <a class="indexterm" name="id2619545"></a> 627 <a class="indexterm" name="id2619552"></a> 628 628 Support for NT Access Control Lists (ACL) on printer objects. 629 629 </p></li><li><p> 630 <a class="indexterm" name="id26195 51"></a>630 <a class="indexterm" name="id2619564"></a> 631 631 Improved support for printer queue manipulation through the use of internal databases for spooled 632 632 job information (implemented by various <code class="filename">*.tdb</code> files). 633 633 </p></li></ul></div><p> 634 <a class="indexterm" name="id26195 70"></a>635 <a class="indexterm" name="id26195 77"></a>634 <a class="indexterm" name="id2619584"></a> 635 <a class="indexterm" name="id2619590"></a> 636 636 A benefit of updating is that Samba-3 is able to publish its printers to Active Directory (or LDAP). 637 637 </p><p> 638 <a class="indexterm" name="id2619 589"></a>638 <a class="indexterm" name="id2619602"></a> 639 639 A fundamental difference exists between MS Windows NT print servers and Samba operation. Windows NT 640 640 permits the installation of local printers that are not shared. This is an artifact of the fact that … … 642 642 printers that are made available, either by default or by specific declaration via printer-specific shares. 643 643 </p><p> 644 <a class="indexterm" name="id2619606"></a>645 <a class="indexterm" name="id2619613"></a>646 644 <a class="indexterm" name="id2619619"></a> 647 645 <a class="indexterm" name="id2619626"></a> 648 646 <a class="indexterm" name="id2619633"></a> 647 <a class="indexterm" name="id2619640"></a> 648 <a class="indexterm" name="id2619646"></a> 649 649 Windows NT/200x/XP Professional clients do not have to use the standard SMB printer share; they can 650 650 print directly to any printer on another Windows NT host using MS-RPC. This, of course, assumes that … … 653 653 <span class="emphasis"><em>Everyone</em></span> group. (The older clients of type Windows 9x/Me can only print to shared 654 654 printers.) 655 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26196 53"></a>Point'n'Print Client Drivers on Samba Servers</h3></div></div></div><p>656 <a class="indexterm" name="id26196 62"></a>655 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2619666"></a>Point'n'Print Client Drivers on Samba Servers</h3></div></div></div><p> 656 <a class="indexterm" name="id2619675"></a> 657 657 There is much confusion about what all this means. The question is often asked, “<span class="quote">Is it or is 658 658 it not necessary for printer drivers to be installed on a Samba host in order to support printing from 659 659 Windows clients?</span>” The answer to this is no, it is not necessary. 660 660 </p><p> 661 <a class="indexterm" name="id26196 80"></a>662 <a class="indexterm" name="id2619 686"></a>661 <a class="indexterm" name="id2619693"></a> 662 <a class="indexterm" name="id2619700"></a> 663 663 Windows NT/2000 clients can, of course, also run their APW to install drivers <span class="emphasis"><em>locally</em></span> 664 664 (which then connect to a Samba-served print queue). This is the same method used by Windows 9x/Me … … 666 666 require that the Samba server possess a valid driver for the printer. This was fixed in Samba 2.2.1). 667 667 </p><p> 668 <a class="indexterm" name="id26197 06"></a>669 <a class="indexterm" name="id26197 13"></a>668 <a class="indexterm" name="id2619719"></a> 669 <a class="indexterm" name="id2619726"></a> 670 670 But it is a new capability to install the printer drivers into the <em class="parameter"><code>[print$]</code></em> 671 671 share of the Samba server, and a big convenience, too. Then <span class="emphasis"><em>all</em></span> clients … … 683 683 Using <span class="emphasis"><em>cupsaddsmb</em></span> (only works for the CUPS printing system, not for LPR/LPD, LPRng, and so on). 684 684 </p></li></ul></div><p> 685 <a class="indexterm" name="id2619 795"></a>686 <a class="indexterm" name="id26198 02"></a>685 <a class="indexterm" name="id2619808"></a> 686 <a class="indexterm" name="id2619815"></a> 687 687 Samba does not use these uploaded drivers in any way to process spooled files. These drivers are utilized 688 688 entirely by the clients who download and install them via the “<span class="quote">Point'n'Print</span>” mechanism … … 690 690 (or the UNIX print system) requires. Print files received by Samba are handed over to the UNIX printing 691 691 system, which is responsible for all further processing, as needed. 692 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26198 23"></a>The Obsoleted [printer$] Section</h3></div></div></div><p>693 <a class="indexterm" name="id26198 31"></a>694 <a class="indexterm" name="id26198 38"></a>692 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2619836"></a>The Obsoleted [printer$] Section</h3></div></div></div><p> 693 <a class="indexterm" name="id2619844"></a> 694 <a class="indexterm" name="id2619851"></a> 695 695 Versions of Samba prior to 2.2 made it possible to use a share named <em class="parameter"><code>[printer$]</code></em>. This 696 696 name was taken from the same named service created by Windows 9x/Me clients when a printer was shared by them. … … 702 702 be sent to the client. 703 703 </p><p> 704 <a class="indexterm" name="id2619882"></a>705 <a class="indexterm" name="id2619889"></a>706 704 <a class="indexterm" name="id2619896"></a> 705 <a class="indexterm" name="id2619902"></a> 706 <a class="indexterm" name="id2619909"></a> 707 707 These parameters, including the <em class="parameter"><code>printer driver file</code></em> parameter, 708 708 are now removed and cannot be used in installations of Samba-3. The share name … … 714 714 9x/Me clients are now thrown aside. They can use Samba's <em class="parameter"><code>[print$]</code></em> 715 715 share support just fine. 716 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26199 44"></a>Creating the [print$] Share</h3></div></div></div><p>717 <a class="indexterm" name="id26199 52"></a>716 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2619957"></a>Creating the [print$] Share</h3></div></div></div><p> 717 <a class="indexterm" name="id2619965"></a> 718 718 In order to support the uploading and downloading of printer driver files, you must first configure a 719 719 file share named <em class="parameter"><code>[print$]</code></em>. The public name of this share is hard coded … … 725 725 as <a class="link" href="smb.conf.5.html#PATH">path</a>, are arbitrary and should be replaced with appropriate values for your 726 726 site). 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 class="simplelist" border="0" summary="Simple list"><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="id26200 36"></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="id2620073"></a><em class="parameter"><code>comment = Printer Driver Download Area</code></em></td></tr><tr><td><a class="indexterm" name="id2620084"></a><em class="parameter"><code>path = /etc/samba/drivers</code></em></td></tr><tr><td><a class="indexterm" name="id2620096"></a><em class="parameter"><code>browseable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2620108"></a><em class="parameter"><code>guest ok = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2620119"></a><em class="parameter"><code>read only = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2620131"></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 class="simplelist" border="0" summary="Simple list"><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="id2620050"></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="id2620085"></a><em class="parameter"><code>comment = Printer Driver Download Area</code></em></td></tr><tr><td><a class="indexterm" name="id2620097"></a><em class="parameter"><code>path = /etc/samba/drivers</code></em></td></tr><tr><td><a class="indexterm" name="id2620109"></a><em class="parameter"><code>browseable = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2620121"></a><em class="parameter"><code>guest ok = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2620132"></a><em class="parameter"><code>read only = yes</code></em></td></tr><tr><td><a class="indexterm" name="id2620144"></a><em class="parameter"><code>write list = @ntadmin, root</code></em></td></tr></table></div></div><br class="example-break"><p> 728 728 Of course, you also need to ensure that the directory named by the 729 729 <a class="link" href="smb.conf.5.html#PATH">path</a> parameter exists on the UNIX file system. 730 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2620161"></a>[print$] Stanza Parameters</h3></div></div></div><p> 731 <a class="indexterm" name="id2620169"></a> 732 <a class="indexterm" name="id2620176"></a> 730 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2620174"></a>[print$] Stanza Parameters</h3></div></div></div><p> 733 731 <a class="indexterm" name="id2620182"></a> 734 732 <a class="indexterm" name="id2620189"></a> 735 733 <a class="indexterm" name="id2620196"></a> 734 <a class="indexterm" name="id2620203"></a> 735 <a class="indexterm" name="id2620210"></a> 736 736 The <em class="parameter"><code>[print$]</code></em> is a special section in <code class="filename">smb.conf</code>. It contains settings relevant to 737 737 potential printer driver download and is used by Windows clients for local print driver installation. … … 778 778 be mentioned in the global <a class="link" href="smb.conf.5.html#PRINTERADMIN">printer admin</a> 779 779 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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26204 81"></a>The [print$] Share Directory</h3></div></div></div><p>780 </p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2620495"></a>The [print$] Share Directory</h3></div></div></div><p> 781 781 In order for a Windows NT print server to support the downloading of driver files by multiple client 782 782 architectures, you must create several subdirectories within the <em class="parameter"><code>[print$]</code></em> … … 813 813 have located the server, navigate to its <span class="guiicon">Printers and Faxes</span> folder. You should see 814 814 an initial listing of printers that matches the printer shares defined on your Samba host. 815 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26206 24"></a>Installing Drivers into [print$]</h2></div></div></div><p>815 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2620637"></a>Installing Drivers into [print$]</h2></div></div></div><p> 816 816 Have you successfully created the <em class="parameter"><code>[print$]</code></em> share in <code class="filename">smb.conf</code>, and have you forced 817 817 Samba to reread its <code class="filename">smb.conf</code> file? Good. But you are not yet ready to use the new facility. The client … … 829 829 </p></li></ul></div><p> 830 830 The latter option is probably the easier one (even if the process may seem a little bit weird at first). 831 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26207 17"></a>Add Printer Wizard Driver Installation</h3></div></div></div><p>831 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2620730"></a>Add Printer Wizard Driver Installation</h3></div></div></div><p> 832 832 The printers initially listed in the Samba host's <span class="guiicon">Printers</span> folder accessed from a 833 833 client's Explorer will have no real printer driver assigned to them. By default this driver name is set … … 880 880 </p></li></ol></div><p> 881 881 We provide detailed hints for each of these steps in the paragraphs that follow. 882 </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id262 0993"></a>Identifying Driver Files</h4></div></div></div><p>883 <a class="indexterm" name="id26210 01"></a>884 <a class="indexterm" name="id26210 08"></a>885 <a class="indexterm" name="id26210 15"></a>882 </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2621006"></a>Identifying Driver Files</h4></div></div></div><p> 883 <a class="indexterm" name="id2621014"></a> 884 <a class="indexterm" name="id2621021"></a> 885 <a class="indexterm" name="id2621028"></a> 886 886 To find out about the driver files, you have two options. You can check the contents of the driver 887 887 CDROM that came with your printer. Study the <code class="filename">*.inf</code> files located on the CD-ROM. This … … 891 891 extremely difficult to identify the driver files required. 892 892 </p><p> 893 <a class="indexterm" name="id26210 45"></a>893 <a class="indexterm" name="id2621059"></a> 894 894 Then you have the second option. Install the driver locally on a Windows client and 895 895 investigate which filenames and paths it uses after they are installed. (You need to repeat … … 898 898 clients.) 899 899 </p><p> 900 <a class="indexterm" name="id26210 72"></a>900 <a class="indexterm" name="id2621085"></a> 901 901 A good method to recognize the driver files is to print the test page from the driver's 902 902 <span class="guilabel">Properties</span> dialog (<span class="guilabel">General</span> tab). Then look at the list of … … 906 906 (this may vary slightly for Windows NT). You need to note all filenames for the next steps. 907 907 </p><p> 908 <a class="indexterm" name="id2621128"></a>909 <a class="indexterm" name="id2621135"></a>910 908 <a class="indexterm" name="id2621142"></a> 909 <a class="indexterm" name="id2621148"></a> 910 <a class="indexterm" name="id2621155"></a> 911 911 Another method to quickly test the driver filenames and related paths is provided by the 912 912 <code class="literal">rpcclient</code> utility. Run it with <code class="literal">enumdrivers</code> or with the … … 949 949 Defaultdatatype: [] 950 950 </pre><p> 951 <a class="indexterm" name="id2621258"></a>952 <a class="indexterm" name="id2621264"></a>953 951 <a class="indexterm" name="id2621271"></a> 954 952 <a class="indexterm" name="id2621278"></a> 953 <a class="indexterm" name="id2621284"></a> 954 <a class="indexterm" name="id2621291"></a> 955 955 You may notice that this driver has quite a large number of <span class="guilabel">Dependent files</span> 956 956 (there are worse cases, however). Also, strangely, the … … 962 962 Windows PC. This PC can also host the Windows 9x/Me drivers, even if it runs on Windows NT, 2000, or XP. 963 963 </p><p> 964 <a class="indexterm" name="id2621326"></a>965 <a class="indexterm" name="id2621333"></a>966 964 <a class="indexterm" name="id2621340"></a> 965 <a class="indexterm" name="id2621346"></a> 966 <a class="indexterm" name="id2621353"></a> 967 967 Since the <em class="parameter"><code>[print$]</code></em> share is usually accessible through the <span class="guiicon">Network 968 968 Neighborhood</span>, you can also use the UNC notation from Windows Explorer to poke at it. The Windows … … 975 975 the Admin), its native mode for printer drivers is user mode execution. This requires drivers designed 976 976 for this purpose. These types of drivers install into the “<span class="quote">3</span>” subdirectory. 977 </p></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id26214 04"></a>Obtaining Driver Files from Windows Client [print$] Shares</h4></div></div></div><p>977 </p></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2621417"></a>Obtaining Driver Files from Windows Client [print$] Shares</h4></div></div></div><p> 978 978 Now we need to collect all the driver files we identified in our previous step. Where do we get them 979 979 from? Well, why not retrieve them from the very PC and the same <em class="parameter"><code>[print$]</code></em> … … 1000 1000 <code class="literal">smbclient</code> exits again. 1001 1001 </p><p> 1002 <a class="indexterm" name="id26215 11"></a>1002 <a class="indexterm" name="id2621525"></a> 1003 1003 Remember to repeat the procedure for the <span class="application">WIN40</span> architecture should you need to 1004 1004 support Windows 9x/Me/XP clients. Remember too, the files for these architectures are in the 1005 1005 <code class="filename">WIN40/0/</code> subdirectory. Once this is complete, we can run <code class="literal">smbclient. . 1006 1006 .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" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id26215 49"></a>Installing Driver Files into [print$]</h4></div></div></div><p>1007 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2621562"></a>Installing Driver Files into [print$]</h4></div></div></div><p> 1008 1008 We are now going to locate the driver files into the <em class="parameter"><code>[print$]</code></em> share. Remember, the 1009 1009 UNIX path to this share has been defined previously in your <code class="filename">smb.conf</code> file. You also have created … … 1018 1018 (yet) into the <code class="filename">0</code> subdirectory. 1019 1019 </p></li></ul></div><p> 1020 <a class="indexterm" name="id26216 28"></a>1021 <a class="indexterm" name="id26216 35"></a>1020 <a class="indexterm" name="id2621641"></a> 1021 <a class="indexterm" name="id2621648"></a> 1022 1022 We again use smbclient to transfer the driver files across the network. We specify the same files 1023 1023 and paths as were leaked to us by running <code class="literal">getdriver</code> against the original … … 1056 1056 putting file HDNIS01_de.NTF as \W32X86\HDNIS01_de.NTF 1057 1057 </pre><p> 1058 <a class="indexterm" name="id26217 07"></a>1059 <a class="indexterm" name="id26217 14"></a>1060 <a class="indexterm" name="id26217 21"></a>1058 <a class="indexterm" name="id2621720"></a> 1059 <a class="indexterm" name="id2621727"></a> 1060 <a class="indexterm" name="id2621734"></a> 1061 1061 Whew that was a lot of typing! Most drivers are a lot smaller many have only three generic 1062 1062 PostScript driver files plus one PPD. While we did retrieve the files from the <code class="filename">2</code> … … 1065 1065 <code class="literal">adddriver</code> command, which we will run shortly (and do not forget to also put the files 1066 1066 for the Windows 9x/Me architecture into the <code class="filename">WIN40/</code> subdirectory should you need them). 1067 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id26217 67"></a><code class="literal">smbclient</code> to Confirm Driver Installation</h4></div></div></div><p>1068 <a class="indexterm" name="id26217 80"></a>1069 <a class="indexterm" name="id2621 786"></a>1067 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2621780"></a><code class="literal">smbclient</code> to Confirm Driver Installation</h4></div></div></div><p> 1068 <a class="indexterm" name="id2621793"></a> 1069 <a class="indexterm" name="id2621800"></a> 1070 1070 For now we verify that our files are there. This can be done with <code class="literal">smbclient</code>, too 1071 1071 (but, of course, you can log in via SSH also and do this through a standard UNIX shell access): … … 1108 1108 40976 blocks of size 262144. 709 blocks available 1109 1109 </pre><p> 1110 <a class="indexterm" name="id2621861"></a>1111 <a class="indexterm" name="id2621868"></a>1112 1110 <a class="indexterm" name="id2621875"></a> 1111 <a class="indexterm" name="id2621882"></a> 1112 <a class="indexterm" name="id2621889"></a> 1113 1113 Notice that there are already driver files present in the <code class="filename">2</code> subdirectory (probably from a 1114 1114 previous installation). Once the files for the new driver are there too, you are still a few steps away from … … 1118 1118 special, namely <span class="emphasis"><em>printer driver files</em></span>, and it does not know to which print queue(s) these 1119 1119 driver files belong. 1120 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2621904"></a>Running <code class="literal">rpcclient</code> with <code class="literal">adddriver</code></h4></div></div></div><p> 1121 <a class="indexterm" name="id2621922"></a> 1122 <a class="indexterm" name="id2621929"></a> 1120 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2621917"></a>Running <code class="literal">rpcclient</code> with <code class="literal">adddriver</code></h4></div></div></div><p> 1123 1121 <a class="indexterm" name="id2621936"></a> 1122 <a class="indexterm" name="id2621942"></a> 1123 <a class="indexterm" name="id2621950"></a> 1124 1124 Next, you must tell Samba about the special category of the files you just uploaded into the 1125 1125 <em class="parameter"><code>[print$]</code></em> share. This is done by the <code class="literal">adddriver</code> … … 1145 1145 Printer Driver dm9110 successfully installed. 1146 1146 </pre><p> 1147 <a class="indexterm" name="id262 1991"></a>1148 <a class="indexterm" name="id262 1998"></a>1149 <a class="indexterm" name="id26220 05"></a>1147 <a class="indexterm" name="id2622004"></a> 1148 <a class="indexterm" name="id2622011"></a> 1149 <a class="indexterm" name="id2622018"></a> 1150 1150 After this step, the driver should be recognized by Samba on the print server. You need to be very 1151 1151 careful when typing the command. Don't exchange the order of the fields. Some changes would lead to … … 1154 1154 Hints about the syntax of the adddriver command are in the man page. 1155 1155 provides a more detailed description, should you need it. 1156 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id26220 28"></a>Checking <code class="literal">adddriver</code> Completion</h4></div></div></div><p>1156 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2622041"></a>Checking <code class="literal">adddriver</code> Completion</h4></div></div></div><p> 1157 1157 One indication for Samba's recognition of the files as driver files is the <code class="computeroutput">successfully 1158 1158 installed</code> message. Another one is the fact that our files have been moved by the … … 1199 1199 Another verification is that the timestamp of the printing TDB files is now updated 1200 1200 (and possibly their file size has increased). 1201 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id26221 70"></a>Check Samba for Driver Recognition</h4></div></div></div><p>1202 <a class="indexterm" name="id26221 78"></a>1201 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2622183"></a>Check Samba for Driver Recognition</h4></div></div></div><p> 1202 <a class="indexterm" name="id2622191"></a> 1203 1203 Now the driver should be registered with Samba. We can easily verify this and will do so in a 1204 1204 moment. However, this driver is not yet associated with a particular printer. We may check the driver 1205 1205 status of the files by at least three methods: 1206 1206 </p><div class="itemizedlist"><ul type="disc"><li><p> 1207 <a class="indexterm" name="id2622196"></a> 1208 <a class="indexterm" name="id2622203"></a> 1209 <a class="indexterm" name="id2622210"></a> 1207 <a class="indexterm" name="id2622209"></a> 1210 1208 <a class="indexterm" name="id2622216"></a> 1211 1209 <a class="indexterm" name="id2622223"></a> 1210 <a class="indexterm" name="id2622230"></a> 1211 <a class="indexterm" name="id2622237"></a> 1212 1212 From any Windows client browse Network Neighborhood, find the Samba host, and open the Samba 1213 1213 <span class="guiicon">Printers and Faxes</span> folder. Select any printer icon, right-click and select … … 1219 1219 the list will differ if you look at it from Windows95/98/ME or Windows NT/2000/XP.) 1220 1220 </p></li><li><p> 1221 <a class="indexterm" name="id26222 63"></a>1221 <a class="indexterm" name="id2622276"></a> 1222 1222 From a Windows 200x/XP client (not Windows NT) browse <span class="guiicon">Network Neighborhood</span>, 1223 1223 search for the Samba server, open the server's <span class="guiicon">Printers</span> folder, … … 1248 1248 95, 98, and Me</span>, you'll have to repeat the whole procedure with the WIN40 architecture 1249 1249 and subdirectory. 1250 </p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2622 397"></a>Specific Driver Name Flexibility</h4></div></div></div><p>1251 <a class="indexterm" name="id26224 06"></a>1250 </p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2622411"></a>Specific Driver Name Flexibility</h4></div></div></div><p> 1251 <a class="indexterm" name="id2622419"></a> 1252 1252 You can name the driver as you like. If you repeat the <code class="literal">adddriver</code> step with the same 1253 1253 files as before but with a different driver name, it will work the same: … … 1272 1272 Printer Driver mydrivername successfully installed. 1273 1273 </pre><p> 1274 <a class="indexterm" name="id26224 53"></a>1275 <a class="indexterm" name="id26224 60"></a>1276 <a class="indexterm" name="id26224 67"></a>1274 <a class="indexterm" name="id2622466"></a> 1275 <a class="indexterm" name="id2622473"></a> 1276 <a class="indexterm" name="id2622480"></a> 1277 1277 You will be able to bind that driver to any print queue (however, you are responsible that 1278 1278 you associate drivers to queues that make sense with respect to target printers). You cannot run the … … 1281 1281 respective subdirectories, so you must execute an <code class="literal">smbclient ... put</code> command before 1282 1282 each <code class="literal">rpcclient ... adddriver</code> command. 1283 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id26225 12"></a>Running <code class="literal">rpcclient</code> with <code class="literal">setdriver</code></h4></div></div></div><p>1284 <a class="indexterm" name="id26225 30"></a>1285 <a class="indexterm" name="id26225 37"></a>1283 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2622525"></a>Running <code class="literal">rpcclient</code> with <code class="literal">setdriver</code></h4></div></div></div><p> 1284 <a class="indexterm" name="id2622543"></a> 1285 <a class="indexterm" name="id2622550"></a> 1286 1286 Samba needs to know which printer owns which driver. Create a mapping of the driver to a printer, and 1287 1287 store this information in Samba's memory, the TDB files. The <code class="literal">rpcclient setdriver</code> command … … 1310 1310 or at least send an HUP signal to all running smbd processes to work around this: <strong class="userinput"><code>kill -HUP 1311 1311 `pidof smbd`</code></strong>. 1312 </p></div></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26226 52"></a>Client Driver Installation Procedure</h2></div></div></div><p>1312 </p></div></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2622666"></a>Client Driver Installation Procedure</h2></div></div></div><p> 1313 1313 As Don Quixote said, “<span class="quote">The proof of the pudding is in the eating.</span>” The proof 1314 1314 for our setup lies in the printing. So let's install the printer driver onto the client PCs. This is 1315 1315 not as straightforward as it may seem. Read on. 1316 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26226 69"></a>First Client Driver Installation</h3></div></div></div><p>1316 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2622682"></a>First Client Driver Installation</h3></div></div></div><p> 1317 1317 Especially important is the installation onto the first client PC (for each architectural platform 1318 1318 separately). Once this is done correctly, all further clients are easy to set up and shouldn't need further … … 1348 1348 and Faxes</span>). 1349 1349 </p><p> 1350 <a class="indexterm" name="id26228 46"></a>1350 <a class="indexterm" name="id2622859"></a> 1351 1351 Most likely you are tempted to try to print a test page. After all, you now can open the printer 1352 1352 properties, and on the <span class="guimenu">General</span> tab there is a button offering to do just that. But … … 1360 1360 For a printer to be truly usable by a Windows NT/200x/XP client, it must possess: 1361 1361 </p><div class="itemizedlist"><ul type="disc"><li><p> 1362 <a class="indexterm" name="id26229 07"></a>1362 <a class="indexterm" name="id2622920"></a> 1363 1363 A valid <span class="emphasis"><em>device mode</em></span> generated by the driver for the printer (defining things 1364 1364 like paper size, orientation and duplex settings). 1365 1365 </p></li><li><p> 1366 <a class="indexterm" name="id26229 24"></a>1366 <a class="indexterm" name="id2622937"></a> 1367 1367 A complete set of <span class="emphasis"><em>printer driver data</em></span> generated by the driver. 1368 1368 </p></li></ul></div><p> 1369 <a class="indexterm" name="id2622940"></a> 1370 <a class="indexterm" name="id2622947"></a> 1371 <a class="indexterm" name="id2622954"></a> 1369 <a class="indexterm" name="id2622953"></a> 1372 1370 <a class="indexterm" name="id2622960"></a> 1373 1371 <a class="indexterm" name="id2622967"></a> 1372 <a class="indexterm" name="id2622974"></a> 1373 <a class="indexterm" name="id2622980"></a> 1374 1374 If either of these is incomplete, the clients can produce less than optimal output at best. In the 1375 1375 worst cases, unreadable garbage or nothing at all comes from the printer, or it produces a harvest of … … 1397 1397 effect to happen and feeds back the new device mode to our Samba server. You can use the native Windows 1398 1398 NT/200x/XP printer properties page from a Window client for this: 1399 </p><div class="procedure"><a name="id26230 66"></a><p class="title"><b>Procedure 21.1. Procedure to Initialize the Printer Driver Settings</b></p><ol type="1"><li><p>1399 </p><div class="procedure"><a name="id2623079"></a><p class="title"><b>Procedure 21.1. Procedure to Initialize the Printer Driver Settings</b></p><ol type="1"><li><p> 1400 1400 Browse the <span class="guiicon">Network Neighborhood</span>. 1401 1401 </p></li><li><p> … … 1427 1427 folder, too, if you are a Samba printer admin user. From now on, printing should work as expected. 1428 1428 </p><p> 1429 <a class="indexterm" name="id26232 19"></a>1429 <a class="indexterm" name="id2623233"></a> 1430 1430 Samba includes a service-level parameter name <em class="parameter"><code>default devmode</code></em> for generating a default 1431 1431 device mode for a printer. Some drivers function well with Samba's default set of properties. Others 1432 1432 may crash the client's spooler service. So use this parameter with caution. It is always better to have 1433 1433 the client generate a valid device mode for the printer and store it on the server for you. 1434 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26232 46"></a>Additional Client Driver Installation</h3></div></div></div><p>1435 <a class="indexterm" name="id26232 54"></a>1434 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2623259"></a>Additional Client Driver Installation</h3></div></div></div><p> 1435 <a class="indexterm" name="id2623268"></a> 1436 1436 Every additional driver may be installed in the same way as just described. Browse <code class="literal">Network 1437 1437 Neighborhood</code>, open the <span class="guiicon">Printers</span> folder on Samba server, right-click on … … 1446 1446 </pre><p> 1447 1447 or this command on Windows NT 4.0 workstations: 1448 <a class="indexterm" name="id26233 21"></a>1448 <a class="indexterm" name="id2623335"></a> 1449 1449 </p><pre class="screen"> 1450 1450 <strong class="userinput"><code>rundll32 shell32.dll,Control_RunDLL MAIN.CPL @2</code></strong> … … 1453 1453 You can enter the commands either inside a <span class="guilabel">DOS box</span> window or in the <span class="guimenuitem">Run 1454 1454 command...</span> field from the <span class="guimenu">Start</span> menu. 1455 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26233 65"></a>Always Make First Client Connection as root or “<span class="quote">printer admin</span>”</h3></div></div></div><p>1455 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2623378"></a>Always Make First Client Connection as root or “<span class="quote">printer admin</span>”</h3></div></div></div><p> 1456 1456 After you installed the driver on the Samba server (in its <em class="parameter"><code>[print$]</code></em> share), you 1457 1457 should always make sure that your first client installation completes correctly. Make it a habit for yourself … … 1468 1468 printer for <span class="guiicon">duplex</span> as the default, and so on). 1469 1469 </p><p> 1470 <a class="indexterm" name="id26234 59"></a>1470 <a class="indexterm" name="id2623472"></a> 1471 1471 To connect as root to a Samba printer, try this command from a Windows 200x/XP DOS box command prompt: 1472 1472 </p><pre class="screen"> … … 1482 1482 <code class="literal">Point'n'Print</code>) will have the same defaults set for them. If you miss this step, you'll get a 1483 1483 lot of help desk calls from your users, but maybe you like to talk to people. 1484 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26235 38"></a>Other Gotchas</h2></div></div></div><p>1484 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2623551"></a>Other Gotchas</h2></div></div></div><p> 1485 1485 Your driver is installed. It is now ready for Point'n'Print installation by the clients. You may have tried to 1486 1486 download and use it on your first client machine, but wait. Let's make sure you are acquainted first with a … … 1488 1488 advised in the preceding paragraphs. Your users complain about various issues (such as, “<span class="quote">We need to set 1489 1489 the paper size for each job from Letter to A4 and it will not store it</span>”). 1490 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26235 58"></a>Setting Default Print Options for Client Drivers</h3></div></div></div><p>1490 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2623572"></a>Setting Default Print Options for Client Drivers</h3></div></div></div><p> 1491 1491 The last sentence might be viewed with mixed feelings by some users and Admins. They have struggled for hours 1492 1492 and could not arrive at a point where their settings seemed to be saved. It is not their fault. The confusing … … 1537 1537 defaults for all users. 1538 1538 </p><div class="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="id26238 52"></a>1539 <a class="indexterm" name="id2623865"></a> 1540 1540 </p><p><strong class="userinput"><code> 1541 1541 rundll32 printui.dll,PrintUIEntry /p /t3 /n\\<em class="replaceable"><code>SAMBA-SERVER</code></em>\<em class="replaceable"><code>printersharename</code></em> … … 1548 1548 button (the one that does not set systemwide defaults), you can 1549 1549 start the commands from inside a DOS box or from <span class="guimenu">Start</span> -> <span class="guimenuitem">Run</span>. 1550 </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26239 25"></a>Supporting Large Numbers of Printers</h3></div></div></div><p>1550 </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2623939"></a>Supporting Large Numbers of Printers</h3></div></div></div><p> 1551 1551 One issue that has arisen during the recent development phase of Samba is the need to support driver 1552 1552 downloads for hundreds of printers. Using Windows NT APW for this task is somewhat awkward (to say the least). If … … 1631 1631 the two commas in the description field). After the <code class="literal">setdriver</code> command 1632 1632 succeeds, all is well. 1633 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26241 82"></a>Adding New Printers with the Windows NT APW</h3></div></div></div><p>1633 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2624195"></a>Adding New Printers with the Windows NT APW</h3></div></div></div><p> 1634 1634 By default, Samba exhibits all printer shares defined in <code class="filename">smb.conf</code> in the <span class="guiicon">Printers</span> 1635 1635 folder. Also located in this folder is the Windows NT Add Printer Wizard icon. The APW will be shown only if: … … 1671 1671 you unwittingly under the wrong privilege. You should check it by using the <code class="literal">smbstatus</code> 1672 1672 command. 1673 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26244 41"></a>Error Message: “<span class="quote">Cannot connect under a different Name</span>”</h3></div></div></div><p>1673 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2624455"></a>Error Message: “<span class="quote">Cannot connect under a different Name</span>”</h3></div></div></div><p> 1674 1674 Once you are connected with the wrong credentials, there is no means to reverse the situation other than 1675 1675 to close all Explorer windows, and perhaps reboot. 1676 1676 </p><div class="itemizedlist"><ul type="disc"><li><p> 1677 <a class="indexterm" name="id26244 61"></a>1677 <a class="indexterm" name="id2624474"></a> 1678 1678 The <code class="literal">net use \\SAMBA-SERVER\sharename /user:root</code> gives you an error message: 1679 1679 “<span class="quote">Multiple connections to a server or a shared resource by the same user utilizing … … 1701 1701 </pre><p> 1702 1702 This will also disconnect all mapped drives and will allow you create fresh connection as required. 1703 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26245 55"></a>Take Care When Assembling Driver Files</h3></div></div></div><p>1703 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2624568"></a>Take Care When Assembling Driver Files</h3></div></div></div><p> 1704 1704 You need to be extremely careful when you take notes about the files belonging to a particular 1705 1705 driver. Don't confuse the files for driver version “<span class="quote">0</span>” (for Windows 9x/Me, going into … … 1832 1832 correct driver files for each driver version. Don't rely on the names alone, and don't interchange files 1833 1833 belonging to different driver versions. 1834 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26248 64"></a>Samba and Printer Ports</h3></div></div></div><p>1835 <a class="indexterm" name="id26248 72"></a>1836 <a class="indexterm" name="id26248 79"></a>1837 <a class="indexterm" name="id26248 86"></a>1838 <a class="indexterm" name="id2624 893"></a>1834 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2624877"></a>Samba and Printer Ports</h3></div></div></div><p> 1835 <a class="indexterm" name="id2624885"></a> 1836 <a class="indexterm" name="id2624892"></a> 1837 <a class="indexterm" name="id2624899"></a> 1838 <a class="indexterm" name="id2624906"></a> 1839 1839 Windows NT/2000 print servers associate a port with each printer. These normally take the form of 1840 1840 <code class="filename">LPT1:</code>, <code class="filename">COM1:</code>, <code class="filename">FILE:</code>, and so on. Samba must also … … 1845 1845 information to keep the Windows clients happy. 1846 1846 </p><p> 1847 <a class="indexterm" name="id26249 37"></a>1847 <a class="indexterm" name="id2624950"></a> 1848 1848 Samba does not support the concept of <code class="constant">Printer Pooling</code> internally either. Printer 1849 1849 pooling assigns a logical printer to multiple ports as a form of load balancing or failover. … … 1852 1852 that they are working with Samba), configure the <a class="link" href="smb.conf.5.html#ENUMPORTSCOMMAND">enumports command</a>, 1853 1853 which can be used to define an external program that generates a listing of ports on a system. 1854 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26249 74"></a>Avoiding Common Client Driver Misconfiguration</h3></div></div></div><p>1854 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2624987"></a>Avoiding Common Client Driver Misconfiguration</h3></div></div></div><p> 1855 1855 So now the printing works, but there are still problems. Most jobs print well, some do not print at 1856 1856 all. Some jobs have problems with fonts, which do not look good. Some jobs print fast and some … … 1859 1859 Chapter</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 1860 1860 Client</a>. 1861 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26250 11"></a>The Imprints Toolset</h2></div></div></div><p>1862 <a class="indexterm" name="id26250 19"></a>1861 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2625024"></a>The Imprints Toolset</h2></div></div></div><p> 1862 <a class="indexterm" name="id2625032"></a> 1863 1863 The Imprints tool set provides a UNIX equivalent of the Windows NT APW. For complete information, please 1864 1864 refer to the <a class="ulink" href="http://imprints.sourceforge.net/" target="_top">Imprints</a> Web site as well as the … … 1872 1872 there are prepared packages to use. Packages for more up-to-date print devices are needed if Imprints 1873 1873 should 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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26250 68"></a>What Is Imprints?</h3></div></div></div><p>1874 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2625081"></a>What Is Imprints?</h3></div></div></div><p> 1875 1875 Imprints is a collection of tools for supporting these goals: 1876 1876 </p><div class="itemizedlist"><ul type="disc"><li><p> … … 1881 1881 Providing an installation client that will obtain printer drivers from a central Internet (or intranet) Imprints Server 1882 1882 repository and install them on remote Samba and Windows NT4 print servers. 1883 </p></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26251 02"></a>Creating Printer Driver Packages</h3></div></div></div><p>1883 </p></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2625115"></a>Creating Printer Driver Packages</h3></div></div></div><p> 1884 1884 The process of creating printer driver packages is beyond the scope of this document (refer to Imprints.txt, 1885 1885 included with the Samba distribution for more information). In short, an Imprints driver package 1886 1886 is a gzipped tarball containing the driver files, related INF files, and a control file needed by the 1887 1887 installation client. 1888 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26251 18"></a>The Imprints Server</h3></div></div></div><p>1888 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2625131"></a>The Imprints Server</h3></div></div></div><p> 1889 1889 The Imprints server is really a database server that may be queried via standard HTTP mechanisms. Each 1890 1890 printer entry in the database has an associated URL for the actual downloading of the package. Each … … 1893 1893 the one referred in the Imprints database. It is strongly recommended that this security check 1894 1894 not be disabled. 1895 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26251 35"></a>The Installation Client</h3></div></div></div><p>1895 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2625148"></a>The Installation Client</h3></div></div></div><p> 1896 1896 More information regarding the Imprints installation client is available from the documentation file 1897 1897 <code class="filename">Imprints-Client-HOWTO.ps</code> that is included with the Imprints source package. The Imprints … … 1923 1923 The way of sidestepping this limitation is to require that all Imprints printer driver packages include both the Intel Windows NT and 1924 1924 95/98 printer drivers and that the NT driver is installed first. 1925 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26252 68"></a>Adding Network Printers without User Interaction</h2></div></div></div><p>1925 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2625282"></a>Adding Network Printers without User Interaction</h2></div></div></div><p> 1926 1926 The following MS Knowledge Base article may be of some help if you need to handle Windows 2000 clients: 1927 1927 <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 … … 1982 1982 added, changed, and deleted at will on the server with no user intervention required from the clients 1983 1983 (you just need to keep the logon scripts up to date). 1984 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26255 39"></a>The <code class="literal">addprinter</code> Command</h2></div></div></div><p>1984 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2625553"></a>The <code class="literal">addprinter</code> Command</h2></div></div></div><p> 1985 1985 The <code class="literal">addprinter</code> command can be configured to be a shell script or program executed by 1986 1986 Samba. It is triggered by running the APW from a client against the Samba print server. The APW asks … … 1990 1990 by executing the <code class="literal">lpadmin</code> command on more modern systems) and create the associated share, 1991 1991 then the APW will in effect really create a new printer on Samba and the UNIX print subsystem! 1992 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26255 78"></a>Migration of Classical Printing to Samba</h2></div></div></div><p>1992 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2625591"></a>Migration of Classical Printing to Samba</h2></div></div></div><p> 1993 1993 The basic NT-style printer driver management has not changed considerably in 3.0 over the 2.2.x releases 1994 1994 (apart from many small improvements). Here migration should be quite easy, especially if you followed … … 2020 2020 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 2021 2021 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" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26257 27"></a>Publishing Printer Information in Active Directory or LDAP</h2></div></div></div><p>2022 </p></li></ul></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2625740"></a>Publishing Printer Information in Active Directory or LDAP</h2></div></div></div><p> 2023 2023 This 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 2024 2024 Net Command</a>. If you wish to volunteer your services to help document this further, please contact 2025 2025 <a class="ulink" href="mail://jht@samba.org" target="_top">John H. Terpstra</a>. 2026 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id26257 56"></a>Common Errors</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2625762"></a>I Give My Root Password but I Do Not Get Access</h3></div></div></div><p>2026 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2625769"></a>Common Errors</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2625775"></a>I Give My Root Password but I Do Not Get Access</h3></div></div></div><p> 2027 2027 Do not confuse the root password, which is valid for the UNIX system (and in most cases stored in the 2028 2028 form of a one-way hash in a file named <code class="filename">/etc/shadow</code>), with the password used to … … 2035 2035 Retype new SMB password: secret 2036 2036 </pre><p> 2037 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id26258 03"></a>My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost</h3></div></div></div><p>2037 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2625816"></a>My Print Jobs Get Spooled into the Spooling Directory, but Then Get Lost</h3></div></div></div><p> 2038 2038 Do not use the existing UNIX print system spool directory for the Samba spool directory. It may seem 2039 2039 convenient 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.
