diff options
Diffstat (limited to 'docs/htmldocs/printing.html')
| -rw-r--r-- | docs/htmldocs/printing.html | 390 |
1 files changed, 115 insertions, 275 deletions
diff --git a/docs/htmldocs/printing.html b/docs/htmldocs/printing.html index 76d703514d..46ebbcdf84 100644 --- a/docs/htmldocs/printing.html +++ b/docs/htmldocs/printing.html @@ -5,19 +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 Group Mapping" -HREF="groupmapping.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" @@ -45,7 +46,7 @@ WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A -HREF="groupmapping.html" +HREF="msdfs.html" ACCESSKEY="P" >Prev</A ></TD @@ -59,7 +60,7 @@ WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A -HREF="cups-printing.html" +HREF="winbind.html" ACCESSKEY="N" >Next</A ></TD @@ -72,148 +73,13 @@ WIDTH="100%"></DIV CLASS="CHAPTER" ><H1 ><A -NAME="PRINTING" -></A ->Chapter 13. Printing Support</H1 -><DIV -CLASS="TOC" -><DL -><DT -><B ->Table of Contents</B -></DT -><DT ->13.1. <A -HREF="printing.html#AEN1744" ->Introduction</A -></DT -><DT ->13.2. <A -HREF="printing.html#AEN1766" ->Configuration</A -></DT -><DD -><DL -><DT ->13.2.1. <A -HREF="printing.html#AEN1774" ->Creating [print$]</A -></DT -><DT ->13.2.2. <A -HREF="printing.html#AEN1809" ->Setting Drivers for Existing Printers</A -></DT -><DT ->13.2.3. <A -HREF="printing.html#AEN1825" ->Support a large number of printers</A -></DT -><DT ->13.2.4. <A -HREF="printing.html#AEN1840" ->Adding New Printers via the Windows NT APW</A -></DT -><DT ->13.2.5. <A -HREF="printing.html#AEN1870" ->Samba and Printer Ports</A -></DT -></DL -></DD -><DT ->13.3. <A -HREF="printing.html#AEN1878" ->The Imprints Toolset</A -></DT -><DD -><DL -><DT ->13.3.1. <A -HREF="printing.html#AEN1882" ->What is Imprints?</A -></DT -><DT ->13.3.2. <A -HREF="printing.html#AEN1892" ->Creating Printer Driver Packages</A -></DT -><DT ->13.3.3. <A -HREF="printing.html#AEN1895" ->The Imprints server</A -></DT -><DT ->13.3.4. <A -HREF="printing.html#AEN1899" ->The Installation Client</A -></DT -></DL -></DD -><DT ->13.4. <A -HREF="printing.html#AEN1921" ->Diagnosis</A -></DT -><DD -><DL -><DT ->13.4.1. <A -HREF="printing.html#AEN1923" ->Introduction</A -></DT -><DT ->13.4.2. <A -HREF="printing.html#AEN1939" ->Debugging printer problems</A -></DT -><DT ->13.4.3. <A -HREF="printing.html#AEN1948" ->What printers do I have?</A -></DT -><DT ->13.4.4. <A -HREF="printing.html#AEN1956" ->Setting up printcap and print servers</A -></DT -><DT ->13.4.5. <A -HREF="printing.html#AEN1984" ->Job sent, no output</A -></DT -><DT ->13.4.6. <A -HREF="printing.html#AEN1995" ->Job sent, strange output</A -></DT -><DT ->13.4.7. <A -HREF="printing.html#AEN2007" ->Raw PostScript printed</A -></DT -><DT ->13.4.8. <A -HREF="printing.html#AEN2010" ->Advanced Printing</A -></DT -><DT ->13.4.9. <A -HREF="printing.html#AEN2013" ->Real debugging</A -></DT -></DL -></DD -></DL -></DIV +NAME="PRINTING">Chapter 14. Printing Support</H1 ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN1744" ->13.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 @@ -294,9 +160,7 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN1766" ->13.2. Configuration</A -></H1 +NAME="AEN1942">14.2. Configuration</H1 ><DIV CLASS="WARNING" ><P @@ -311,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 @@ -335,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 @@ -356,9 +224,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1774" ->13.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$]. @@ -397,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 @@ -435,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 @@ -483,14 +351,14 @@ Samba follows this model as well.</P >Next create the directory tree below the [print$] share for each architecture you wish to support.</P ><P -><SAMP -CLASS="COMPUTEROUTPUT" +><PRE +CLASS="PROGRAMLISTING" >[print$]----- |-W32X86 ; "Windows NT x86" |-WIN40 ; "Windows 95/98" |-W32ALPHA ; "Windows NT Alpha_AXP" |-W32MIPS ; "Windows NT R4000" - |-W32PPC ; "Windows NT PowerPC"</SAMP + |-W32PPC ; "Windows NT PowerPC"</PRE ></P ><DIV CLASS="WARNING" @@ -506,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 @@ -539,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 @@ -558,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 @@ -573,9 +445,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1809" ->13.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 @@ -645,9 +515,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1825" ->13.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 @@ -665,16 +533,13 @@ setdriver command</B associated with an installed driver. The following is example of how this could be accomplished:</P ><P -><SAMP -CLASS="PROMPT" ->$ </SAMP -><KBD -CLASS="USERINPUT" ->rpcclient pogo -U root%secret -c "enumdrivers"</KBD -> -<PRE +><PRE CLASS="PROGRAMLISTING" > +<TT +CLASS="PROMPT" +>$ </TT +>rpcclient pogo -U root%secret -c "enumdrivers" Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3] [Windows NT x86] @@ -685,34 +550,27 @@ Printer Driver Info 1: Driver Name: [HP LaserJet 2100 Series PS] Printer Driver Info 1: - Driver Name: [HP LaserJet 4Si/4SiMX PS]</PRE -> -<SAMP + Driver Name: [HP LaserJet 4Si/4SiMX PS] + +<TT CLASS="PROMPT" ->$ </SAMP -><KBD -CLASS="USERINPUT" ->rpcclient pogo -U root%secret -c "enumprinters"</KBD -> -<PRE -CLASS="PROGRAMLISTING" ->Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3] +>$ </TT +>rpcclient pogo -U root%secret -c "enumprinters" +Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3] flags:[0x800000] name:[\\POGO\hp-print] description:[POGO\\POGO\hp-print,NO DRIVER AVAILABLE FOR THIS PRINTER,] comment:[] - </PRE -> -<SAMP + +<TT CLASS="PROMPT" ->$ </SAMP -><KBD -CLASS="USERINPUT" ->rpcclient pogo -U root%secret -c "setdriver hp-print \"HP LaserJet 4000 Series PS\""</KBD -> -<PRE -CLASS="PROGRAMLISTING" ->Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3] +>$ </TT +>rpcclient pogo -U root%secret \ +<TT +CLASS="PROMPT" +>> </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 ></P ></DIV @@ -721,9 +579,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1840" ->13.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" @@ -738,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 @@ -749,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 @@ -763,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. @@ -783,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 @@ -813,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" @@ -876,9 +746,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1870" ->13.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 @@ -897,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 @@ -911,9 +781,7 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN1878" ->13.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 @@ -929,9 +797,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1882" ->13.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 @@ -961,9 +827,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1892" ->13.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 @@ -977,9 +841,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1895" ->13.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 @@ -1001,9 +863,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1899" ->13.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 @@ -1095,17 +955,13 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN1921" ->13.4. Diagnosis</A -></H1 +NAME="AEN2093">14.4. Diagnosis</H1 ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1923" ->13.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 @@ -1167,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 @@ -1178,9 +1034,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1939" ->13.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 @@ -1235,9 +1089,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1948" ->13.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 @@ -1264,9 +1116,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1956" ->13.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 @@ -1348,9 +1198,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1984" ->13.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 @@ -1393,9 +1241,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1995" ->13.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 @@ -1439,9 +1285,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2007" ->13.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 @@ -1454,9 +1298,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2010" ->13.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. @@ -1470,9 +1312,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2013" ->13.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 @@ -1495,7 +1335,7 @@ WIDTH="33%" ALIGN="left" VALIGN="top" ><A -HREF="groupmapping.html" +HREF="msdfs.html" ACCESSKEY="P" >Prev</A ></TD @@ -1513,7 +1353,7 @@ WIDTH="33%" ALIGN="right" VALIGN="top" ><A -HREF="cups-printing.html" +HREF="winbind.html" ACCESSKEY="N" >Next</A ></TD @@ -1523,7 +1363,7 @@ ACCESSKEY="N" WIDTH="33%" ALIGN="left" VALIGN="top" ->Configuring Group Mapping</TD +>Hosting a Microsoft Distributed File System tree on Samba</TD ><TD WIDTH="34%" ALIGN="center" @@ -1537,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 |