1.1. Copyright and Disclaimer

Material included in this document from the ifhp distribution Copyright Patrick Powell 1988-1999, where applicable. The rights to distribute this document complete or in part are hereby granted for non-commercial purposes. Partial reproductions must acknowledge the source. Permission to distribute this file together with LPRng, ifhp and `derived works' is explicitly granted.

THE MATERIAL IN THIS DOCUMENT IS PROVIDED WITHOUT FEE AND AS-IS WITH NO WARRANTY REGARDING FITNESS OF USE FOR ANY PURPOSE. THE AUTHOR AND ALL CONTRIBUTORS ARE NOT LIABLE FOR ANY DAMAGES, DIRECT OR INDIRECT, RESULTING FROM THE USE OF INFORMATION PROVIDED IN THIS DOCUMENT.

1.2. Commercial Support

AStArt Technologies (http://www.astart.com) provides commercial support and enhancements for LPRng, ifhp, and other network software. AStArt provides network and system consulting services for UNIX and NT systems, as well as real time and network software.

1.3. Web Site

Web Page: http://www.lprng.com

1.4. FTP Sites

Main FTP Site:

Mirrors:

1.5. Mailing List

To join the LPRng mailing list, please send mail to lprng-request@lprng.ie with the only the word subscribe in the body of the message.

1.6. PGP Public Key

The LPRng and ifhp distributions have MD5 checksum files which are signed with a PGP public key. Here is the key for validating the checksums:

    Type Bits/KeyID    Date       User ID
    pub  1024/00D95C9D 1997/01/31 Patrick A. Powell <papowell@astart.com>
                                  Patrick A. Powell <papowell@sdsu.edu>
    
    -----BEGIN PGP PUBLIC KEY BLOCK-----
    Version: 2.6.3i
    
    mQCNAzLygTQAAAEEANBW5fPYjN3wSAnP9xWOUc3CvsMUxjip0cN2sY5qrdoJyIhn
    qbAspBopR+tGQfyp5T7C21yfWRRnfXmoJ3FVtgToAsJUYmzoSFY08eDx+rmSqCLe
    rdJjX8aG8jVXpGipEo9U4QsUK+OKzx3/y/OaK4cizoWqKvy1l4lEzDsA2VydAAUT
    tCdQYXRyaWNrIEEuIFBvd2VsbCA8cGFwb3dlbGxAYXN0YXJ0LmNvbT6JAJUDBRA0
    XonoiUTMOwDZXJ0BAQ2cBAC7zU9Fn3sC3x0USJ+3vjhg/qA+Gjb5Fi1dJd4solc4
    vJvtf0UL/1/rGipbR+A0XHpHzJUMP9ZfJzKZjaK/d0ZBNlS3i+JnypypeQiAqo9t
    FV0OyUCwDfWybgAORuAa2V6UJnAhvj/7TpxMmCApolaIb4yFyKunHa8aBxN+17Ro
    rrQlUGF0cmljayBBLiBQb3dlbGwgPHBhcG93ZWxsQHNkc3UuZWR1PokAlQMFEDLy
    gTSJRMw7ANlcnQEBYBYD/0zTeoiDNnI+NjaIei6+6z6oakqO70qFVx0FG3aP3kRH
    WlDhdtFaAuaMRh+RItHfFfcHhw5K7jiJdgKiTgGfj5Vt3OdHYkeeh/sddqgf9YnS
    tpj0u5NfrotPTUw39n6YTgS5/aW0PQfO9dx7jVUcGeod1TGXTe9mIhDMwDJI4J14
    =3Zbp
    -----END PGP PUBLIC KEY BLOCK-----

2.1. Additional Recommended Software

The following software is recommended for use with ifhp. If your printer does not support PostScript, PCL, or text printing directly you will need to install GhostScript to convert from PostScript to the printer format and use a suitable text to PostScript converter.

2.2. Installation

The installation procedure uses the configure facility to generate Makefiles. By convention, these files have the following variables that install the ifhp executables and configuration files in the following locations:

The following files are installed as shown below:

The configuration you choose should match that of the LPRng print spooler. For example:

    ./configure --prefix=/usr --sysconfdir=/etc \
      --mandir=/usr/share/man
    
    executables and files in
       /usr/libexec/filters         ifhp
       /etc                         ifhp.conf
       /usr/share/man/man[0-9]      ifhp.man1

First, we untar, configure, compile, and install the software:

    h4: {1} % gunzip -c ifhp-<version>.tgz | tar xvf -
    h4: {2} % cd ifhp-<version>
    h4: {3} % ./configure  [ ... configuration options ]
    h4: {4} % make clean all
    h4: {5} % su   # you must do the following commands as root
    h4: {6} # make install

Modify your printcap file to use ifhp. Your printcap usually has the following format; older version of lpd require :\ at the end of each line of a printcap entry. The :if and :of filter entries are usually the ones of interest.

    lp:
      :lp=xxxx:sd=xxxx:....
      :if=/usr/local/path_to_old_filters/old_if_filter
      :of=/usr/local/path_to_old_filters/old_of_filter

Your new printcap entry will look like the one below. The MODEL information is described in the next section.

    lp:
      :lp=xxxx:sd=xxxx:....
      #  see text for details about the next line
      :ifhp=model=MODEL,status@
      :filter=/usr/local/libexec/filters/ifhp
      # only if you are using accounting or banners
      #:of=/usr/local/libexec/filters/ifhp

Select a suitable printer from the entries in the configuration file (/usr/local/etc/lpd.conf or /etc/lpd.conf). These are described in more detail in the next section.

Shut down and restart your print spooler and then send a job to the printer. If this works and you do not need any further capabilities of ifhp such as error reporting or printer monitoring, then you are finished.

If you want to use additional capabilities, then you should read the detailed instructions in the next couple of sections.

2.3. Printer Models Supported

There are over 500 different printer models, types and configurations supported by ifhp. If your printer is not currently supported and you have documentation about the printer then send mail to the LPRng Mailing List and support will be added.

The default printer is an HP LaserJet 4MP, which supports PostScript Level 3, PCL5, PJL, and has bidirectional communication and a functional pagecounter.

The ifhp.conf configuration file contains configuration entries for various models of printers. Each entry has a name usually corresponding to the model of printer or its basic capabilities. For example, the HP LaserJet 4 printer has the model=hp4 configuration entry. The default printer configuration covers a wide range of network printers manufactured by Hewlett-Packard, Canon, Epson, and others and is for a printer that has a bidirectional communications connection that allows it to report status information and the following capabilities:

1. PJL support (pjl) compatible with HP 4 family of printers

2. PostScript (PS) support (ps).

3. PCL support (pcl).

4. Text files printed as PCL (text, default_language=pcl).

There is also support for PostScript only printers (model=ps), Tektronics Phasers (model=phaser), QMS (model=qmsXXX) and others. The best way to determine the printers currently supported is to examine the ifhp.conf file. The following is a sample of the various entries in the configuration file.

If your printer is not in this this list then you can use the following guidelines. If you have a PostScript only printer you should use the ps model. If you have a PCL only printer, then pcl is recommended. If you want to process PostScript files on your PCL only printer then install GhostScript and use pcl_ps entry and select the GhostScript driver suitable for your printer.

The other model entries are used when specific printer functionality or features are needed. For example, if you want to do accounting or use landscape mode, then you should check for your specific printer model in the configuration file.

3.1. Input Tray Selection

If a printer supports an input tray selection mechanism, then the following options are recommended for use. Local conditions or printer type may require addition options.

3.2. Output Bin Selection

If a printer has an output bin selection mechanism or some other finishing mechanism, then the following are recommended for use.

3.3. Media Size (Paper) Selection

The paper size selection facilities usually are quite printer dependens 1440x720dpi 32-bit CMYK, 62-pin, inkjet paper imagerunner550 Canon imageRUNNER 550/600 iR600-550-60 imagerunner600 Canon imageRUNNER 550/600 iR600-550-60 hpdj800ps HP DesignJet 800ps panther Sharp Generic Panther Family, PS and PCL, uses SNMP for status and pagecount ar-160 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-161 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-162 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-162s Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-163 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-164 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-200 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-200s Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-201 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-205 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-206 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-207 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount ar-f201 Sharp %, Panther Family, PS and PCL, uses SNMP for status and pagecount cougar Sharp Generic Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-335 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-336 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-337 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-s337 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-405 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-407 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-505 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-s505 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-507 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-s507 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-250 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-280 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-281 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-285 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount ar-286 Sharp %, Cougar Family, PS and PCL, uses SNMP for status and pagecount leopard Sharp Generic Leopard Family, PS and PCL, uses SNMP for status and pagecount ar-235 Sharp %s, Leopard Family, PS and PCL, uses SNMP for status and pagecount ar-275 Sharp %s, Leopard Family, PS and PCL, uses SNMP for status and pagecount ar-n275 Sharp %s, Leopard Family, PS and PCL, uses SNMP for status and pagecount ar-m208 Sharp %s, Leopard Family, PS and PCL, uses SNMP for status and pagecount tiger Sharp Generic Tiger Family, PS and PCL, uses SNMP for status and pagecount ar-p350 Sharp %, Tiger Family, PS and PCL, uses SNMP for status and pagecount ar-m350 Sharp %, Tiger Family, PS and PCL, uses SNMP for status and pagecount ar-m350u Sharp %, Tiger Family, PS and PCL, uses SNMP for status and pagecount ar-m350n Sharp %, Tiger Family, PS and PCL, uses SNMP for status and pagecount ar-p450 Sharp %, Tiger Family, PS and PCL, uses SNMP for status and pagecount ar-m450 Sharp %, Tiger Family, PS and PCL, uses SNMP for status and pagecount ar-m450u Sharp %, Tiger Family, PS and PCL, uses SNMP for status and pagecount ar-m450n Sharp %, Tiger Family, PS and PCL, uses SNMP for status and pagecount toshiba650 Sharp Generic Toshiba650 Family, PS and PCL, uses SNMP for status and pagecount ar-650 Sharp %, Toshiba650 Family, PS and PCL, uses SNMP for status and pagecount ar-800 Sharp %, Toshiba650 Family, PS and PCL, uses SNMP for status and pagecount fiery651 Sharp Generic Fiery651 Family, PS and PCL, uses SNMP for status and pagecount ar-651 Sharp %, Fiery651 Family, PS and PCL, uses SNMP for status and pagecount ar-810 Sharp %, Fiery651 Family, PS and PCL, uses SNMP for status and pagecount