SYNOPSIS

       wuzzah [OPTIONS...]

DESCRIPTION

       wuzzah  is  a program that just sits around and scans the utmpx entries
       to watch when your friends log in and out.  By default upon invocation,
       wuzzah  looks  for the file ${HOME}/.wuzzah, and loads the list of bud-
       dies contained therein (which are separated by newlines), and then sits
       and watches.  If no file is found, and no other readable file is speci-
       fied (see OPTIONS), wuzzah will attempt to just watch for whomever  the
       current uid maps, and failing that will just quit.

OPTIONS

       -h, --help
              an  informative  usage  summary,  though  nothing  you don't see
              here...

       -a, --all-users
              watches for all users on the system, period.

       -c, --exec-cmd=CMD
              execute CMD upon a login.  NOTE:  this is done with  a  call  to
              system(2),  so  you  can do things like piping and whatever else
              you can do with sh -c

       -f, --buddy-file=FILE
              use FILE as buddyfile.  naturally FILE  must  be  readable,  and
              consists  of  usernames, one to a line.  optionally, these user-
              names can be followed by a colon, and then a wuzzah command-line
              to override wuzzah's behavior for this specific user.

       -F, --no-buddyfile
              tells wuzzah to not bother loading any config files.

       -i, --interval=NUM
              sleep NUM seconds between each polling

       -m, --message=STRING
              use  STRING  as  a  message template to greet logged-in buddies.
              See the section FORMATS for more information.

       -n, --no-newline
              don't end the messages with newlines (normally does by default)

       -o, --process-once
              scan the login records once, then exit

       -p, --process-current
              by default wuzzah doesn't message users who were already  logged

       -v, --version
              the current version and copyright.

       -w, --write-buddies
              turns on messaging of buddies as they log in.  NOTE:   this  can
              get  quite  annoying  rather  quickly.   tune in soon for a less
              annoying solution

FORMATS

       message templates can be defined as normal  character  strings,  inter-
       spersed with special format characters.  format characters consist of a
       `%', followed by a character, which  defines  situation-specific  data.
       The current list of these characters is as follows:


       a      the alert character ('\a')

       b      the name of the buddy who has logged in/out

       d      the date, currently in HH:MM:SS format

       h and H
              the remote hostname or IP address (respectively) of your buddy's
              login

       l      the line in/out on which the buddy is logged  (typically,  some-
              thing like /dev/pts/9 or /dev/ttyS0)

       m      whether  or  not  you have just messaged your buddy (really only
              useful for the -s option)

       n      an embedded newline character

       o      your buddy's online status ("logged on" or "logged off")

       u      your own username, as can best be determined by the program.

EXAMPLES

       a simple invocation:

       username@machine$ wuzzah
       (13:45:39)  foo logged in on :0      (not messaging).
       (13:45:39)  bar logged in on pts/11  (not messaging).


       Message from username@machine on pts/11 at 14:00 ...
       (wuzzah)  username says: "shoutout to my homie foo."
       EOF

              the default file containing the list of users to watch

BUGS

       don't  know  of  any, but reports (and patches too) are always welcome.
       feel free to send them to the author.

AUTHOR

       sean finney <seanius@seanius.net>



sean finney              Sun Nov 17 02:41:45 EST 2002                wuzzah(1)