IFHP(8) System Manager's Manual IFHP(8)
NAME
ifhp - Almost Universal LPRng Print Filter
SYNOPSIS
ifhp
[-F format] [-s statusfile] [-?value (other LPRng filter options)]
[-Z[options[,options]*]*
[-T[options[,options]*]*
[accountingfile]
ifhp.conf(configuration file)
DESCRIPTION
The ifhp is a general purpose filter for allmost all PostScript, PJL, PCL, and text based line printers.
The ifhp filter resets and synchronizes the printer, gets accounting information, and then checks the file to determine its format. Based
on the format, it will do PCL, PostScript, or other initializations, and then transfer the file to the printer. Termination sequences are
sent, followed by getting accounting information.
OPTIONS AND CONFIGURATION
Options controlling ifhp operations are specified by -Toption or -Zoption values. These options have the form:
Form Same As
flag flag=1
flag@ flag=0
flag=str
flag#str
The complete set of options and their effect on operation are detailed in the IFHP-HOWTO document. The following is a brief list of the
more important ones that will have a dramatic effect on printer operation.
model =modelid
Specifies the printer modelid information. This is used to select an appropriate configuration from the ifhp configuration file.
status (status@)
The status option enables checking for status information from the printer. See STATUS, SYNC, WAITEND, AND PAGECOUNT for details.
sync (sync@, sync=ps, sync=pjl)
waitend (waitend@, waitend=ps, waitend=pjl)
If the status option is enabled, sync will check to see that the printer is online and ready and the waitent will check that the job
has finished. The sync@ and waitend@ will suppress these checks. See STATUS, SYNC, WAITEND, AND PAGECOUNT for details.
pagecount (pagecount@, pagecount=ps, pagecount=pjl)
If the status option is enabled, pagecount will try to get the value of the printer pagecounter. See STATUS, SYNC, WAITEND, AND
PAGECOUNT for details.
config=path,path,...
pathnames of configuration files to read to obtain printer configuration information.
debug=debuglevel
Set the debugging level. A larger number causes more verbose error messages. You have been warned.
trace
Sends out debugging and tracing information on STDERR as well as to the status log file.
stty=options
Sets serial line configuration when a dev entry specified.
STATUS, SYNC, WAITEND, AND PAGECOUNT
If the status option is true, then the ifhp filter will assume that the printer is attached by a bidirectional channel and will attempt to
read status information from the printer. This also enables the sync, sync and pagecount handshaking and getting pagecount information
from the printer.
The sync flag causes a special PJL job or PostScript job to be sent to the printer at the start of printing at periodic intervals. This
job has the property that it will attempt to put the printer into a sane state and cause it to return status information. By default, if
the printer supports PJL then the PJL job is used, otherwise if it supports PostScript, the PostScript job is used. You can force the sync
method using sync=pjl or sync=ps if necessary, and suppress it using sync@
The waitend flag causes a special PJL job or PostScript job to be sent to the printer at the end of the job at periodic intervals. This
job has the property that it will attempt to put the printer into a sane state and cause it to return status information. By default, if
the printer supports PJL then the PJL job is used, otherwise if it supports PostScript, the PostScript job is used. You can force the
waitend method using waitend=pjl or waitend=ps if necessary, and suppress it using waitend@
The pagecount flag causes a special PJL job or PostScript job to be sent to the printer at the start and end of the job. This job has the
property that it causes the printer to return the value of a hardware page counter. By taking the difference of the start and end values
of the pagecounter, an accurate measure of the number of pages (or impressions for some duplex printers) can be done. By default, if the
printer supports PJL then the PJL job is used, otherwise if it supports PostScript, the PostScript job is used. You can force the
pagecount method using pagecount=pjl or pagecount=ps if necessary, and suppress it using pagecount@
The IFHP filter will puts tracing and status information in the file specified by the -s command line flag. If the status file does not
exist, it will not be created. The diagnostic trace flag overrides this and directs the status to STDERR.
The pagecount information is put into the accounting file specified on the command line. If the accounting file does not exist, it will
not be created.
JOB PROCESSING (LPR -Z) OPTIONS
The lpr program passes the command line -Z options or the lp program -o options to the LPRng lpd server which then passes them to the ifhp
filter. The options are used to control various printing features. For example if duplex printing and landscape is wanted, then
lpr -P<printer> -Z'duplex,landscape' <file>
Since each printer has a different set of capabilities there are no standard set of -Z options. The following is a sample of the options
provided by ifhp. Check the ifhp.conf file for all of the options supported by the printer.
Input Tray Selection
inupper, inlower, intray1, intray2, intray3, manual, envelope
source=name
The input tray selection options should start with the in prefix and corresponds to the various trays. The manual and envelope
options are included to select manual feed or envelope feed. There is a possible source of conflict here as there may be an envelope
feeder as well as an envelope media. This is a printer specific dependency.
The source=name option allows users to use options such as -Zsource=inbin1, which may be useful for systems that have an unusual or
nonstandard input selection mechanism. se select media (paper) from the specified tray or feeder.
Output Bin Selection
outupper, outlower, outbin1
outbin=name
The output bin selection should start with the out prefix.
The outbin=name form allow users to use options such as -Zoutbin=stapler, which may be useful for systems that have an unusual or
nonstandard output selection mechanism.
Media Size Selection
a0 a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 b0 b1 b2 b3 b4 b5
archA archB archC archD archE flsa flse halfletter
note letter legal 11x17 ledger tabloid
paper=name
The paper size selection facilities usually are quite printer dependent, and the input tray selection and paper size selection
mechanisms may interact in strange and mysterious ways.
The paper=name form allow users to use options such as -Zpaper=b3, which may be useful for systems that have an unusual or
nonstandard input media selection mechanism.
Media Type Selection
plain, preprinted, letterhead, transparency, glossy, prepunched, labels
bond, recycled, color, heavy, cardstock
Media Type is not the same as paper size, and corresponds to the name assigned to a particular media. Of course, the issue is
complicated by the fact that some media have standard sizes as well. Again, the input tray selection, media size, and media type
selection will interact in confusing and mysterious ways, depending on the whim of the printer firmware iplementors.
You will notice that there is no generic mediatype=name facility. This is due to the radically different way that PostScript, PJL,
PCL, etc., each handle media name and selection. While it is possible to determine the various strings, numbers, escape codes,
etc., that need to be sent for each mediatype, a general mechanism is too fragile and fraught with peril for the unwary
administrator to provide. You have been warned. Been there and have the scars to prove it.
These are commonly used media type names gleaned from various PostScript Printer Description Files, Microsoft printer drivers, and
arcane lore of the Printer Working Group. Note that these are not accepted terms in the paper industry for any of these type of
media. You are warned.
Duplex/Simplex
duplex (lduplex) duplexshort (sduplex)
simplex
tumble (shortedge)
The duplex (alias lduplex) and duplexshort (alias sduplex) will print on both sides of the paper; duplexshort will reverse the
orientation; simplex will print only on one side of the paper.
The tumble (shortedge) will reverse the orientation of the paper. Used when printing facing pages of duplex and there is a
desperate need for this orientation.
Copies
copies=N
Be aware that this option is totally bogus is usually ignored (except when you expect it to be ignored). You have been warned.
OF MODE
The OF mode of operation is selected by the -Fo command line option. When operationg in OF mode it will scan the input for a two character
stop sequence 31 11. When it finds the sequence it will suspend itself. The spooler will restart the filter with a SIGCONT signal when
it has more output for it.
FILES
/etc/ifhp.conf
Configuration files
/usr/lib/ifhp/ifhp
Executables.
SEE ALSO
The IFHP-HOWTO document, which is included as part of the IFHP distribution. This is the principle reference for this filter.
lpd(8), printcap(5).
FTP sites: ftp://ftp.lprng.com
WEB sites: http://www.lprng.com
Mailing List. Send email to lprng-request@lprng.com
with the word 'subscribe' in the boyd.
BUGS
They are not bugs. They are mis-documented features.
AUTHOR
The IFHP filter was inspired by the LPRng CTI-ifhp filter, which was a descendent of the print filters developed by the CTI-Print project
at the Division of Computing Facilities of the Computer Technology Institute (CTI), Patras, Greece.
AUTHORS
Patrick Powell,
Astart Technologies,
San Diego, CA
<papowell@lprng.com>
3.5.20 IFHP(8)