xref: /dragonfly/usr.sbin/lpr/pac/pac.8 (revision 9348a738)
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: src/usr.sbin/lpr/pac/pac.8,v 1.4.2.3 2002/09/01 00:37:36 gad Exp $
30.\" $DragonFly: src/usr.sbin/lpr/pac/pac.8,v 1.3 2006/02/17 19:40:17 swildner Exp $
31.\"
32.Dd June 6, 1993
33.Dt PAC 8
34.Os
35.Sh NAME
36.Nm pac
37.Nd printer/plotter accounting information
38.Sh SYNOPSIS
39.Nm
40.Op Fl P Ns Ar printer
41.Op Fl c
42.Op Fl m
43.Op Fl p Ns Ar price
44.Op Fl s
45.Op Fl r
46.Op Ar name ...
47.Sh DESCRIPTION
48The
49.Nm
50utility reads the printer/plotter accounting files, accumulating the number
51of pages (the usual case) or feet (for raster devices)
52of paper consumed by each user, and printing out
53how much each user consumed in pages or feet and dollars.
54.Pp
55Options and operands available:
56.Bl -tag -width PPprinter
57.It Fl P Ns Ar printer
58Accounting is done for the named printer.
59Normally, accounting is done for the default printer (site dependent) or
60the value of the environment variable
61.Ev PRINTER
62is used.
63.It Fl c
64Cause the output to be sorted by cost; usually the
65output is sorted alphabetically by name.
66.It Fl m
67Cause the host name to be ignored in the accounting file.  This
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