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,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 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
    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
/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 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. 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>.