	------------------------------------------------------

ku (killuser) is a utmp based shell admin utility similar to
Slay.  I wrote ku in C in hopes for an increase in program speed,
efficency, and more options, as opposed to other shell/perl
scripts.

Please note that this is my first C project, so please
feel free to inform me of more efficent ways of doing things.
Patches, suggestions, comments/flames, are welcome.

And let me go ahead and answer Flames/questions on the subject of:

 1: "Why would you want to make a program like ku?"
 2: "Don't you think it's a rather pointless program?"
 3: "Why don't you just use 'ps ax' and 'kill -9 <pid>' ?"

Answer 1:   "Because you didn't."
      1a:   "Other people give to the linux community and
             I wanted to give something as well."

Answer 2:   "Now if i felt that way, it wouldn't say alot for
	     for my intelligence level would it?
      2a:   "/dev/null"

Answer 3:   "Because i wrote ku, but by all means, be my guest."

	----------------------------------------------

I haven't had time to write decent documentation for ku
but i'll try and get around to it if i get enough requests
or acknowledgements.

Section 1: 	Basic Help Screen
Section 2: 	Some Examples
     -2.1:	Creating a kill message
Section 3:	Needed

	-----------------------------------------------------
Section: 1 Basic Help Screen

usage: ku [-ahHKgGimpstTuxvV] [--help, --version]

 -a | --all     kills all users execpt you
 -b | --beep    beeps with each termination
 -h | --header  adds a header when -v (--verbose) is used
 -H | --help    shows this help screen screen
 -K | --kill	displays default kill message
 -g | --group   <group> kills any user in <group>
 -G | --gid     <gid> kills any user in <gid>
 -i | --idle    <minutes> kills any user idle <minutes> or greater
 -p | --prompt  prompt for permission before a user is terminated
 -m | --message [optional message] prints specifed message to users
                tty before termination
 -s | --string  <string> matches <string> in login name or tty
 -t | --telnet  kills any telnets
 -T | --tty     <tty> kills user on <tty>
 -u | --user    <user> matches any login with <user>
 -v | --verbose will print information about each user terminated
 -V | --version prints version information

 all --long options can be called as -long
 all options can be combined to allow for pinpoint targeting
 ku run with no arguments will show all users logged in

 The following are some variables that can be used in
 the kill message:

		%l  (for the users login name)
		%r  (for the users real name)
		%g  (for the group id)
		%G  (for the group name)
		%h  (for the home directory)
		%H  (for the host)
		%p  (for the pid)
		%s  (for the shell)
		%t  (for the tty)
		%u  (for the user id)
		%Y  (for your login name)
		%V  (for program name and version)

	----------------------------------------------------

Section 2: Examples

To terminate shells for everyone logged in (except you that is)
try something like this:

'ku -avhbpm'

-a: all users
-v: verbose accounting
-h: add a header
-b: beep with each termination
-p: prompt before each termination
    *NOTE* if you were to type: '?'
    it will show you that person
    'who' kind of output, then prompt
     you again.
-m: print the default kill message to
    each person before killing the login.

or for more personalized attention try:

'ku -avhbp -m "%l just got owned (%p:%H)" 
  
----------------

Section 2.1: Creating a kill message

 The following are some variables that can be used in
 the kill message:

                %l  (for the users login name)
                %r  (for the users real name)
                %g  (for the group id)
                %G  (for the group name)
                %h  (for the home directory)
                %H  (for the host)
                %p  (for the pid)
                %s  (for the shell)
                %t  (for the tty)
                %u  (for the user id)
                %Y  (for your login name)
                %V  (for program name and version)

so when you run ./configure and are prompted for a
personalized kill message you could do something like:

%l (%r) is in group: %G was snakeD_ by %Y [%V]

****NOTE****
each variable is re-evaluated for each person logged in.


	--------------------------------------------------

Section 3: Needed

I am in need of a POP3 email account.  hotmail kills me.
so if anyone could be kind enough to donate a pop3 account,
i would certainly be indebted to you.

-Nathan Benson (size_t@hotmail.com)
