diff options
Diffstat (limited to 'docs/htmldocs/printing.html')
| -rw-r--r-- | docs/htmldocs/printing.html | 221 |
1 files changed, 100 insertions, 121 deletions
diff --git a/docs/htmldocs/printing.html b/docs/htmldocs/printing.html index 7834e0d884..46ebbcdf84 100644 --- a/docs/htmldocs/printing.html +++ b/docs/htmldocs/printing.html @@ -5,20 +5,20 @@ >Printing Support</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ +"><LINK REL="HOME" TITLE="SAMBA Project Documentation" HREF="samba-howto-collection.html"><LINK REL="UP" -TITLE="Advanced Configuration" +TITLE="Optional configuration" HREF="optional.html"><LINK REL="PREVIOUS" -TITLE="Configuring PAM for distributed but centrally -managed authentication" -HREF="pam.html"><LINK +TITLE="Hosting a Microsoft Distributed File System tree on Samba" +HREF="msdfs.html"><LINK REL="NEXT" -TITLE="CUPS Printing Support" -HREF="cups-printing.html"></HEAD +TITLE="Unified Logons between Windows NT and UNIX using Winbind" +HREF="winbind.html"></HEAD ><BODY CLASS="CHAPTER" BGCOLOR="#FFFFFF" @@ -46,7 +46,7 @@ WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A -HREF="pam.html" +HREF="msdfs.html" ACCESSKEY="P" >Prev</A ></TD @@ -60,7 +60,7 @@ WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A -HREF="cups-printing.html" +HREF="winbind.html" ACCESSKEY="N" >Next</A ></TD @@ -73,17 +73,13 @@ WIDTH="100%"></DIV CLASS="CHAPTER" ><H1 ><A -NAME="PRINTING" -></A ->Chapter 14. Printing Support</H1 +NAME="PRINTING">Chapter 14. Printing Support</H1 ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN1946" ->14.1. Introduction</A -></H1 +NAME="AEN1920">14.1. Introduction</H1 ><P >Beginning with the 2.2.0 release, Samba supports the native Windows NT printing mechanisms implemented via @@ -164,9 +160,7 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN1968" ->14.2. Configuration</A -></H1 +NAME="AEN1942">14.2. Configuration</H1 ><DIV CLASS="WARNING" ><P @@ -181,7 +175,7 @@ WIDTH="25" ALIGN="CENTER" VALIGN="TOP" ><IMG -SRC="/usr/share/sgml/docbook/stylesheet/dsssl/modular/images/warning.gif" +SRC="../images/warning.gif" HSPACE="5" ALT="Warning"></TD ><TH @@ -205,15 +199,19 @@ a printer$ service which provides read-only access via no password in order to support printer driver downloads.</P ><P >However, the initial implementation allowed for a -parameter named <VAR +parameter named <TT CLASS="PARAMETER" ->printer driver location</VAR +><I +>printer driver location</I +></TT > to be used on a per share basis to specify the location of the driver files associated with that printer. Another -parameter named <VAR +parameter named <TT CLASS="PARAMETER" ->printer driver</VAR +><I +>printer driver</I +></TT > provided a means of defining the printer driver name to be sent to the client.</P @@ -226,9 +224,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1976" ->14.2.1. Creating [print$]</A -></H2 +NAME="AEN1950">14.2.1. Creating [print$]</H2 ><P >In order to support the uploading of printer driver files, you must first configure a file share named [print$]. @@ -267,9 +263,11 @@ CLASS="PROGRAMLISTING" >The <A HREF="smb.conf.5.html#WRITELIST" TARGET="_top" -><VAR +><TT CLASS="PARAMETER" ->write list</VAR +><I +>write list</I +></TT ></A > is used to allow administrative level user accounts to have write access in order to update files @@ -305,7 +303,7 @@ WIDTH="25" ALIGN="CENTER" VALIGN="TOP" ><IMG -SRC="/usr/share/sgml/docbook/stylesheet/dsssl/modular/images/note.gif" +SRC="../images/note.gif" HSPACE="5" ALT="Note"></TD ><TH @@ -376,7 +374,7 @@ WIDTH="25" ALIGN="CENTER" VALIGN="TOP" ><IMG -SRC="/usr/share/sgml/docbook/stylesheet/dsssl/modular/images/warning.gif" +SRC="../images/warning.gif" HSPACE="5" ALT="Warning"></TD ><TH @@ -409,10 +407,12 @@ one of two conditions must hold true:</P must be a member of the <A HREF="smb.conf.5.html#PRINTERADMIN" TARGET="_top" -><VAR +><TT CLASS="PARAMETER" +><I >printer - admin</VAR + admin</I +></TT ></A > list.</P ></LI @@ -428,9 +428,11 @@ that all file shares are set to 'read only' by default.</P ><P >Once you have created the required [print$] service and associated subdirectories, simply log onto the Samba server using -a root (or <VAR +a root (or <TT CLASS="PARAMETER" ->printer admin</VAR +><I +>printer admin</I +></TT >) account from a Windows NT 4.0/2k client. Open "Network Neighbourhood" or "My Network Places" and browse for the Samba host. Once you have located @@ -443,9 +445,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2011" ->14.2.2. Setting Drivers for Existing Printers</A -></H2 +NAME="AEN1985">14.2.2. Setting Drivers for Existing Printers</H2 ><P >The initial listing of printers in the Samba host's Printers folder will have no real printer driver assigned @@ -515,9 +515,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2027" ->14.2.3. Support a large number of printers</A -></H2 +NAME="AEN2001">14.2.3. Support a large number of printers</H2 ><P >One issue that has arisen during the development phase of Samba 2.2 is the need to support driver downloads for @@ -538,9 +536,9 @@ of how this could be accomplished:</P ><PRE CLASS="PROGRAMLISTING" > -<SAMP +<TT CLASS="PROMPT" ->$ </SAMP +>$ </TT >rpcclient pogo -U root%secret -c "enumdrivers" Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3] @@ -554,9 +552,9 @@ Printer Driver Info 1: Printer Driver Info 1: Driver Name: [HP LaserJet 4Si/4SiMX PS] -<SAMP +<TT CLASS="PROMPT" ->$ </SAMP +>$ </TT >rpcclient pogo -U root%secret -c "enumprinters" Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3] flags:[0x800000] @@ -564,13 +562,13 @@ Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3] description:[POGO\\POGO\hp-print,NO DRIVER AVAILABLE FOR THIS PRINTER,] comment:[] -<SAMP +<TT CLASS="PROMPT" ->$ </SAMP +>$ </TT >rpcclient pogo -U root%secret \ -<SAMP +<TT CLASS="PROMPT" ->> </SAMP +>> </TT > -c "setdriver hp-print \"HP LaserJet 4000 Series PS\"" Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3] Successfully set hp-print to driver HP LaserJet 4000 Series PS.</PRE @@ -581,9 +579,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2038" ->14.2.4. Adding New Printers via the Windows NT APW</A -></H2 +NAME="AEN2012">14.2.4. Adding New Printers via the Windows NT APW</H2 ><P >By default, Samba offers all printer shares defined in <TT CLASS="FILENAME" @@ -598,9 +594,11 @@ Add Printer Wizard icon. The APW will be show only if</P ><P >The connected user is able to successfully execute an OpenPrinterEx(\\server) with administrative - privileges (i.e. root or <VAR + privileges (i.e. root or <TT CLASS="PARAMETER" ->printer admin</VAR +><I +>printer admin</I +></TT >). </P ></LI @@ -609,10 +607,12 @@ CLASS="PARAMETER" ><A HREF="smb.conf.5.html#SHOWADDPRINTERWIZARD" TARGET="_top" -><VAR +><TT CLASS="PARAMETER" +><I >show - add printer wizard = yes</VAR + add printer wizard = yes</I +></TT ></A > (the default). </P @@ -623,10 +623,12 @@ CLASS="PARAMETER" server, the <A HREF="smb.conf.5.html#ADDPRINTERCOMMAND" TARGET="_top" -><VAR +><TT CLASS="PARAMETER" +><I >add -printer command</VAR +printer command</I +></TT ></A > must have a defined value. The program hook must successfully add the printer to the system (i.e. @@ -643,29 +645,35 @@ CLASS="FILENAME" not exist, <B CLASS="COMMAND" >smbd</B -> will execute the <VAR +> will execute the <TT CLASS="PARAMETER" +><I >add printer -command</VAR +command</I +></TT > and reparse to the <TT CLASS="FILENAME" >smb.conf</TT > to attempt to locate the new printer share. If the share is still not defined, an error of "Access Denied" is returned to the client. Note that the -<VAR +<TT CLASS="PARAMETER" ->add printer program</VAR +><I +>add printer program</I +></TT > is executed under the context of the connected user, not necessarily a root account.</P ><P >There is a complementary <A HREF="smb.conf.5.html#DELETEPRINTERCOMMAND" TARGET="_top" -><VAR +><TT CLASS="PARAMETER" +><I >delete -printer command</VAR +printer command</I +></TT ></A > for removing entries from the "Printers..." folder.</P @@ -673,9 +681,11 @@ folder.</P >The following is an example <A HREF="smb.conf.5.html#ADDPRINTERCOMMAN" TARGET="_top" -><VAR +><TT CLASS="PARAMETER" ->add printer command</VAR +><I +>add printer command</I +></TT ></A > script. It adds the appropriate entries to <TT CLASS="FILENAME" @@ -736,9 +746,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2068" ->14.2.5. Samba and Printer Ports</A -></H2 +NAME="AEN2042">14.2.5. Samba and Printer Ports</H2 ><P >Windows NT/2000 print servers associate a port with each printer. These normally take the form of LPT1:, COM1:, FILE:, etc... Samba must also support the @@ -757,10 +765,12 @@ CLASS="FILENAME" > possesses a <A HREF="smb.conf.5.html#ENUMPORTSCOMMAND" TARGET="_top" -><VAR +><TT CLASS="PARAMETER" +><I >enumports -command</VAR +command</I +></TT ></A > which can be used to define an external program that generates a listing of ports on a system.</P @@ -771,9 +781,7 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2076" ->14.3. The Imprints Toolset</A -></H1 +NAME="AEN2050">14.3. The Imprints Toolset</H1 ><P >The Imprints tool set provides a UNIX equivalent of the Windows NT Add Printer Wizard. For complete information, please @@ -789,9 +797,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2080" ->14.3.1. What is Imprints?</A -></H2 +NAME="AEN2054">14.3.1. What is Imprints?</H2 ><P >Imprints is a collection of tools for supporting the goals of</P @@ -821,9 +827,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2090" ->14.3.2. Creating Printer Driver Packages</A -></H2 +NAME="AEN2064">14.3.2. Creating Printer Driver Packages</H2 ><P >The process of creating printer driver packages is beyond the scope of this document (refer to Imprints.txt also included @@ -837,9 +841,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2093" ->14.3.3. The Imprints server</A -></H2 +NAME="AEN2067">14.3.3. The Imprints server</H2 ><P >The Imprints server is really a database server that may be queried via standard HTTP mechanisms. Each printer @@ -861,9 +863,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2097" ->14.3.4. The Installation Client</A -></H2 +NAME="AEN2071">14.3.4. The Installation Client</H2 ><P >More information regarding the Imprints installation client is available in the <TT @@ -955,17 +955,13 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2119" ->14.4. Diagnosis</A -></H1 +NAME="AEN2093">14.4. Diagnosis</H1 ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2121" ->14.4.1. Introduction</A -></H2 +NAME="AEN2095">14.4.1. Introduction</H2 ><P >This is a short description of how to debug printing problems with Samba. This describes how to debug problems with printing from a SMB @@ -1027,7 +1023,7 @@ and it should be periodically cleaned out. Samba used the lpq command to determine the "job number" assigned to your print job by the spooler.</P ><P ->The %>letter< are "macros" that get dynamically replaced with appropriate +>The %>letter< are "macros" that get dynamically replaced with appropriate values when they are used. The %s gets replaced with the name of the spool file that Samba creates and the %p gets replaced with the name of the printer. The %j gets replaced with the "job number" which comes from @@ -1038,9 +1034,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2137" ->14.4.2. Debugging printer problems</A -></H2 +NAME="AEN2111">14.4.2. Debugging printer problems</H2 ><P >One way to debug printing problems is to start by replacing these command with shell scripts that record the arguments and the contents @@ -1095,9 +1089,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2146" ->14.4.3. What printers do I have?</A -></H2 +NAME="AEN2120">14.4.3. What printers do I have?</H2 ><P >You can use the 'testprns' program to check to see if the printer name you are using is recognized by Samba. For example, you can @@ -1124,9 +1116,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2154" ->14.4.4. Setting up printcap and print servers</A -></H2 +NAME="AEN2128">14.4.4. Setting up printcap and print servers</H2 ><P >You may need to set up some printcaps for your Samba system to use. It is strongly recommended that you use the facilities provided by @@ -1208,9 +1198,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2182" ->14.4.5. Job sent, no output</A -></H2 +NAME="AEN2156">14.4.5. Job sent, no output</H2 ><P >This is the most frustrating part of printing. You may have sent the job, verified that the job was forwarded, set up a wrapper around @@ -1253,9 +1241,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2193" ->14.4.6. Job sent, strange output</A -></H2 +NAME="AEN2167">14.4.6. Job sent, strange output</H2 ><P >Once you have the job printing, you can then start worrying about making it print nicely.</P @@ -1299,9 +1285,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2205" ->14.4.7. Raw PostScript printed</A -></H2 +NAME="AEN2179">14.4.7. Raw PostScript printed</H2 ><P >This is a problem that is usually caused by either the print spooling system putting information at the start of the print job that makes @@ -1314,9 +1298,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2208" ->14.4.8. Advanced Printing</A -></H2 +NAME="AEN2182">14.4.8. Advanced Printing</H2 ><P >Note that you can do some pretty magic things by using your imagination with the "print command" option and some shell scripts. @@ -1330,9 +1312,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2211" ->14.4.9. Real debugging</A -></H2 +NAME="AEN2185">14.4.9. Real debugging</H2 ><P >If the above debug tips don't help, then maybe you need to bring in the bug guns, system tracing. See Tracing.txt in this directory.</P @@ -1355,7 +1335,7 @@ WIDTH="33%" ALIGN="left" VALIGN="top" ><A -HREF="pam.html" +HREF="msdfs.html" ACCESSKEY="P" >Prev</A ></TD @@ -1373,7 +1353,7 @@ WIDTH="33%" ALIGN="right" VALIGN="top" ><A -HREF="cups-printing.html" +HREF="winbind.html" ACCESSKEY="N" >Next</A ></TD @@ -1383,8 +1363,7 @@ ACCESSKEY="N" WIDTH="33%" ALIGN="left" VALIGN="top" ->Configuring PAM for distributed but centrally -managed authentication</TD +>Hosting a Microsoft Distributed File System tree on Samba</TD ><TD WIDTH="34%" ALIGN="center" @@ -1398,7 +1377,7 @@ ACCESSKEY="U" WIDTH="33%" ALIGN="right" VALIGN="top" ->CUPS Printing Support</TD +>Unified Logons between Windows NT and UNIX using Winbind</TD ></TR ></TABLE ></DIV |