NAME

       wuzzah - keep an eye out for friends on a local system

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
       buddies  contained  therein  (which are separated by newlines), and then sits and watches.  If no file is
       found, and no other readable file is specified (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 usernames 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 in when started up.  this option
              overrides such behavior and messages them anyways (only useful with the -w/-c options)

       -q, --silent
              don't message buddies when they log in (default).

       -s, --status-message=STRING
              use STRING as a template for displaying the status of people logging in and out.  See FORMATS  for
              more information.

       -u, --users=LIST
              adds every user in LIST (a space/comma/colon separated list of users) to the buddy list

       -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,  interspersed  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, something 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

       an example with a little more user customization:

       username@machine$ wuzzah --message="hey, %b, it's %u. nice to see you at %d!"

       and when foo logs in, foo will get a message like so:

       Message from username@machine on pts/11 at 14:00 ...
       hey, foo, it's username. nice to see you at (14:00:00)!
       EOF

FILES

       $HOME/.wuzzah
              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>