diff options
Diffstat (limited to 'docs/htmldocs/printing.html')
| -rw-r--r-- | docs/htmldocs/printing.html | 197 |
1 files changed, 89 insertions, 108 deletions
diff --git a/docs/htmldocs/printing.html b/docs/htmldocs/printing.html index 91a1ad72b0..46ebbcdf84 100644 --- a/docs/htmldocs/printing.html +++ b/docs/htmldocs/printing.html @@ -5,7 +5,8 @@ >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 @@ -72,17 +73,13 @@ WIDTH="100%"></DIV CLASS="CHAPTER" ><H1 ><A -NAME="PRINTING" -></A ->Chapter 13. Printing Support</H1 +NAME="PRINTING">Chapter 14. Printing Support</H1 ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN1957" ->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 @@ -163,9 +160,7 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN1979" ->13.2. Configuration</A -></H1 +NAME="AEN1942">14.2. Configuration</H1 ><DIV CLASS="WARNING" ><P @@ -180,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 @@ -204,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 @@ -225,9 +224,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN1987" ->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$]. @@ -266,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 @@ -304,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 @@ -375,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 @@ -408,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 @@ -427,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 @@ -442,9 +445,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2022" ->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 @@ -514,9 +515,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2038" ->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 @@ -537,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] @@ -553,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] @@ -563,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 @@ -580,9 +579,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2049" ->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" @@ -597,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 @@ -608,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 @@ -622,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. @@ -642,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 @@ -672,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" @@ -735,9 +746,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2079" ->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 @@ -756,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 @@ -770,9 +781,7 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2087" ->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 @@ -788,9 +797,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2091" ->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 @@ -820,9 +827,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2101" ->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 @@ -836,9 +841,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2104" ->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 @@ -860,9 +863,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2108" ->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 @@ -954,17 +955,13 @@ CLASS="SECT1" ><H1 CLASS="SECT1" ><A -NAME="AEN2130" ->13.4. Diagnosis</A -></H1 +NAME="AEN2093">14.4. Diagnosis</H1 ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2132" ->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 @@ -1026,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 @@ -1037,9 +1034,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2148" ->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 @@ -1094,9 +1089,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2157" ->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 @@ -1123,9 +1116,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2165" ->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 @@ -1207,9 +1198,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2193" ->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 @@ -1252,9 +1241,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2204" ->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 @@ -1298,9 +1285,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2216" ->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 @@ -1313,9 +1298,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2219" ->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. @@ -1329,9 +1312,7 @@ CLASS="SECT2" ><H2 CLASS="SECT2" ><A -NAME="AEN2222" ->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 |