Skip to content

madrisan/wtmpclean

Repository files navigation

👥 wtmpclean

A tool for dumping wtmp files and patching wtmp records.

Usage

wtmpclean [-l|-r] [-t "YYYY.MM.DD HH:MM:SS"] [-f <wtmpfile>] <user> [<fake>]

Where

-f, --file   Modify <wtmpfile> instead of /var/log/wtmp
-l, --list   Show listing of <user> logins
-r, --raw    Show the raw content of the wtmp database
-t, --time   Delete the login at the specified time

Examples

# dump the wtmp records of a given user (`jekyll')
wtmpclean -f /var/log/wtmp.1 -l jekyll
  jekyll   tty2                          Mon May 14 2018 20:24 - 20:24  (00:00)
wtmpclean -f /var/log/wtmp.1 --raw jekyll
  jekyll   [03539] [tty2        ] [tty2] [                   ] [0.0.0.0        ] [2018.05.14 20:24:08]

# replace a single record, using a regular expression
wtmpclean -f /var/log/wtmp.1 -t "2018\.05\.14 20:.*" jekyll nosuchuser
  > wtmpclean: unknown/bad user `nosuchuser'
wtmpclean -f /var/log/wtmp.1 -t "2018\.05\.?? 20:.*" jekyll hide
  > /var/log/wtmp.1: 1 block(s) logging user `jekyll' now belong to user `hide'.

# remove all the occurrences of the user `hide'
wtmpclean -f /var/log/wtmp.1 hide
  > /var/log/wtmp.1: patched 3 block(s) logging user `hide'.

Installation

This package uses GNU autotools for configuration and installation.

It is highly likely that you will want to customise the installation location to suit your needs, i.e.:

autoreconf && ./configure --prefix=/usr/local

Run ./configure --help to see a list of available options.

After ./configure has completed successfully run sudo make install and you're done!

Supported Platforms

This tool is written in plain C, making as few assumptions as possible, and sticking closely to ANSI C/POSIX.

This is a list of platforms this nagios plugin is known to compile and run on

  • Linux (glibc version 2.16.0 and 2.28)

Some documentation

Bugs

If you find a bug please create an issue in the project bug tracker.

This tool uses some POSIX functions that are missing on some platforms: Mac OS X 10.3, FreeBSD 6.0, OpenBSD 3.8, Minix 3.1.8, mingw, MSVC 9, BeOS.