LPF(1)								    lpf filter								    LPF(1)

NAME

       lpf - general printer filter

SYNOPSIS

       lpf -Pprinter -wwidth -llength -xwidth -ylength [ -c ] -Kcontrolfilename -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 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.
       /etc/lprng/lpd.conf			    LPRng configuration file
       ${HOME}/.printcap			    user printer description file
       /etc/printcap				    printer description file
       /etc/lprng/lpd.perms			    permissions
       /var/run/lprng/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), lprng_certs(1), lprng_index_certs(1).

AUTHOR

       Patrick Powell <papowell@lprng.com>.

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 developer  mailing  list	is
       lprng-devel@lists.sourceforge.net; subscribe by visiting https://lists.sourceforge.net/lists/listinfo/lprng-devel or sending mail to lprng-
       request@lists.sourceforge.net with the word subscribe in the body.
       The software is available via http://lprng.sourceforge.net

LPRng								    2006-12-09								    LPF(1)