xref: /freebsd/usr.sbin/lpr/pac/pac.8 (revision 4b9d6057)
1.\" Copyright (c) 1983, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. Neither the name of the University nor the names of its contributors
13.\"    may be used to endorse or promote products derived from this software
14.\"    without specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.Dd June 6, 1993
29.Dt PAC 8
30.Os
31.Sh NAME
32.Nm pac
33.Nd printer/plotter accounting information
34.Sh SYNOPSIS
35.Nm
36.Op Fl P Ns Ar printer
37.Op Fl c
38.Op Fl m
39.Op Fl p Ns Ar price
40.Op Fl s
41.Op Fl r
42.Op Ar name ...
43.Sh DESCRIPTION
44The
45.Nm
46utility reads the printer/plotter accounting files, accumulating the number
47of pages (the usual case) or feet (for raster devices)
48of paper consumed by each user, and printing out
49how much each user consumed in pages or feet and dollars.
50.Pp
51Options and operands available:
52.Bl -tag -width PPprinter
53.It Fl P Ns Ar printer
54Accounting is done for the named printer.
55Normally, accounting is done for the default printer (site dependent) or
56the value of the environment variable
57.Ev PRINTER
58is used.
59.It Fl c
60Cause the output to be sorted by cost; usually the
61output is sorted alphabetically by name.
62.It Fl m
63Cause the host name to be ignored in the accounting file.
64This
65allows for a user on multiple machines to have all of his printing
66charges grouped together.
67.It Fl p Ns Ar price
68The value
69.Ar price
70is used for the cost in dollars instead of the default value of 0.02
71or the price specified in
72.Pa /etc/printcap .
73.It Fl r
74Reverse the sorting order.
75.It Fl s
76Accounting information is summarized on the
77summary accounting file; this summarization is necessary since on a
78busy system, the accounting file can grow by several lines per day.
79.It Ar names
80Statistics are only printed for user(s)
81.Ar name ;
82usually, statistics are printed for every user who has used any paper.
83.El
84.Sh FILES
85.Bl -tag -width /var/account/?_sum -compact
86.It Pa /var/account/?acct
87raw accounting files
88.It Pa /var/account/?_sum
89summary accounting files
90.It Pa /etc/printcap
91printer capability data base
92.El
93.Sh SEE ALSO
94.Xr printcap 5
95.Sh HISTORY
96The
97.Nm
98utility appeared in
99.Bx 4.0 .
100.Sh BUGS
101The relationship between the computed price and reality is
102as yet unknown.
103