Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 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
	      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 an-
	      noying 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

       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
       ~/.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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=wuzzah&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help