Output Filter Specifications; Line Printer Administration - Sun Microsystems Sun Workstation 100U System Manager's Manual

Line Printer Spooler Manual
valvarianlBenson-V man: \
:Ip=/dev /vaO:sd=/usr/spool/vad:of /usr/lib/vpf:\
:if=/usr/lib/vpf:tf=/usr/lib/rvcat:af==/usr/adm/vaacct:\
:mx#2000:pl#58:tr==\f:
5. Output Filter Specifications
Setting Up
For most devices or accounting methods, it is probably necessary to create a new filter.
Filters are spawned by Ipd with their standard input the data to
be
printed, and standard out-
put the printer. The standard error is attached to the II file for logging errors. A filter must
return a 0 exit code if there were no errors, 1 if the job should be reprinted, and 2 if the job
should be thrown away. When Iprm sends a kill signal to the Ipd process controlling printing, it
sends a SIGTERM signal to all filters and descendents
ot
filters. This signal can be trapped by
filters which need to perform cleanup operations such as deleting temporary files.
Arguments passed to a filter depend on its type. The
01
filter is called with the following argu-
ments.
ofiler -wwidth -llength
The width and length values come from the pw and pi entries in the printcap database. The il
filter is passed the following parameters.
filter [-c] -wwidth -llength -iindent
-D
login -h host accountinLfile
The -e flag is optional, and only supplied when control characters are to be passed uninter-
preted to the printer (when the -I option of Ipr is used to print the file). The -wand -1
parameters are the same as for the
or
filter. The -n and -h parameters specify the login name
and host name of the job owner. The last argument is the name of the accounting file from
printcap.
All other filters are called with the following arguments:
filter -xwidth -ylength
-D
login -h host accounting_file
The -x and -y options specify the horizontal and vertical page size in pixels (from the px and
py entries in the printcap file). The rest of the arguments are the same as for the il filter.
6. Line Printer Administration
The lpc program provides local control over line printer activity. The major commands and
their intended use will be described. The command format and remaining commands are
described in Ipc(8).
abort and start
Abort terminates an active spooling daemon on the local host immediately and then dis-
ables printing (preventing new daemons from being started by lpr). This is normally used
to force a hung line printer daemon to restart
(Le., lpq reports that there is a daemon
present but nothing is happening). It does not remove any jobs from the queue (use the
lprm command instead). Start enables printing and requests lpd to start printing jobs.
enable and disable
27 July 1983
5