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 EC(FontIDX to be sent to the printer. 

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 EC?D1?  to determine status.  Not all serial printers respond to this command.  Only the following configurations support this command:

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. 

SEE ALSO

lp(1), lpadmin(1). 

HP-UX System Administration Manual.

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996