Provided by:
printbill_4.1.2-1.1_i386 
NAME
printbill - print filter front-end to printbilld
SYNOPSIS
printbill --type <foo> [--printbill_secondary <bar1>]
[--printbill_printer <bar2>]
DESCRIPTION
printbill is the front-end to printbilld(1), the printbill daemon which
actually performs billing/accounting/quote generation. It is designed
to be called by lprng via the as=blah option in the printcap(5) file.
It accepts the standard default command-line options presented to it by
lprng, as well as several additional options which modify its
behaviour. These parameters are then sent to printbilld(1) via a Unix-
domain socket, as a semicolon-delimited list terminated by a newline.
The script attempts to open a connection, and read a version string
from the server. If this matches the version number wired into
printbill(1), the command-line parameters passed to printbill(1) from
lprng are then sent to printbilld(1) via a Unix-domain socket, as a
semicolon-delimited list terminated by a newline. printbilld(1) should
then perform the specified operation, and return JSUCC (0) or JREMOVE
(3) to the printbill(1) script depending on the results of the
operation.
The printcap(5) file should have a pair of lines which look like this:
:achk=true
:as=|/usr/sbin/printbill --type foo
foo can be --bill (pre-printing billing), in which case
--printbill_secondary <printer> must also be present in the command
line, --lazybill for lazy print billing (post-printing billing),
--account (no billing, only accounting) or --quote, in which case
--printbill_printer <printer> can also be specified (but <printer> can
be the same as the print queue itself if you want - you can make it
different so you can have a printer called "bill" and a quote-queue
called "quote" which quotes for "bill". printbill --type quote
calculates the bill and sends an e-mail/winpopup message containing the
results back to the user.
If you wish to use --bill, you should have something more like this:
lp|Laser printer (scheduler queue - print to this)
:lp=/dev/null
:achk=true
:as=|/usr/sbin/printbill --type bill --printbill_secondary real
:sd=/var/spool/lpd/lp
real|Laser printer (real queue - you can’t print to this)
:lp=/dev/lp0
:achk=true
:as=|/usr/sbin/printbill_printer
:if=.... (if you need an input filter, e.g. PS -> PCL)
:sd=/var/spool/lpd/lp_real
:mx#0
:sh
You could add this too, to generate quotes:
quote|Quote generator for laser printer
:lp=/dev/null
:achk=true
:as=|/usr/sbin/printbill --type quote --printbill_printer lp
:sd=/var/spool/lpd/lp
Please consult printbill(8) for a more detailed description of how this
works. Note that printbilld(1) must be running before this print filter
will work.
OPTIONS
--type bill|lazybill|account|quote
causes printbilld(1) to do different things - refer to
printbilld(1) for details.
--printbill_secondary <printer>
specifies the secondary printer if --type is "bill".
--printbill_printer <printer>
specifies the actual printer we are generating quotes for if
--type is "quote". If not specified, it defaults to the default
settings (naturally).
-j <jobnum>
specifies the job number (automatically sent by lprng).
-H hostname
specifies the hostname where the job originated (automatically
sent by lprng).
-n <name>
specifies the username for this job (automatically sent by
lprng).
-P <printer>
specifies the name of the print queue (automatically sent by
lprng).
-k <filename>
specifies the control file name (automatically sent by lprng).
-d <directory>
specifies the spool directory for this queue (automatically sent
by lprng).
INSTALLATION
Please see the accompanying README file for installation instructions.
Chances are if you’re reading this it’s correctly installed.
AUTHORS
printbill and the accompanying utilities were written by Daniel
Franklin (d.franklin@ieee.org). The web interface was written by Phil
Ciufo (phil@snrc.uow.edu.au).
AVAILABILITY
You can always grab the latest and greatest version from
http://ieee.uow.edu.au/~daniel/software/printbill
SEE ALSO
printbill(8), printbilld(1), printbill_configure(8),
printbill_grapher(1), percentblack(1), percentcolour(1),
percent_cmy(1), pqcheck(1), printquote(1), printbill_printer(1),
printbillrc(5), printcap(5), pqm(8).