xref: /freebsd/usr.sbin/lpr/pac/pac.8 (revision 734e82fe33aa764367791a7d603b383996c6b40b)
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.\"     @(#)pac.8	8.1 (Berkeley) 6/6/93
29.\"
30.Dd June 6, 1993
31.Dt PAC 8
32.Os
33.Sh NAME
34.Nm pac
35.Nd printer/plotter accounting information
36.Sh SYNOPSIS
37.Nm
38.Op Fl P Ns Ar printer
39.Op Fl c
40.Op Fl m
41.Op Fl p Ns Ar price
42.Op Fl s
43.Op Fl r
44.Op Ar name ...
45.Sh DESCRIPTION
46The
47.Nm
48utility reads the printer/plotter accounting files, accumulating the number
49of pages (the usual case) or feet (for raster devices)
50of paper consumed by each user, and printing out
51how much each user consumed in pages or feet and dollars.
52.Pp
53Options and operands available:
54.Bl -tag -width PPprinter
55.It Fl P Ns Ar printer
56Accounting is done for the named printer.
57Normally, accounting is done for the default printer (site dependent) or
58the value of the environment variable
59.Ev PRINTER
60is used.
61.It Fl c
62Cause the output to be sorted by cost; usually the
63output is sorted alphabetically by name.
64.It Fl m
65Cause the host name to be ignored in the accounting file.
66This
67allows for a user on multiple machines to have all of his printing
68charges grouped together.
69.It Fl p Ns Ar price
70The value
71.Ar price
72is used for the cost in dollars instead of the default value of 0.02
73or the price specified in
74.Pa /etc/printcap .
75.It Fl r
76Reverse the sorting order.
77.It Fl s
78Accounting information is summarized on the
79summary accounting file; this summarization is necessary since on a
80busy system, the accounting file can grow by several lines per day.
81.It Ar names
82Statistics are only printed for user(s)
83.Ar name ;
84usually, statistics are printed for every user who has used any paper.
85.El
86.Sh FILES
87.Bl -tag -width /var/account/?_sum -compact
88.It Pa /var/account/?acct
89raw accounting files
90.It Pa /var/account/?_sum
91summary accounting files
92.It Pa /etc/printcap
93printer capability data base
94.El
95.Sh SEE ALSO
96.Xr printcap 5
97.Sh HISTORY
98The
99.Nm
100utility appeared in
101.Bx 4.0 .
102.Sh BUGS
103The relationship between the computed price and reality is
104as yet unknown.
105