lpfilter(1)						      General Commands Manual						       lpfilter(1)

NAME

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

SYNOPSIS

       | | FontID] filename

       FontID] filename

       nn]

       filename

       filename

       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 subsystem to obtain specialized behavior for specific types of devices or data.  This entry describes cur-
       rently 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]or
       [dirname]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 in the interface script for the printer.

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

       Options:

	      Set mode to portrait (default).

	      Set mode to landscape.

	      Print half pages (default).

	      Print quarter pages.

	      Use font number
			     FontID.  Default is 0.  Causes the string 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:

	      Specifies the ID number by which the font will be referenced.
			     Default is 0.

	      Specify landscape mode.
			     Default is portrait.

	      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  func-
       tionality is required on printers such as the LaserJet, which cannot produce bold print by overstriking.

       Options:

	      Converts <ANYCHAR> to <ANYCHAR><BACKSPACE>_ to italicize ANYCHAR.
			     Also properly italicizes overstruck (bold) characters.  Does work correctly for "hashed-overstrike" such as:

				  <ANYCHAR><BACKSPACE><DIFFERENTCHAR><BACKSPACE>_

	      Prints only the odd numbered pages.
			     Used with for double-sided printing.

	      Print only the even numbered pages.
			     Used with for double sided printing.

	      Specifies the page length, in lines.
			     Default is 60 unless -n or -p is selected, in which case it is 66.

	      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.

	      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:

	      Specifies the printer request ID and is used in various
			     messages regarding the plot request.

	      The requesting user's login name, used to communicate
			     with the user regarding the request.

	      Specifies the use of escape sequences, rather than HP-GL
			     commands, to determine plotter status.

	      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.

	      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 to determine status.  (The characters and represent the ESC or and DC1 or characters, respec-
       tively.)  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:

	      Print request ID used in various communications with the user.

	      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.

	      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(1M).

																       lpfilter(1)