xref: /netbsd-src/usr.sbin/lpr/pac/pac.8 (revision 179b12252ecaf3553d9c2b7458ce62b6a2203d0c)
1.\"	$NetBSD: pac.8,v 1.11 2003/08/07 11:25:32 agc 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.Bk -words
42.Op Fl P Ar printer
43.Ek
44.Bk -words
45.Op Fl p Ar price
46.Ek
47.Op Ar name ...
48.Sh DESCRIPTION
49.Nm
50reads 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
64flag causes the output to be sorted by cost; usually the
65output is sorted alphabetically by name.
66.It Fl m
67flag causes 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 OUTPUT FORMAT
88.Nm
89formats the output into simple table, using four columns - number of feets
90or pages (column "pages/feet"), how many copies were made (column "runs"),
91total price for this print (column "price") and user login with host name
92(column "login" or "host name and login"). If argument
93.Ar name
94was not used and hence
95.Nm
96is printing information for all users,
97a summary line with print totals (runs, pages, price) is appended.
98.Pp
99Note that
100.Nm
101on other system might print the price as price per copy.
102.Sh FILES
103.Bl -tag -width /var/account/?_sum -compact
104.It Pa /var/account/?acct
105raw accounting files
106.It Pa /var/account/?_sum
107summary accounting files
108.It Pa /etc/printcap
109printer capability data base
110.El
111.Sh SEE ALSO
112.Xr printcap 5
113.Sh HISTORY
114The
115.Nm
116command appeared in
117.Bx 4.0 .
118.Sh BUGS
119The relationship between the computed price and reality is
120as yet unknown.
121