Add new framework for smb.conf(5). Please read README before trying to compile.
[Samba/gebeck_regimport.git] / docs / docbook / smbdotconf / printing / useclientdriver.xml
blob8327d0aaa4459c63612dd843105e992bbf0cfff3
1 <samba:parameter xmlns:samba="http://samba.org/common">
2                 <term><anchor id="USECLIENTDRIVER"/>use client driver (S)</term>
3                 <listitem><para>This parameter applies only to Windows NT/2000
4                 clients.  It has no affect on Windows 95/98/ME clients.  When 
5                 serving a printer to Windows NT/2000 clients without first installing
6                 a valid printer driver on the Samba host, the client will be required
7                 to install a local printer driver.  From this point on, the client
8                 will treat the print as a local printer and not a network printer 
9                 connection.  This is much the same behavior that will occur
10                 when <command moreinfo="none">disable spoolss = yes</command>.  </para>
12                 <para>The differentiating 
13                 factor is that under normal circumstances, the NT/2000 client will 
14                 attempt to open the network printer using MS-RPC.  The problem is that
15                 because the client considers the printer to be local, it will attempt
16                 to issue the OpenPrinterEx() call requesting access rights associated 
17                 with the logged on user. If the user possesses local administator rights
18                 but not root privilegde on the Samba host (often the case), the OpenPrinterEx()
19                 call will fail.  The result is that the client will now display an &quot;Access
20                 Denied; Unable to connect&quot; message in the printer queue window (even though
21                 jobs may successfully be printed).  </para>
23                 <para>If this parameter is enabled for a printer, then any attempt
24                 to open the printer with the PRINTER_ACCESS_ADMINISTER right is mapped
25                 to PRINTER_ACCESS_USE instead.  Thus allowing the OpenPrinterEx()
26                 call to succeed.  <emphasis>This parameter MUST not be able enabled
27                 on a print share which has valid print driver installed on the Samba 
28                 server.</emphasis></para>
30                 <para>See also <link linkend="DISABLESPOOLSS">disable spoolss</link>
31                 </para>
33                 <para>Default: <command moreinfo="none">use client driver = no</command></para>
34                 </listitem>
35                 </samba:parameter>