ifhp Build Notes

$Id: ifhp.txt,v 1.1 2004/01/22 19:27:41 jmates Exp $

DESCRIPTION

Covers ifhp version 3.4.1.

The ifhp package is a set of filters aimed to work in conjunction with
the LPRng print spool software to provide native support for a wide
range of HP and other printers.

For proper use, ifhp may require the installation of a version of file
that supports input from STDIN (-), GhostScript, and possibly more
optional packages, depending on what you are trying to do.
GhostScript and file can be found at the respective URL's:

http://www.ghostscript.com/
ftp://ftp.astron.com/pub/file/

INSTALLATION

1)  Obtain the source code and unpack it:

$ lwp-download ftp://ftp.lprng.com/pub/LPRng/FILTERS/ifhp-stable.tgz
$ tar xvzf ifhp-stable.tgz

Or if you lack GNU tar, more typing:

$ gunzip -c ifhp-stable.tgz | tar xvf -

2)  Configure, build, and install the software:

    Make sure you use the same prefix statement as was used when
    building LPRng:

$ ./configure --prefix=/usr --sysconfdir=/etc
$ make
$ su
# make install

    This installs the ifhp filter under /usr/libexec/filters, by
    default.

3)  Post install configuration:

    Generally, one can get by with ifhp by modifying LPRng
    /etc/printcap entries if nothing fancy is required and your
    printer(s) are supported by ifhp:

duplex:
        :server
        :lpd_bounce
        :if=/usr/libexec/filters/ifhp
        :sd=/var/spool/lpd/%P
        :lf=/var/spool/lpd/%P/log
        :af=/var/spool/lpd/%P/acct
        :ifhp=model=hp5simopier
        :lp=raw@lj.example.edu

    However, you may want to setup a similar queue to the same printer
    by sending different options along the way, e.g. to set a duplex
    printer into treeburning (simplex) mode, the following hack
    appears to work:

simplex:
        :server
        :lpd_bounce
        :if=/usr/libexec/filters/ifhp -Zsimplex
        :sd=/var/spool/lpd/%P
        :lf=/var/spool/lpd/%P/log
        :af=/var/spool/lpd/%P/acct
        :ifhp=model=hp5simopier
        :lp=raw@lj.example.edu

    For more advanced configuration, when support for a new printer
    must be added or you want more file types to be recognized, you
    will probably find yourself mucking around in /etc/ifhp.conf,
    which is currently beyond the scope of this document.

    For more information, look under the HOWTO directory under the
    ifhp source directory.

NOTES

ifhp requires the use of GNU make to properly install; otherwise,
various make steps will fail in strange and unusual fashions.

Therefore, on a Digital Unix machine with a bad gcc compiler, you will
have to configure for the native CC:

$ export PATH=/usr/bin:$PATH
$ CC=cc ./configure --args...

And then make sure that GNU make is invoked for the subsequent make
steps:

$ /usr/local/bin/make
$ su
# /usr/local/bin/make install

The PATH is altered to make sure that the various compatible
accessories to the native cc (e.g. ld, ranlib) are called instead of
the GNU ones under /usr/local/bin.

PORTS

ifhp compiled on the following platforms:

Digital Unix 5.0
Linux PPC 2000 (RedHat Linux 6) (via source RPM)

CHANGE LOG

$Log: ifhp.txt,v $
Revision 1.1  2004/01/22 19:27:41  jmates
Sync from subversion sandbox into prior CVS repository for website.

Revision 1.1  2001/11/06 17:56:06  jmates
Import of old talk on LPRng and similar.

Revision 1.4  2000/12/07 21:22:33  jmates
Basically working documentation.

Revision 1.3  2000/12/07 21:11:12  jmates
Initial obtain and install notes, plus Digital Unix quirks.

Revision 1.2  2000/12/07 19:16:49  jmates
Initial work on basic description and other minor details.

Revision 1.1  2000/12/07 19:14:49  jmates
Initial import from template.