xref: /freebsd/usr.sbin/ac/ac.8 (revision 9336e0699bda8a301cd2bfa37106b6ec5e32012e)
1.\"
2.\" Copyright (c) 1994 Simon J. Gerraty
3.\" Copyright (c) 1994 Christopher G. Demetriou
4.\" 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. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"      This product includes software developed by Christopher G. Demetriou.
17.\" 3. The name of the author may not be used to endorse or promote products
18.\"    derived from this software without specific prior written permission
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30.\"
31.\" $FreeBSD$
32.\"
33.Dd March 15, 1994
34.Dt AC 8
35.Os
36.Sh NAME
37.Nm ac
38.Nd connect time accounting
39.Sh SYNOPSIS
40.Nm
41.Op Fl dp
42.\".Op Fl c Ar console
43.Op Fl t Ar tty
44.Op Fl w Ar wtmp
45.Op Ar users ...
46.Sh DESCRIPTION
47If the file
48.Pa /var/log/wtmp
49exists, a record of individual login and logout
50times are written to it by
51.Xr login 1
52and
53.Xr init 8 ,
54respectively.
55The
56.Nm
57utility
58examines these records and writes the accumulated connect time (in hours)
59for all logins to the standard output.
60.Pp
61The options are as follows:
62.Bl -tag -width indentXXX
63.It Fl d
64Display the connect times in 24 hour chunks.
65.\" .It Fl c Ar console
66.\" Use
67.\" .Ar console
68.\" as the name of the device that local X sessions (ut_host of ":0.0")
69.\" originate from.  If any login has been recorded on
70.\" .Ar console
71.\" then these X sessions are ignored unless COMPAT_SUNOS was defined at
72.\" compile time.
73.It Fl p
74Print individual users' totals.
75.It Fl t Ar tty
76Only do accounting logins on certain ttys.
77The
78.Ar tty
79specification can start with '!' to indicate not this
80.Ar tty
81and end with '*' to indicate all similarly named ttys.
82Multiple
83.Fl t
84flags may be specified.
85.It Fl w Ar wtmp
86Read connect time data from
87.Ar wtmp
88instead of the default file,
89.Pa /var/log/wtmp .
90.It Ar users ...
91Display totals for the given individuals only.
92.El
93.Pp
94If no arguments are given,
95.Nm
96displays the total connect time for all
97accounts with login sessions recorded in
98.Pa wtmp .
99.Pp
100The default
101.Pa wtmp
102file will increase without bound unless it is truncated.
103It is normally truncated by the daily scripts run
104by
105.Xr cron 8 ,
106which rename and rotate the
107.Pa wtmp
108files, keeping a week's worth of data on
109hand.
110No login or connect time accounting is performed if
111.Pa /var/log/wtmp
112does not exist.
113.Pp
114For example,
115.Bd -literal -offset
116ac -p -t "ttyd*" > modems
117ac -p -t "!ttyd*" > other
118.Ed
119.Pp
120allows times recorded in
121.Pa modems
122to be charged out at a different rate than
123.Pa other .
124.Sh FILES
125.Bl -tag -width /var/log/wtmp -compact
126.It Pa /var/log/wtmp
127connect time accounting file
128.El
129.Sh EXIT STATUS
130.Ex -std
131.Sh SEE ALSO
132.Xr login 1 ,
133.Xr utmp 5 ,
134.Xr init 8 ,
135.Xr sa 8
136.\" .Sh NOTES
137.\" If COMPAT_SUNOS is defined
138.\" .Nm ac
139.\" ignores the fact that entries with ut_host of ":0.0" are not real
140.\" login sessions.  Normally such entries are ignored except in the case
141.\" of a user being logged in when the
142.\" .Pa wtmp
143.\" file was rotated, in which case a login with ut_host of ":0.0" may
144.\" appear without any preceding console logins.
145.\" If no one is logged in on the console, the user is deemed to have
146.\" logged in on at the earliest time stamp found in
147.\" .Pa wtmp .
148.\" Use of
149.\" .Pa console
150.\" allows
151.\" .Nm ac
152.\" to identify and correctly process a logout for the user.  The default
153.\" value for
154.\" .Pa console
155.\" is usually correct at compile time.
156