docs:smbdotconf: make formatting of headers uniform.
[Samba.git] / docs-xml / smbdotconf / printing / useclientdriver.xml
blob4d07604cf0dc1c539225a3bba1fe35c99eb9f5d6
1 <samba:parameter name="use client driver"
2                  context="S"
3                  type="boolean"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6     <para>This parameter applies only to Windows NT/2000
7     clients.  It has no effect on Windows 95/98/ME clients.  When 
8     serving a printer to Windows NT/2000 clients without first installing
9     a valid printer driver on the Samba host, the client will be required
10     to install a local printer driver.  From this point on, the client
11     will treat the print as a local printer and not a network printer 
12     connection.  This is much the same behavior that will occur
13     when <command moreinfo="none">disable spoolss = yes</command>.
14     </para>
16     <para>The differentiating  factor is that under normal
17     circumstances, the NT/2000 client will  attempt to open the network
18     printer using MS-RPC.  The problem is that because the client
19     considers the printer to be local, it will attempt to issue the
20     OpenPrinterEx() call requesting access rights associated  with the
21     logged on user. If the user possesses local administrator rights but
22     not root privilege on the Samba host (often the case), the
23     OpenPrinterEx() call will fail.  The result is that the client will
24     now display an &quot;Access Denied; Unable to connect&quot; message
25     in the printer queue window (even though jobs may successfully be
26     printed).  </para>
28     <para>If this parameter is enabled for a printer, then any attempt
29     to open the printer with the PRINTER_ACCESS_ADMINISTER right is mapped
30     to PRINTER_ACCESS_USE instead.  Thus allowing the OpenPrinterEx()
31     call to succeed.  <emphasis>This parameter MUST not be enabled
32     on a print share which has valid print driver installed on the Samba 
33         server.</emphasis></para>
34 </description>
36 <related>disable spoolss</related>
38 <value type="default">no</value>
39 </samba:parameter>