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