./_Man_SunOS_4.1.3_html/html8/hpnpf.8c.html

Manual page for hpnpf(8C)

hpnpf - network peripheral filter

SYNOPSIS

hpnpf -x peripheral [ -nNrRv ] [ -c port ] [ -l logfile ] [ -p port ] [ -s status-file ] file ...

DESCRIPTION

Hpnpf reads each file in sequence sending it to a network peripheral over a TCP connection. Any output from the network peripheral is written to the standard output. As with cat.1 if no input file is given, or if the argument - is encountered, hpnpf reads from the standard input file, enabling you to combine standard input with other files.

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

With the Sun spooler, hpnpf can operate as an output filter alone, an input filter alone, and as both an output and input filter. When hpnpf is used as an output filter and there is also an input filter, use the -r option on the output filter. With -r, hpnpf accepts a banner page from the standard input, sends it to the network peripheral, and then acts as a "relay" for further data. Subsequent data is sent to the hpnpf relay process by the input filters. The input filters connect to the relay process on the local system using a control and data port as indicated in the file .port left in the current directory by the relay process. After the input filter completes a file, it waits for a single byte response on the control line which indicates that all the data has left the relay process's buffers. A zero response is sent if the data has been trasmitted successfully. A one response is sent if there was an error. The reason behind having a relay process is for the banner page and all the printjob files to be sent to the network peripheral over a single connection.

Options

-c port: Create a control line connection. This option is only used when hpnpf is specified as an input filter in /etc/printcap passing data through a relay process on the same host.
-l logfile: Write verbose logging information to logfile. The logging messages are detailed messages about what hpnpf is doing. Included in the messages are how many bytes are read and written to the network connection. If this option is omitted, 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: Operate in relay mode. This option is only used when hpnpf is specified as an output filter in /etc/printcap and an input filter is specified. Any files listed on the command line are ignored when operating in relay mode.
-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: On a Sun system, update the spooler status-file when connection attempts fail. The input and output filter shell scripts provided in /usr/lib/hpnp assume the status file is named status.
-v: Verbose mode. Display messages to the standard error when the connection is initiated and when it succeeds. Print a hash-sign (#) to the standard error for each 1024 bytes transferred.
-x peripheral: Send the file to peripheral. This may be a host name or dotted decimal Internet address.
-i input tray number: Select input tray for the job. 1 for upper tray, 4 for lower input tray.
-o output tray number: Select output tray for the job. 1 for top output tray, 2 for back output tray.
-j: Output PJL (Printer Job Language) job boundary commands before and after the job.

RETURN VALUE

Hpnpf returns 0 if all the files are sent successfully. It returns a non-zero value if a failure was detected.

AUTHOR