LPF(1)                     OpenBSD Reference Manual                     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.
       /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/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).

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)
