1.\" Copyright (c) 1980, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
| |
3.\"
| 1.\"
|
| 2.\" Copyright (c) 1994 Simon J. Gerraty
3.\" Copyright (c) 1994 Christopher G. Demetriou
4.\" All rights reserved.
5.\"
|
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. All advertising materials mentioning features or use of this software
13.\" must display the following acknowledgement:
| 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:
|
14.\" This product includes software developed by the University of
15.\" California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\" may be used to endorse or promote products derived from this software
18.\" without specific prior written permission.
| 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.\"
| 19.\"
|
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
| 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.
|
31.\"
| 30.\"
|
32.\" @(#)ac.8 8.2 (Berkeley) 4/19/94
| 31.\" $Id: ac.8,v 1.1.1.1 1994/05/18 08:00:45 csgr Exp $
|
33.\"
| 32.\"
|
34.Dd April 19, 1994
| 33.Dd March 15, 1994
|
35.Dt AC 8
| 34.Dt AC 8
|
36.Os BSD 4
| 35.Os
|
37.Sh NAME
38.Nm ac
| 36.Sh NAME
37.Nm ac
|
39.Nd display connect time accounting
| 38.Nd connect time accounting
|
40.Sh SYNOPSIS
41.Nm ac
| 39.Sh SYNOPSIS
40.Nm ac
|
42.Op Fl d
43.Op Fl p
44.Op Fl w Ar file
| 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
| 45.Op Ar users ...
46.Sh DESCRIPTION
|
47If the file
| 47If the file
|
48.Pa /var/log/wtmp
| 48.Pa /var/log/wtmp
|
49exists,
50a record of individual
51login and logout times are written to it by
52.Xr init 8
53and
| 49exists, a record of individual login and logout
50times are written to it by
|
54.Xr login 8
| 51.Xr login 8
|
| 52and
53.Xr init 8 ,
|
55respectively.
| 54respectively.
|
56The program
57.Nm ac
58examines these
59records and writes the accumulated connect time for all logins to the
60standard output.
| 55.Nm \&Ac
56examines these records and writes the accumulated connect time
57for all logins to the standard output.
|
61.Pp
| 58.Pp
|
62Options available:
63.Bl -tag -width people
| 59The options are as follows:
60.Bl -tag -width indentXXX
|
64.It Fl d
65Display the connect times in 24 hour chunks.
| 61.It Fl d
62Display the connect times in 24 hour chunks.
|
| 63.\" .It Fl c Ar console
64.\" Use
65.\" .Ar console
66.\" as the name of the device that local X sessions (ut_host of ":0.0")
67.\" originate from. If any login has been recorded on
68.\" .Ar console
69.\" then these X sessions are ignored unless COMPAT_SUNOS was defined at
70.\" compile time.
|
66.It Fl p
| 71.It Fl p
|
67Display individual user totals.
68.It Fl w Ar file
69Read raw connect time data from
70.Ar file
71instead of the default file
| 72Print individual users' totals.
73.It Fl t Ar tty
74Only do accounting logins on certain ttys. The
75.Ar tty
76specification can start with '!' to indicate not this
77.Ar tty
78and end with '*' to indicate all similarly named ttys.
79Multiple
80.Fl t
81flags may be specified.
82.It Fl w Ar wtmp
83Read connect time data from
84.Ar wtmp
85instead of the default file,
|
72.Pa /var/log/wtmp .
73.It Ar users ...
| 86.Pa /var/log/wtmp .
87.It Ar users ...
|
74Display totals for the given individuals
75only.
| 88Display totals for the given individuals only.
|
76.El
77.Pp
78If no arguments are given,
| 89.El
90.Pp
91If no arguments are given,
|
79.Nm
80displays the total amount of login time for all active accounts on the
81system.
| 92.Nm ac
93displays the total connect time for all
94accounts with login sessions recorded in
95.Pa wtmp .
|
82.Pp
83The default
84.Pa wtmp
| 96.Pp
97The default
98.Pa wtmp
|
85file is an infinitely increasing file
86unless frequently truncated. This is normally
87done by the daily daemon scripts scheduled by
88.Xr cron 8
| 99file will increase without bound unless it is truncated.
100It is normally truncated by the daily scripts run
101by
102.Xr cron 8 ,
|
89which rename and rotate the
90.Pa wtmp
| 103which rename and rotate the
104.Pa wtmp
|
91files before truncating them (and keeping about a weeks worth on hand).
92No login times are collected however, if the file does not exist.
| 105files, keeping a week's worth of data on
106hand. No login or connect time accounting is performed if
107.Pa /var/log/wtmp
108does not exist.
109.Pp
110For example,
111.Bd -literal -offset
112ac -p -t "ttyd*" > modems
113ac -p -t "!ttyd*" > other
114.Ed
115.Pp
116allows times recorded in
117.Pa modems
118to be charged out at a different rate than
119.Pa other .
120.Pp
121The
122.Nm ac
123utility exits 0 on success, and >0 if a fatal error occurs.
|
93.Sh FILES
94.Bl -tag -width /var/log/wtmp.[0-7] -compact
95.It Pa /var/log/wtmp
| 124.Sh FILES
125.Bl -tag -width /var/log/wtmp.[0-7] -compact
126.It Pa /var/log/wtmp
|
| 127connect time accounting file
|
96.It Pa /var/log/wtmp.[0-7]
97rotated files
98.El
99.Sh SEE ALSO
100.Xr init 8 ,
101.Xr sa 8 ,
102.Xr login 1 ,
| 128.It Pa /var/log/wtmp.[0-7]
129rotated files
130.El
131.Sh SEE ALSO
132.Xr init 8 ,
133.Xr sa 8 ,
134.Xr login 1 ,
|
103.Xr utmp 5 .
104.Sh HISTORY
105A
106.Nm
107command appeared in Version 6 AT&T UNIX.
| 135.Xr utmp
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 preceeding 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 correcty process a logout for the user. The default
153.\" value for
154.\" .Pa console
155.\" is usually correct at compile time.
|
| |