This commit was manufactured by cvs2svn to create branch 'SAMBA_3_0'.(This used to be commit 35510176fd4feab6c1e3da2ee0ae791f9a064a2e)

3 files changed, 121 insertions, 0 deletions

diff --git a/docs/docbook/smbdotconf/printing/lpqcachetime.xml b/docs/docbook/smbdotconf/printing/lpqcachetime.xml
new file mode 100644
index 0000000000..df48a5fd01
--- /dev/null
+++ b/docs/docbook/smbdotconf/printing/lpqcachetime.xml
@@ -0,0 +1,29 @@
+<samba:parameter name="lpq cache time"
+		 context="G"
+		 developer="1"
+		 xmlns:samba="http://samba.org/common">
+<listitem>
+	<para>This controls how long lpq info will be cached 
+	for to prevent the <command moreinfo="none">lpq</command> command being called too 
+	often. A separate cache is kept for each variation of the <command moreinfo="none">
+	lpq</command> command used by the system, so if you use different 
+	<command moreinfo="none">lpq</command> commands for different users then they won't
+	share cache information.</para>
+
+	<para>The cache files are stored in <filename moreinfo="none">/tmp/lpq.xxxx</filename> 
+	where xxxx is a hash of the <command moreinfo="none">lpq</command> command in use.</para>
+
+	<para>The default is 10 seconds, meaning that the cached results 
+	of a previous identical <command moreinfo="none">lpq</command> command will be used 
+	if the cached data is less than 10 seconds old. A large value may 
+	be advisable if your <command moreinfo="none">lpq</command> command is very slow.</para>
+
+	<para>A value of 0 will disable caching completely.</para>
+
+	<para>See also the <link linkend="PRINTING"><parameter moreinfo="none">printing</parameter></link> parameter.</para>
+
+	<para>Default: <command moreinfo="none">lpq cache time = 10</command></para>
+
+	<para>Example: <command moreinfo="none">lpq cache time = 30</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/printing/printcapname.xml b/docs/docbook/smbdotconf/printing/printcapname.xml
new file mode 100644
index 0000000000..e7aa9e938d
--- /dev/null
+++ b/docs/docbook/smbdotconf/printing/printcapname.xml
@@ -0,0 +1,52 @@
+<samba:parameter name="printcap name"
+                 context="S"
+		 print="1" developer="1"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+    <para>This parameter may be used to override the 
+    compiled-in default printcap name used by the server (usually <filename moreinfo="none">
+    /etc/printcap</filename>). See the discussion of the <link 
+    linkend="PRINTERSSECT">[printers]</link> section above for reasons 
+    why you might want to do this.</para>
+
+    <para>To use the CUPS printing interface set <command moreinfo="none">printcap name = cups
+    </command>. This should be supplemented by an addtional setting 
+    <link linkend="PRINTING">printing = cups</link> in the [global] 
+    section.  <command moreinfo="none">printcap name = cups</command> will use the  
+    &quot;dummy&quot; printcap created by CUPS, as specified in your CUPS
+    configuration file.
+    </para>
+
+    <para>On System V systems that use <command moreinfo="none">lpstat</command> to 
+    list available printers you can use <command moreinfo="none">printcap name = lpstat
+    </command> to automatically obtain lists of available printers. This 
+    is the default for systems that define SYSV at configure time in 
+    Samba (this includes most System V based systems). If <parameter moreinfo="none">
+    printcap name</parameter> is set to <command moreinfo="none">lpstat</command> on 
+    these systems then Samba will launch <command moreinfo="none">lpstat -v</command> and 
+    attempt to parse the output to obtain a printer list.</para>
+
+    <para>A minimal printcap file would look something like this:</para>
+
+<para><programlisting format="linespecific">
+print1|My Printer 1
+print2|My Printer 2
+print3|My Printer 3
+print4|My Printer 4
+print5|My Printer 5
+</programlisting></para>
+	
+    <para>where the '|' separates aliases of a printer. The fact 
+    that the second alias has a space in it gives a hint to Samba 
+    that it's a comment.</para>
+
+    <note><para>Under AIX the default printcap 
+    name is <filename moreinfo="none">/etc/qconfig</filename>. Samba will assume the 
+    file is in AIX <filename moreinfo="none">qconfig</filename> format if the string
+    <filename moreinfo="none">qconfig</filename> appears in the printcap filename.</para></note>
+
+    <para>Default: <command moreinfo="none">printcap name = /etc/printcap</command></para>
+
+    <para>Example: <command moreinfo="none">printcap name = /etc/myprintcap</command></para>
+</listitem>
+</samba:parameter>
diff --git a/docs/docbook/smbdotconf/printing/useclientdriver.xml b/docs/docbook/smbdotconf/printing/useclientdriver.xml
new file mode 100644
index 0000000000..67c8cbf8d0
--- /dev/null
+++ b/docs/docbook/smbdotconf/printing/useclientdriver.xml
@@ -0,0 +1,40 @@
+<samba:parameter name="use client driver"
+                 context="S"
+		 print="1"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+    <para>This parameter applies only to Windows NT/2000
+    clients.  It has no affect on Windows 95/98/ME clients.  When 
+    serving a printer to Windows NT/2000 clients without first installing
+    a valid printer driver on the Samba host, the client will be required
+    to install a local printer driver.  From this point on, the client
+    will treat the print as a local printer and not a network printer 
+    connection.  This is much the same behavior that will occur
+    when <command moreinfo="none">disable spoolss = yes</command>.
+    </para>
+
+    <para>The differentiating  factor is that under normal
+    circumstances, the NT/2000 client will  attempt to open the network
+    printer using MS-RPC.  The problem is that because the client
+    considers the printer to be local, it will attempt to issue the
+    OpenPrinterEx() call requesting access rights associated  with the
+    logged on user. If the user possesses local administator rights but
+    not root privilegde on the Samba host (often the case), the
+    OpenPrinterEx() call will fail.  The result is that the client will
+    now display an &quot;Access Denied; Unable to connect&quot; message
+    in the printer queue window (even though jobs may successfully be
+    printed).  </para>
+
+    <para>If this parameter is enabled for a printer, then any attempt
+    to open the printer with the PRINTER_ACCESS_ADMINISTER right is mapped
+    to PRINTER_ACCESS_USE instead.  Thus allowing the OpenPrinterEx()
+    call to succeed.  <emphasis>This parameter MUST not be able enabled
+    on a print share which has valid print driver installed on the Samba 
+    server.</emphasis></para>
+
+    <para>See also <link linkend="DISABLESPOOLSS"><parameter 
+    moreinfo="none">disable spoolss</parameter></link></para>
+
+    <para>Default: <command moreinfo="none">use client driver = no</command></para>
+</listitem>
+</samba:parameter>