Add Ronan Waide's info about the setdriver call.

(This used to be commit ef6cb3ec1aa943d4e52ea08e7b43a47d781d3273)

1 files changed, 24 insertions, 4 deletions

diff --git a/docs/docbook/faq/printing.sgml b/docs/docbook/faq/printing.sgml
index cc8d210cf9..cc01a5d3b0 100644
--- a/docs/docbook/faq/printing.sgml
+++ b/docs/docbook/faq/printing.sgml
@@ -1,16 +1,36 @@
 <chapter id="FAQ-Printing">
+<chapterinfo>
+<author>
+	<firstname>Ronan</firstname><surname>Waide</surname>
+</author>
+</chapterinfo>
+
 <title>Printing problems</title>
 
 <sect1>
-<title>cupsaddsmb fails!</title>
+<title>setdriver or cupsaddsmb failes</title>
 <para>
-This can have a few causes:
+setdriver expects the following setup:
 
 <simplelist>
-<member>Does the user you are trying to add the printer with have the correct rights? Make sure
-this user is listed in 'printer admin = ' in the section [global]</member>
+<member>you are a printer admin, or root. this is the smb.conf printer admin group, not the Printer Operators group in NT. I've not tried the latter, but I don't believe it will work based on the current code.</member>
+<member>printer admins has to be defined in [global]</member>
+<member>upload the driver files to \\server\print$\w32x86 and win40 as appropriate. DON'T put them in the 0 or 2 subdirectories.</member>
+<member>Make sure that the user you're connecting as is able to write to the print$ directories</member>
+<member>Use adddriver (with appropriate parameters) to create the driver. note, this will not just update samba's notion of drivers, it will also move the files from the w32x86 and win40 directories to an appropriate subdirectory (based on driver version, I think, but not important enough for me to find out)</member>
+<member>Use setdriver to associate the driver with a printer</member>
 </simplelist>
 
+<para>
+The setdriver call will fail if the printer doesn't already exist in
+samba's view of the world. Either create the printer in cups and
+restart samba, or create an add printer command (see smb.conf doco)
+and use RPC calls to create a printer. NB the add printer command MUST
+return a single line of text indicating which port the printer was
+added on. If it doesn't, Samba won't reload the printer
+definitions. Although samba doesn't really support the notion of
+ports, suitable add printer command and enumport command settings can
+allow you pretty good remote control of the samba printer setup.
 </para>
 </sect1>
 </chapter>