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