wuzzah(1)							      Wuzzah?								 wuzzah(1)

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 invoca-
       tion, 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  mes-
	      sages 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>

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