AIM/ICQ-Transport 0.9.25 (CVS)
==============================
http://aim-transport.jabberstudio.org

Features
--------

- reliable messaging (via server only)
- simple user info retrieval (ICQ only)
  may take very long, just wait...
- SMS sending (ICQ)
  send "SEND-SMS:number:text" to any ICQ user, for example
  "SEND-SMS:+4917012345:Test"
- away message retrieval (AIM only)
- offline messages (ICQ only)
- NO file transfer
- NO multichat
- NO user search
- NO incoming SMS


Installation
------------

This version of the AIM Transport is designed specifically to work with
the Jabber server version >=1.4.  It will not work with previous versions
due to the way that it loads itself into the main jabberd binary.

To build the AIM Transport uncompress the tarball, if you uncompressed it
into the Jabber directory you can run the configure directly and it will
find jabberd.  Otherwise, you need to use the --with-jabberd=PATH option
to configure.  At this point you can run make and it should build just
fine.

After the build is complete you will find an aimtrans.so in the src directory.
You will need to edit your jabber.xml to tell jabberd to load this file, and 
let clients be aware of it's availability.  First, in the browse section of the
jsm service you need to add:

    <service type="aim" jid="aim.localhost" name="AIM Transport">
      <ns>jabber:iq:gateway</ns>
      <ns>jabber:iq:register</ns>
    </service>

You can use this transport also for ICQ. If you want to have both a dedicated
AIM and ICQ transport, you can add another service section:

    <service type="icq" jid="icq.localhost" name="ICQ Transport">
      <ns>jabber:iq:gateway</ns>
      <ns>jabber:iq:register</ns>
    </service>

Next you need to add the lines to load in the transport and its
configuration options:

  <service id='aim.localhost'>
    <load><aim_transport>/path/to/your/aimtrans.so</aim_transport></load>
    <aimtrans xmlns='jabber:config:aimtrans'>
      <aimbinarydir>/path/to/aim_install</aimbinarydir>
      <vCard>
        <FN>AIM Transport</FN>
        <DESC>An AIM Transport!</DESC>
        <URL>http://foo.bar/</URL>
      </vCard>
    </aimtrans>
  </service>

This section has to be duplicated accordingly for a separate ICQ transport.
So basically the AIM transport runs twice then, one disguised as an ICQ
transport ;-).

The most interesting of these is the <aimbinarydir/> flag. For aim-t to be
able to work you need a valid program directory from an installed AIM
version 3.5.1670. It has to be that version. I would suggest searching on
Google. For legal reasons I can not distribute this file.

So, to be clear, for the setup above there has to be a
/path/to/aim_install/aim.exe file.

The installer version that works for me is this with md5sum:
04eba0bd0ea5fe1756612e14663093aa  /win/Install_AIM_3.5.1670.exe

After these changes everything should be running smoothly.


Bugs
----

If you experience crashes, please send a backtrace to us. You get a backtrace
by using gdb ("gdb -c core jabberd/jabberd", "bt" command within gdb). To
enable core dump files use "ulimit -c unlimited" (bash).


Contact
-------

Fire any questions to temas@jabber.org or maqi@exmail.de.
