Copyright (c) 2003-2004 Jeremy Kister
Author: Jeremy Kister <argus-devel @t jeremykister.com>
Date: 2004-Sep-09 02:05 (EDT)
Function: send messages via AIM/toc

take a look at http://www.jeremykister.com/
for hosting/colo/Internet stuff, check out http://www.nntx.net/

start this before argus is started; just as qpage and/or sendmail are.
I recommend running this under DJB's daemontools.

Be sure to aaim.pl runs as a user that has permissions to remove the
queue files that aimc creates (you dont want to run aaim.pl as nobody,
and run aimc as root).  It's prolly easiest to run aaim.pl as the same
user argusd runs as.

AIM sends some weird characters sometimes, yielding:
"PARSE: how many args in '2'?"
You can hush this by commenting the line in lib/perl5/site_perl/5.x.x/Net/AIM/Connection.pm
there is a number 2 being sent to us, as well as 3 null characters

go to www.aim.com and sign up for a new username/pw if you need one.
note: as of 2003/06/20, there is no need to even read their
confirmation email.

I've noticed that sometimes we connect to the aim server, and show
online, but messages that we send are never delivered -- my solution
is to restart the aaim.pl when/if that happens.

Also, if you aim excessive people (exact number is undetermined), the
AIM servers will not deliver your messages even though they are
accepted, at which point you then have to restart aaim.pl.  I've
noticed AIMing 5 people is ok.. So... hesitate AIMing over that amount.

You can ask the bot several things:
ACK: N - ack notification id N
ACK: all - ack all notifications
argusctl status - prints output of `argusctl status`
whoson - prints a list of online buddies
ping - prints pong (useful for simple testing)

