Merge from vendor branch CVS:
[dragonfly.git] / tools / 3.0-upgrade / README
CommitLineData
984263bc 1$FreeBSD: src/tools/3.0-upgrade/README,v 1.2.2.1 2002/08/08 10:05:55 ru Exp $
1de703da 2$DragonFly: src/tools/3.0-upgrade/Attic/README,v 1.2 2003/06/17 04:29:10 dillon Exp $
984263bc
MD
3
4By 1996/12/04, the utmp element size has been changed, in order to
5allow for longer usernames. This change renders all existing wtmp
6files unusable. The cvt-wtmp utility is provided as an aid to convert
7your old wtmp files into the new format, so you don't lose the
8existing track record.
9
10The tool cannot handle gzip'ed wtmp backups, so unzip them first if
11you need. Then simply call it as:
12
13 ./cvt-wtmp /var/log/wtmp*
14
15The old wtmp files are being renamed to <file>.bak, so nothing will be
16lost even in case of a failure. If you are only about to test whether
17the tool will grok your files correctly, you can run it as:
18
19 ./cvt-wtmp -n /var/log/wtmp*
20
21The tool tries an ``educated guess'', based on the reasonability of
22the timestamp values in the wtmp file. If it fails to recognize the
23format of your wtmp, it normally bails out, or at least ignores
24garbage records. In this case, rename the .bak files to the original
25name, and try to force the conversion:
26
27 ./cvt-wtmp -f /var/log/wtmp.xxx
28
29Make sure to verify the result however!
30
31
32Dresden, Jan 2, 1996 Joerg <joerg@FreeBSD.org>