accounting: Preface
Preface
*******
Way back a long time ago, Thompson and Ritchie were sitting opposite one
another at the commissary, sipping coffees and discussing their evolving
behemoth.
"This behemoth of ours," said Ken, "is becoming rather popular,
wouldn't you say?" "Yes," said Dennis. "Every time I want to do a
compilation, I have to wait for hours and hours. It's infuriating."
They both agreed that the load on their system was too great. Both
sighed, picked up their mugs, and went back to the workbench. Little
did they know that an upper-management type was sitting just within
earshot of their conversation.
"We are AT&T Bell Laboratories, aren't we?" the upper-management
type thought to himself. "Well, what is our organization best known
for?" The brill-cream in his hair glistened. "Screwing people out of
lots of money, of course! If there were some way that we could keep
tabs on users and charge them through the nose for their CPU time..."
The accounting utilities were born.
Seriously though, the accouting utilities can provide a system
administrator with useful information about system usage--connections,
programs executed, and utilization of system resources.
Information about users--their connect time, location, programs
executed, and the like--is automatically recored in files by 'init' and
'login'. Four of them are of interest to us: 'wtmp', which has records
for each login and logout; 'acct', which records each command that was
run; 'usracct' and 'savacct', which contain summaries of the information
in 'acct' by user and command, respectively. Each of the accounting
utilities reports or summarizes information stored in these files.
'ac'
prints statistics about users' connect time. 'ac' can tell you how
long a particular user or group of users were connected to your
system, printing totals by day or for all of the entries in the
'wtmp' file.
'accton'
turns accounting on or off.
'lastcomm'
lists the commands executed on the system, most recent first,
showing the run state of each command. With 'last', you can search
the 'acct' file for a particular user, terminal, or command.
'sa'
summarizes the information in the 'acct' file into the 'savacct'
and 'usracct' file. It also generates reports about commands,
giving the number of invocations, cpu time used, average core
usage, etc.
'dump-acct'
'dump-utmp'
display 'acct' and 'utmp' files in a human-readable format.
For more detailed information on any of these programs, check the
chapter with the program title.
A Note on File Names and Locations
==================================
The 'wtmp' and 'acct' files seem to live in different places and have
different names for every variant of u*x that exists. The name 'wtmp'
seems to be standard for the login accounting file, but the process
accounting file might be 'acct' or 'pacct' on your system. To find the
actual locations and names of these files on your system, specify the
'--help' flag to any of the programs in this package and the information
will dumped to standard output.
Regardless of the names and locations of files on your system, this
manual will refer to the login accounting file as 'wtmp' and the process
accounting files as 'acct', 'savacct', and 'usracct'.
Support for Multiple Accounting File Formats under Linux
========================================================
The detailed format of the 'acct' file written by the Linux kernel
varies depending on the kernel's version and configuration: Linux
kernels 2.6.7 and earlier write a v0 format 'acct' file which
unfortunately cannot store user and group ids ('uid'/'gid') larger than
65535. Kernels 2.6.8 and later write the 'acct' file in v1, v2 or v3
formats. (v3 if 'BSD_PROCESS_ACCT_V3' is selected in the kernel
configuration, otherwise v1 if on the m68k architecture or v2 everywhere
else).
Since version 6.4 the GNU accounting utilities on Linux systems are
able to read all of the v0, v2 and v3 file formats (v1 is not
supported). Thus you do not need to worry about the details given
above. You can even read 'acct' files where different records were
written by differently configured kernels (you can find out about the
format of each entry by using the 'dump-acct' utility). In case you
ever need to convert an 'acct' file to a different format, the '--raw'
option of 'dump-acct' does that together with the new '--format' and
'--byteswap' options that determine format and byte order of the output
file.
Multiformat support under Linux is intended to be a temporary
solution to aid in switching to the v3 'acct' file format. So do not
expect GNU acct 6.7 to still contain Multiformat support. In a few
years time, when everybody uses the v3 format, the ability to read
multiple formats at runtime will probably be dropped again from the GNU
accounting utilities. This does not, however, affect the ability to
adapt to the 'acct' file format at compile time (when './configure' is
run). Even GNU acct 6.3.5 (that does not know about multiple file
formats) will yield working binary programs when compiled under a (as
yet hypothetical) Linux kernel 2.6.62 that is only able to write the v3
format.
History of the Accounting Utilities
===================================
I don't have any idea who originally wrote these utilities. If anybody
does, please send some mail to 'noel@gnu.ai.mit.edu' and I'll add your
information here!
Since the first alpha versions of this software in late 1993, many
people have contributed to the package. They are (in alphabetical
order):
'Eric Backus <ericb@lsid.hp.com>'
Suggested fixes for HP-UX 9.05 using /bin/cc: configure assumed you
were using 'gcc' and tacked on '-Wall' etc. He also noticed that
'file_rd.c' was doing pointer arithmetic on a 'void *' pointer
(non-ANSI).
'Christoph Badura <bad@flatlin.ka.sub.org>'
Christoph was a BIG HELP in computing statistics, most notably
k*sec stuff! He also did Xenix testing and contributed some
Makefile fixes and output optimizations.
'Michael Calwas <calwas@ttd.teradyne.com>'
Fixed bugs in mktime.c.
'Derek Clegg <dclegg@apple.com>'
Suggested the simple, elegant fix for *_rd_never_used brain-damage.
'Alan Cox <iiitac@pyr.swan.ac.uk>'
Original Linux kernel accounting patches.
'Scott Crosby <root@hypercube.res.cmu.edu>'
Suggested idea behind '--sort-real-time' for 'sa'.
'Solar Designer <solar@false.com>'
Added code for '--ahz' flag in 'lastcomm' and 'sa'.
'Dirk Eddelbuettel <edd@miles.econ.queensu.ca>'
Managed bug-fixes & etc. for Debian distribution, as well as the
architect of merge of GNU + Debian distributions. A big thanks to
Dirk for kicking me back into gear again after a long period of no
work on this project.
'Jason Grant <jamalcol@pc-5530.bc.rogers.wave.ca>'
Identified a buffer-overrun bug in 'sa'.
'Kaveh R. Ghazi <ghazi@caip.rutgers.edu>'
Tested the package on many systems with compilers other than gcc.
Fixed K&R C support.
'Susan Kleinmann <sgk@sgk.tiac.net>'
Contributed excellent man pages!
'Alexander Kourakos <Alexander@Kourakos.com>'
Inspired the '--wide' option for 'last'.
'Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl>'
Suggested the '--ip-address' flag for 'last'.
'David S. Miller <davem@caip.rutgers.edu>'
Noticed missing GNU-standard makefile rules.
'Walter Mueller <walt@pi4.informatik.uni-mannheim.de>'
Noticed install target was missing, and corrected a typo for prefix
in Makefile.in.
'Ian Murdock <imurdock@gnu.ai.mit.edu>'
Tracked down miscellaneous bugs in sa.c under Linux. Added Debian
package maintenance files.
'Tuomo Pyhala <tuomo@lesti.kpnet.fi>'
Reported buggy '--strict-match' flag in 'lastcomm'.
'Tim Schmielau <tim@physik3.uni-rostock.de>'
Added Linux multiformat support.
'Luc I. Suryo <root@patriots.nl.mugnet.org>'
Suggested the '--user' flag for 'lastcomm'.
'Pedro A M Vazquez <vazquez@iqm.unicamp.br>'
Fixed bugs in sa.c and tested under FreeBSD.
'Marco van Wieringen <Marco.van.Wieringen@mcs.nl.mugnet.org>'
Modified (wrote?) Linux kernel accounting patches.