LPF(1)LPF(1)NAME
lpf - general printer filter
SYNOPSIS
lpf -Pprinter-wwidth -llength -xwidth -ylength [ -c ] -Kcontrolfile‐
name -Lbnrname [ -iindent ] [ -Zoptions ] [ -Cclass ] [ -Jjob ] [ -Rac‐
cntname ] -nlogin -hHost -Fformat [ -T[crlf,debug] -Dlevel ] [ affile ]
DESCRIPTION
Lpf is a general printer filter. Usually it is used as filter in the
printcap file and is called by lpd. The -Tcrlf option will suppress
translation of LF to CR/LF pairs. The -Tdebug option will increment
the debug level.
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 print‐
cap file
-xwidth
The page width in pixels, as given in the :px field in the print‐
cap file
-ylength
The page length in pixels, as given in the :py field in the print‐
cap 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 print‐
cap 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
Turn LF to CR/LF translation off.
-Tdebug
Increment the debug level.
EXIT STATUS
The following exit values are returned:
zero (0) Successful completion.
non-zero (!=0) An error occurred.
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.
/usr/local/etc/lpd.conf LPRng configuration file
${HOME}/.printcap user printer description file
/usr/local/etc/printcap printer description file
/usr/local/etc/lpd.perms permissions
/var/run/lpd lock file for queue control
/var/spool/lpd spool directories
/var/spool/lpd/QUEUE/control queue control
/var/spool/lpd/QUEUE/log trace or debug log file
/var/spool/lpd/QUEUE/acct accounting file
/var/spool/lpd/QUEUE/status status file
SEE ALSOlpd.conf(5), lpc(8), lpd(8), lpr(1), lpq(1), lprm(1), printcap(5),
lpd.perms(5), pr(1), lprng_certs(1), lprng_index_certs(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. The LPRng mailing list is
lprng@lprng.com; subscribe by sending mail to lprng-request@lprng.com
with the word subscribe in the body. The software is available from
ftp://ftp.lprng.com/pub/LPRng.
AUTHOR
Patrick Powell <papowell@lprng.com>.
LPRng LPRng-3.9.0 LPF(1)