hpnpf(1)

NAME
     hpnpf, nethandler - network peripheral filter

SYNOPSIS
     hpnpf -P printername -x peripheral [ -nNRvw ] [ -a  type ] [ -b  jobsize
     ] [ -j  jobid+userid ] [ -l logfile ] [ -p port ] [ -s status-file ] [
     file ...  ]

DESCRIPTION
     Hpnpf is a specialized TCP driver for driving network printers.  A
     network printer is a printer attached to the local area network via its
     JetDirect interface or JetDirect EX interface.

     Hpnpf is capable of handling bi-directional communications.  It accepts
     input from either file(s) or standard input.  If the file(s) is supplied,
     it reads each file in sequence, sends it to a network printer over a TCP
     connection. If no input file is given, or if the argument - is
     encountered, hpnpf reads from the standard input, enabling hpnpf to work
     with other programs. Hpnpf also handles the information coming back from
     the printer.  Depending on the specified options (see below), hpnpf may
     pass all the information to standard output, or filter out the PJL data.

     If hpnpf fails to make a connection to peripheral, the connection is
     retried until a successful connection is made unless -R is specified.


   Options
     -Pprintername
          printername is the name under which the System V R3 spooler
          recognizes the printer, as given on the lp command line.  Used to
          update the Impressario POD status data base for the printer.


     -a type
          Indicate that the printer is a PJL (Printer Job Language) based
          printer. The type identifies the type of network interface: 1 for HP
          JetDirect interface, 3 for HP JetDirect EX interface.


     -j jobid+userid
          Provide job id and user id to hpnpf.  Both are used status messages.


     -l logfile
          Write verbose logging information to logfile.  The logging messages
          are details about what hpnpf is doing.  It is mainly for debugging
          use. If the specified log file is not writable, no logging is
          performed.

     -n   Send the PCL escape sequence (ESC&k2G) before the files.  This sets
          the end-of-line character to be newline (ASCII LF) instead of
          carriage-return/line-feed.


     -N   Translate newline (ASCII LF) characters to carriage-return/line-feed
          character pairs for data sent to the network peripheral.  Do not use
          this option for binary transfers.


     -p port
          Connect to port on the network peripheral.  The default is port
          9100.


     -R   Do not retry connecting if the first connection attempt fails.  This
          option allows the retry interval and number of retries before giving
          up to be controlled external to hpnpf.


     -s status-file
          A a series of printing events are recorded in this file The details
          varies, depending on the type of printers, network interfaces, and
          whether the true end-of-job is turned on or off.  The status
          information is recorded in the following formats:

          <date>%%[ status:  <status>; source:<ethernet/token ring> ]%%

          <date>%%[ status:  <status> ]%%

          <date>%%[ printer: <printer error> ]%%


     -x peripheral
          Send the file to peripheral.  This may be a host name or dotted
          decimal Internet address.


     -w   Turn on true end-of-job.  By default, hpnpf reports successful as
          soon as all the files are sent successfully.   Turning on true end-
          of-job forces hpnpf to hang on until receiving a signal from the
          printer indicating that the job has been completely printed.  This
          option is only valid for printers which implement PJL job commands,
          such as LaserJet 4, 4Si, and 4 Plus.



RETURN VALUE
     Hpnpf returns 0 if all the files are sent successfully (true end-of-job
     is off), or when a job are printed successfully (true end-of-job is on).
     It returns non-zero values if a failure was detected.
AUTHOR
     Hewlett-Packard.