Add some more common errors
[sfrench/samba-autobuild/.git] / docs / docbook / faq / printing.xml
1 <chapter id="FAQ-Printing">
2 <!-- Kurt Pfeifle's HOWTO chapter on printing should make this obsolete -->
3 <chapterinfo>
4 <author>
5         <firstname>Ronan</firstname><surname>Waide</surname>
6 </author>
7 </chapterinfo>
8
9 <title>Printing problems</title>
10
11 <sect1>
12 <title>setdriver or cupsaddsmb failes</title>
13 <para>
14 setdriver expects the following setup:
15
16 <simplelist>
17 <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>
18 <member>printer admins has to be defined in [global]</member>
19 <member>upload the driver files to \\server\print$\w32x86 and win40 as appropriate. DON'T put them in the 0 or 2 subdirectories.</member>
20 <member>Make sure that the user you're connecting as is able to write to the print$ directories</member>
21 <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>
22 <member>Use setdriver to associate the driver with a printer</member>
23 </simplelist>
24 </para>
25
26 <para>
27 The setdriver call will fail if the printer doesn't already exist in
28 samba's view of the world. Either create the printer in cups and
29 restart samba, or create an add printer command (see smb.conf doco)
30 and use RPC calls to create a printer. NB the add printer command MUST
31 return a single line of text indicating which port the printer was
32 added on. If it doesn't, Samba won't reload the printer
33 definitions. Although samba doesn't really support the notion of
34 ports, suitable add printer command and enumport command settings can
35 allow you pretty good remote control of the samba printer setup.
36 </para>
37 </sect1>
38 </chapter>