lpfilter(1)

NAME

lpfilter: divpage, fontdl, lprpp, plotdvr, printstat, reverse — filters invoked by lp interface scripts

SYNOPSIS

/usr/lbin/divpage [-p | -l] [-h | -q] [-n FontID] filename

/usr/lbin/fontdl [-n FontID] [-l] [-p] filename

/usr/lbin/lprpp [-i] [-o] [-e] [-l nn] [-n] [-p]

/usr/lbin/plotdvr -lrequest_id -uusername [-e] [-f] [-i] filename

/usr/sbin/printstat -lrequest_id -uusername filename

/usr/sbin/reverse [-l page_length]

Remarks

The structure of these filters is currently under review. They may become obsolete or be restructured in a future release.

DESCRIPTION

Various filters are used by the lp subsystem to obtain specialized behavior for specific types of devices or data. This entry describes currently supported filters.

A number of these filters use a specified username and filename to determine the location of the user who originated the print message.

The filename is used to determine the hostname of the system where the request originated, and must have the form [dirname]/d?Annnhostname or [dirname]/dAnnnnhostname, where dirname is not a path name, but only the name of the basename's parent directory. filename meets this requirement when it is set to $6 in the interface script for the printer.

divpage

Provides capabilities for printing multiple pages per sheet and selection of built-in fonts.

Options:

-p: Set mode to portrait (default).
-l: Set mode to landscape.
-h: Print half pages (default).
-q: Print quarter pages.
-nFontID: Use font number FontID. Default is 0. Causes the string ^[(FontIDX to be sent to the printer. (The character ^[ represents the ESC character.)

fontdl

fontdl downloads the font contained in filename to a printer connected to standard output.

Options:

-nFontID: Specifies the ID number by which the font will be referenced. Default is 0.
-l: Specify landscape mode. Default is portrait.
-p: Specifies proportional spacing. Default is fixed.

lprpp

This is a filter that converts backspace overstrike to line overprint with horizontal print positioning to enhance bold print. This functionality is required on printers such as the LaserJet, which cannot produce bold print by overstriking.

Options:

-i: Converts <ANYCHAR> to <ANYCHAR><BACKSPACE>_ to italicize ANYCHAR. Also properly italicizes overstruck (bold) characters. Does not work correctly for "hashed-overstrike" such as:
<ANYCHAR><BACKSPACE><DIFFERENTCHAR><BACKSPACE>_
-o: Prints only the odd numbered pages. Used with -e for double-sided printing.
-e: Print only the even numbered pages. Used with -o for double sided printing.
-lnn: Specifies the page length, in lines. Default is 60 unless -n or -p is selected, in which case it is 66.
-n: Specifies nroff mode for printing output of the nroff command. Prints 66 lines per page with the first line appearing on logical line 4 of the printer.
-p: Specifies pr mode for printing output from the pr command. Prints 66 lines per page with the first line appearing on logical line 3 of the printer.

plotdvr

HP-GL plotter filter. This filter scans the data for "PG" commands (paper feed). When this data is encountered, the filter strips it from the data stream and informs the requesting user of the need to change paper in the plotter.

Options:

-lrequest_id: Specifies the printer request ID and is used in various messages regarding the plot request.
-uusername: The requesting user's login name, used to communicate with the user regarding the request.
-e: Specifies the use of escape sequences, rather than HP-GL commands, to determine plotter status.
-f: Plot without stopping for paper changes. The "PG" commands are not stripped from the data stream and the user is not notified of them. This option is used on plotters capable of automatic page feed.
-i: Prevents initialization of the plotter.

printstat

Interrogates an RS232 printer as to its status, and does not return until the printer is ready. If the printer is off-line, out of paper, or disconnected, the submitter of the print request is notified of this condition periodically until it is corrected. When the printer is ready to print, the command exits.

Standard input and standard output must both be connected to the serial printer device.

This program uses the send-status command ^[?^Q? to determine status. (The characters ^[ and ^Q represent the ESC or ^[ and DC1 or ^Q characters, respectively.) Not all serial printers respond to this command. Only the following configurations support this command:

Printer	Comments
LaserJet	Not supported
LaserJetII	Supported
LaserJetIID	Requires HP26013A module
LaserJetIIP	Not supported
LaserJetIII	Requires HP26013A module
LaserJet2000	Not supported

Options:

-lrequest-id: Print request ID used in various communications with the user.
-uusername: The requesting user's login name, used to communicate with the user regarding the request.

reverse

Prints the data appearing on the standard input in reverse page order to the standard output. This command can handle up to 2000 pages.

Options:

-lpage_length: Specifies the page length, in lines. Default is 66.

DIAGNOSTICS

Error and diagnostic messages appear on the printed output, on the user's terminal, or are mailed to the user, depending on circumstances.

WARNINGS

There is little consistency in the interface to these filters.

lpfilter(1)

Technical documentation

» Table of Contents

» Index

NAME

SYNOPSIS

Remarks

DESCRIPTION

divpage

fontdl

lprpp

plotdvr

printstat

reverse

DIAGNOSTICS

WARNINGS

SEE ALSO