	-------------------- Purpose

kidled is a Linux daemon that runs in the background, looks for users
who are idle for some time (20 minutes by default, can be changed with
an option), and logs them off.

When a user is logged off all the processes associated with the
terminal are first sent SIGHUP (so that they can terminate gracefully)
and then SIGKILL (so that broken processes won't go into a CPU bound
loop eating up system resources).

Of course, kidled logs all important evens (including kicking users).
During normal operation, nothing but the messages of this sort should
appear in the log:

Jun 14 16:28:40 HOST kidled[28219]: USERNAME from REMOTE.HOST.NAME on
	ttyXX idle 1228 seconds

For more info on running kidled build the program and read the file
kidled.cat or install kidled and type `man kidled'.

There is no config file, you don't have to edit anything
incomprehensible.  No silly actions are taken: no mail sent to anyone,
no alarms set off, no shutdown performed.  All it takes is: print a
message explaining what's going on on user's terminal, report to
syslogd, log the user off.

	-------------------- Build & Install

To build:

* edit the file config.h to suit your system's needs.  (Check that
  UTMP_PATH setting is correct!);

* have a look at Makefile.  By default, the executable and the manual
  page are installed under /usr/local.

* make

To install:

* become the superuser (su);

* make install

	-------------------- Non-portability

This program only runs under Linux.  The reason is that Linux utmp(5)
file format is different from both BSD and SysV formats.  Linux utmp
structure contains a handy field ut_pid, *and* Linux (often) has the
handy fuser(1) command (the last is not required but can be used by
kidled).  It's easy to figure out how to log off a person in Linux.
BSD and SysV would need completely different procedures.  For now it
is decided that it is not necessary to have three completely different
programs doing different things under the same name in the same
distfile.

	-------------------- Author

Send bug reports, suggestions for improvement, liquids, and dead cats
to shalunov at mccme.ru.  If you use this program I would appreciate
it if you send me a note via email.

	-------------------- Copyright

kidled -- kick idle users off the system
Copyright (C) 1998  Stanislav Shalunov

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
without any warranty; without even the implied warranty of
merchantability or fitness for a particular purpose.  See the GNU
General Public License for more details.

You probably already have a copy of the GNU General Public License; if
not, write to the Free Software Foundation, Inc., 59 Temple Place --
Suite 330, Boston, MA 02111-1307, USA

	-------------------- Last change

$Id: README,v 1.3 1998/07/14 11:46:48 shalunov Exp $
