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