xref: /netbsd-src/usr.sbin/lpr/pac/pac.8 (revision 1ac719d1471d3ae0a3f0c66e42d0affa92669733)
1.\"	$NetBSD: pac.8,v 1.12 2012/04/08 22:00:41 wiz Exp $
2.\"
3.\" Copyright (c) 1983, 1991, 1993
4.\"	The Regents of the University of California.  All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors
15.\"    may be used to endorse or promote products derived from this software
16.\"    without specific prior written permission.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE.
29.\"
30.\"     @(#)pac.8	8.1 (Berkeley) 6/6/93
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 cmrs
41.Op Fl P Ar printer
42.Op Fl p Ar price
43.Op Ar name ...
44.Sh DESCRIPTION
45.Nm
46reads 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
60flag causes the output to be sorted by cost; usually the
61output is sorted alphabetically by name.
62.It Fl m
63flag causes the host name to be ignored in the accounting file.  This
64allows for a user on multiple machines to have all of his printing
65charges grouped together.
66.It Fl p Ns Ar price
67The value
68.Ar price
69is used for the cost in dollars instead of the default value of 0.02
70or the price specified in
71.Pa /etc/printcap .
72.It Fl r
73Reverse the sorting order.
74.It Fl s
75Accounting information is summarized on the
76summary accounting file; this summarization is necessary since on a
77busy system, the accounting file can grow by several lines per day.
78.It Ar names
79Statistics are only printed for user(s)
80.Ar name ;
81usually, statistics are printed for every user who has used any paper.
82.El
83.Sh OUTPUT FORMAT
84.Nm
85formats the output into simple table, using four columns - number of feets
86or pages (column "pages/feet"), how many copies were made (column "runs"),
87total price for this print (column "price") and user login with host name
88(column "login" or "host name and login"). If argument
89.Ar name
90was not used and hence
91.Nm
92is printing information for all users,
93a summary line with print totals (runs, pages, price) is appended.
94.Pp
95Note that
96.Nm
97on other system might print the price as price per copy.
98.Sh FILES
99.Bl -tag -width /var/account/?_sum -compact
100.It Pa /var/account/?acct
101raw accounting files
102.It Pa /var/account/?_sum
103summary accounting files
104.It Pa /etc/printcap
105printer capability data base
106.El
107.Sh SEE ALSO
108.Xr printcap 5
109.Sh HISTORY
110The
111.Nm
112command appeared in
113.Bx 4.0 .
114.Sh BUGS
115The relationship between the computed price and reality is
116as yet unknown.
117