Modem Resource Manager.
Copyright (C) 1996-1997 Tim Hart.
Version 1.73


SEE THE GNU GENERAL PUBLIC LICENSE IN THE FILE ./COPYING BEFORE READING
ANY FURTHER.

                           NO WARRANTY

  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.

  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.


[------------------------------------------------------------------------.

                           WHAT IS THIS?

This program reads utmp, checks if specified devices are in use,
and if current modem saturation (see [-m int] option) has been reached. 
This may then happen:

if RANK-BASED (default)
User(s) will be logged out based on their current rank on
a scale which is determined by the admin. ( one implementation is
to put heavy users in the top ranks, then they are the first
in consideration of who to kill ).

if GLG-BASED (turned on by -r toggle option)
User(s) will be logged out based on their respective on-line
times and priorities.

Another feature of this program is the ability to set the minimum wait
time per group of users (GLG) OR per individual user (RANK), before
a re-login may be accepted. An offender will be killed instantly, even if
there are adequate resources available.

Multiple logins may also be controlled.  A limit as to how many logins
users may have simultaneously will allow mrm to kill offending users.
( the number of logins over the limit will be killed, with the most recent
login(s) being spared )

WHAT U NEED TO MAKE IT WORK.

A Linux box. (or a suitable equivalent)
You must have enabled utmp logging for this program.
The utmp file should be located in /var/log/utmp.


NOTE:

mrm has been coded on a linux 2.0.28 system, porting this to other platforms
should be simple, and you are welcome to make any modifications, but please 
contact me if you do (i would like to add the improvements to my version also).

This program has not had alot of testing, and does still contain bugs.  I have
included alot of debugging messages that may help find where the program
crashes.

IMPORTANT:

[COMPILING]:

make clean
make
make install  (puts mrm in /usr/bin, config files in /etc)

[CONFIGURING]:

edit /etc/mrmtty,/etc/mrmgroup,/etc/mrmexempt and /etc/mrmranking,
brief instructions on the format of these files are in the files.

[USAGE]:

run mrm.

if FORK was defined mrm will fork and run in background,
else it will keep control of the terminal and log events to
both the terminal and the logfile... (if logging is on.)

*************************************************************************

[UPDATES]

updates should be uploaded to Sunsite when I have time.
The latest version of mrm should always be available at
ftp://ftp.space.net.au/pub/linux/mrm/

If you make improvements to mrm could you please post them to
me via email. Thankyou.
*************************************************************************

        If you use this program in any way, I would like to hear
from you! :).

email: ice@space.net.au

snail mail:

        Mr Tim Hart
        89 Agincourt Drive
        Forrestfield 6058
        WESTERN AUSTRALIA
