LPF(1)

NAME
lpf - general printer filter

SYNOPSIS
lpf -Pprinter -wwidth -llength -xwidth -ylength [ -c ] -Kcontrolfilename -Lbnrname [ -iindent ] [ -Zoptions ] [ -Cclass ] [ -Jjob ] [ -Raccntname ] -nlogin -hHost -Fformat [ -T[crlf,endlinechar] -Dlevel ] [ affile ]

DESCRIPTION
Lpf is a general printer filter. Usually it is used as filter in the printcap file and is called by lpd. By default, it will translate LF to CR/LF pairs. The following options passes lpd by default:

-Pprinter
    The name of the printer.

-wwidth
    The page width in chars, as given in the :pw field in the printcap file

-llength
    The page length in lines, as given in the :pl field in the printcap file

-xwidth
    The page width in pixels, as given in the :px field in the printcap file

-ylength
    The page length in pixels, as given in the :py field in the printcap file

-Kcontrolfilename
    The name of the control file.

-Lbnrname
    The banner name. This is set by the lpr -T option.

-nlogin
    The user login name.

-hHost
    The host where the job was submitted.

-Fformat
    The job format from the lpr -F option or other option.

These options are optionally set by lpd:

-Zoptions
    Extra options. They are passed from the -Z parameter given on the lpr command command line and can be interpreted by the filter.

These remaining options can be added to the filter entry in the printcap file:

-c  ignore control characters, set by lpr -b (binary) or -l (literal) options.

-iindent
    The indentation amount, set by lpr -i indent option.

-Cclass
    The class name, set by lpr -C class option.

-Jjob
    The job name, set by lpr -J job option.

-Raccntname
    The name of the accounting file, from printcap information.

-Dlevel
    Sets debug level. The level must be an integer, a nonzero value switches debugging on.

-Tcrlf
    Turns LF to CRLF translation off.

-TNNN
    NNN is an integer in C format. The corresponding character is appended to the end of a line. This can be done to force a different form of CR/LF translation.

FILES

The files used by LPRng are set by values in the printer configuration file. The following are a commonly used set of default values.
/etc/lpd.conf		LPRng configuration file
/etc/printcap		printer description file
/etc/lpd.perms	printer permissions
/var/spool/printer*		spool directories
/var/spool/printer*/printer	lock file for queue control
/var/spool/printer*/control.printer	queue control
/var/spool/printer*/active.printer	active job
/var/spool/printer*/log.printer	log file

SEE ALSO
lpd.conf(5), lpc(8), lpd(8), lpr(1), lpq(1), lprm(1), printcap(5), lpd.perms(5), pr(1).

DIAGNOSTICS
Most of the diagnostics are self explanatory.
If you are puzzled over the exact cause of failure,
set the debugging level on (-D5) and run again.
The debugging information will
help you to pinpoint the exact cause of failure.

HISTORY

LPRng is a enhanced printer spooler system with functionality similar to the Berkeley LPR software. In 1988 Patrick Powell released the PLP (Public Line Printer) software, which went through several evolutions. Justin Mason (jmason@iona.ie) generated PLP4.0 from several older releases of PLP. In 1992 Patrick Powell release LPRng, a completely redesigned and newly written version of the software.

The LPRng mailing list is plp@iona.ie; subscribe by sending mail to plp-request@iona.ie with the word subscribe in the body. The software is available from ftp://iona.ie/pub/LPRng.

LPRng is distributed under the GNU software license for non-commercial use, the Artistic License for limited commercial use. Commerical support and licensing is available through Patrick Powell <papowell@sdsu.edu>.