usr.sbin/ac/ac.8

   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 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  18 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  20 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  21 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  22 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD: head/usr.sbin/ac/ac.8 248413 2013-03-17 06:54:04Z joel $
  27 .\"
  28 .Dd September 10, 2019
  29 .Dt AC 8
  30 .Os
  31 .Sh NAME
  32 .Nm ac
  33 .Nd connect time accounting
  34 .Sh SYNOPSIS
  35 .Nm
  36 .Op Fl dp
  37 .\".Op Fl c Ar console
  38 .Op Fl t Ar tty
  39 .Op Fl w Ar wtmp
  40 .Op Ar users ...
  41 .Sh DESCRIPTION
  42 If the file
  43 .Pa /var/log/wtmpx
  44 exists, a record of individual login and logout
  45 times are written to it by
  46 .Xr login 1
  47 and
  48 .Xr init 8 ,
  49 respectively.
  50 The
  51 .Nm
  52 utility
  53 examines these records and writes the accumulated connect time (in hours)
  54 for all logins to the standard output.
  55 .Pp
  56 The options are as follows:
  57 .Bl -tag -width indentXXX
  58 .It Fl d
  59 Display the connect times in 24 hour chunks.
  60 .\" .It Fl c Ar console
  61 .\" Use
  62 .\" .Ar console
  63 .\" as the name of the device that local X sessions (ut_host of ":0.0")
  64 .\" originate from.  If any login has been recorded on
  65 .\" .Ar console
  66 .\" then these X sessions are ignored.
  67 .It Fl p
  68 Print individual users' totals.
  69 .It Fl t Ar tty
  70 Only do accounting logins on certain ttys.
  71 The
  72 .Ar tty
  73 specification can start with '!' to indicate not this
  74 .Ar tty
  75 and end with '*' to indicate all similarly named ttys.
  76 Multiple
  77 .Fl t
  78 flags may be specified.
  79 .It Fl w Ar wtmp
  80 Read connect time data from
  81 .Ar wtmp
  82 instead of the default file,
  83 .Pa /var/log/wtmpx .
  84 .It Ar users ...
  85 Display totals for the given individuals only.
  86 .El
  87 .Pp
  88 If no arguments are given,
  89 .Nm
  90 displays the total connect time for all
  91 accounts with login sessions recorded in
  92 .Pa wtmpx .
  93 .Pp
  94 The default
  95 .Pa wtmpx
  96 file will increase without bound unless it is truncated.
  97 It is normally truncated by the daily scripts run
  98 by
  99 .Xr cron 8 ,
 100 which rename and rotate the
 101 .Pa wtmpx
 102 files, keeping a week's worth of data on
 103 hand.
 104 No login or connect time accounting is performed if
 105 .Pa /var/log/wtmpx
 106 does not exist.
 107 .Sh FILES
 108 .Bl -tag -width /var/log/wtmpx -compact
 109 .It Pa /var/log/wtmpx
 110 connect time accounting file
 111 .El
 112 .Sh EXIT STATUS
 113 .Ex -std
 114 .Sh EXAMPLES
 115 Allow times recorded in
 116 .Pa modems
 117 to be charged out at a different rate than
 118 .Pa other :
 119 .Bd -literal -offset indent
 120 ac -p -t "ttyd*" > modems
 121 ac -p -t "!ttyd*" > other
 122 .Ed
 123 .Sh SEE ALSO
 124 .Xr login 1 ,
 125 .Xr getutxent 3 ,
 126 .Xr utmpx 5 ,
 127 .Xr init 8 ,
 128 .Xr sa 8