NAME

lpfilter, cgmtohpgl, divpage, fontdl, lprpp, plotdvr, printstat, reverse − filters invoked by lp interface scripts

SYNOPSIS

/usr/lib/cgmtohpgl −ddevicefile −lrequestid −uusername [−e] [−f] filename

/usr/lib/divpage [−p | −l] [−h | −q] [−nFontID] filename

/usr/lib/fontdl [−nFontID] [−l] [−p] filename

/usr/lib/lprpp [−i] [−o] [−e] [−lnn] [−n] [−p]

/usr/lib/plotdvr −lrequest_id −uusername [−e] [−f] [−i] filename

/usr/lib/printstat −lrequest_id −uusername filename

/usr/lib/reverse [−lpage_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 system to obtain specialized behavior for specific types of devices or data.  This entry describes currently supported filters. 

A number of these filters communicate with the user who originated the print request.  They use the specified username and filename to determine the location of the user.  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 pathname 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. 

cgmtohpgl

cgmtohpgl converts CGM data in filename to HPGL and sends it to a plotter. 

Options:

−ddevicefile Specifies the device to which output is sent.  Must be a character special file. 

−lrequestid 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. 

−e Specifies use of the escape command EC.O to obtain status information instead of the default OS;. 

−f Specifies non-stop plotting.  Assumes automatic paper feed on the plotter. 

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 stdout. 

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><BACKSPACE>_" to italicize ANYCHAR.  Will also properly italicize overstricken (bold) characters.  This will not work correctly for "hashed-overstrike" like <ANYCHAR><BACKSPACE><DIFFERENTCHAR><BACKSPACE>_. 

−o Print only the odd numbered pages.  Used with -even for double sided printing. 

−e Print only the even numbered pages.  Used with -odd 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 of 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.

stdin and stdout 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 8.05: June 1991