From e2219850d604470e484e9f8eb6e573c97d474298 Mon Sep 17 00:00:00 2001 From: Andrew Bartlett Date: Mon, 17 Sep 2012 11:54:25 -0700 Subject: docs: Remove references to sysv-style CUPS from TOSHARG-CUPS-printing This also simplifies the cups config by not duplicating the printcap name parameter that is already set by default when printing=cups is set. Andrew Bartlett --- docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml | 75 +++---------------------- 1 file changed, 8 insertions(+), 67 deletions(-) (limited to 'docs-xml/Samba3-HOWTO') diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml b/docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml index d0258fb492..807334eb32 100644 --- a/docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml +++ b/docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml @@ -98,9 +98,7 @@ /etc/printcap Printcap PrintcapFormat -Printing with CUPS in the most basic &smb.conf; setup in Samba-3.0 (as was true for 2.2.x) requires just two -parameters: cups and cups. CUPS does not need a printcap file. However, the +Printing with CUPS in the most basic &smb.conf; setup in Samba requires just this parameter: cups. CUPS does not need a printcap file. However, the cupsd.conf configuration file knows of two related directives that control how such a file will be automatically created and maintained by CUPS for the convenience of third-party applications (example: Printcap /etc/printcap and PrintcapFormat BSD). @@ -116,52 +114,13 @@ url="http://localhost:631/documentation.html">CUPS web site. libcups.so - Samba has a special relationship to CUPS. Samba can be compiled with CUPS library support. + Samba has a special relationship to CUPS, and to use CUPS Samba must be compiled with CUPS library support. Most recent installations have this support enabled. By default, CUPS linking is compiled - into smbd and other Samba binaries. Of course, you can use CUPS even - if Samba is not linked against libcups.so &smbmdash; but - there are some differences in required or supported configuration. + into smbd and other Samba binaries. The parameter + cups will only + be accepted if this is the case. - -libcups -ldd - When Samba is compiled and linked with libcups, cups - uses the CUPS API to list printers, submit jobs, query queues, and so on. Otherwise it maps to the System V - commands with an additional -oraw option for printing. On a Linux - system, you can use the ldd utility to find out if smbd has been linked with the - libcups library (ldd may not be present on other OS platforms, or its function may be embodied - by a different command): - -&rootprompt;ldd `which smbd` -libssl.so.0.9.6 => /usr/lib/libssl.so.0.9.6 (0x4002d000) -libcrypto.so.0.9.6 => /usr/lib/libcrypto.so.0.9.6 (0x4005a000) -libcups.so.2 => /usr/lib/libcups.so.2 (0x40123000) -[....] - - - - -libcups.so.2 - The line libcups.so.2 => /usr/lib/libcups.so.2 (0x40123000) shows - there is CUPS support compiled into this version of Samba. If this is the case, and printing = cups - is set, then any otherwise manually set print command in &smb.conf; is ignored. - This is an important point to remember! - - - Should it be necessary, for any reason, to set your own print commands, you can do this by setting - sysv. However, you will lose all the benefits - of tight CUPS-Samba integration. When you do this, you must manually configure the printing system commands - (most important: - ; other commands are - , - , - , - , - and - ). - - @@ -179,7 +138,6 @@ libcups.so.2 => /usr/lib/libcups.so.2 (0x40123000) yes cups - cups All Printers @@ -222,7 +180,6 @@ libcups.so.2 => /usr/lib/libcups.so.2 (0x40123000) cups - cups yes @@ -2198,18 +2155,14 @@ file [global] section: cups -cups When these parameters are specified, all manually set print directives (like or ) in &smb.conf; (as well as in Samba itself) will be -ignored. Instead, Samba will directly interface with CUPS through its application program interface (API), as -long as Samba has been compiled with CUPS library (libcups) support. If Samba has not been compiled with CUPS -support, and if no other print commands are set up, then printing will use the System V -AT&T command set, with the -oraw option automatically passing through (if you want your own defined print -commands to work with a Samba server that has CUPS support compiled in, simply use sysv). This is illustrated in the Printing via +ignored. Instead, Samba will directly interface with CUPS through its +application program interface (API). +This is illustrated in the Printing via CUPS/Samba Server diagram. @@ -4732,8 +4685,6 @@ For everything to work as it should, you need to have three things: A Samba-&smb.conf; setting of cups. - Another Samba &smb.conf; setting of - cups. @@ -4747,16 +4698,6 @@ influence whatsoever on your printing. - -Manual Configuration - - -If you want to do things manually, replace the cups -by bsd. Then your manually set commands may work -(I haven't tested this), and a lp -d %P %s; rm %s -may do what you need. - - -- cgit