|
2
|
1
|
|
|
2 libfaim pre-0.90 or so
|
|
|
3 ----------------------
|
|
|
4
|
|
|
5 This is libfaim, the purpose of which is to implement as much as the
|
|
|
6 AOL AIM/OSCAR protocol as possible (which should be all of it). After
|
|
|
7 nearly a year of development, its still nowhere close.
|
|
|
8
|
|
|
9 This is not a full client and never will be. libfaim only implements
|
|
|
10 the routines to implement a client (ie, there's no user interface).
|
|
|
11
|
|
|
12 Status
|
|
|
13 ------
|
|
|
14
|
|
|
15 I would not recommend using this version of libfaim in any form yet. It's
|
|
|
16 beta-quality and I know it leaks memory quite badly. It seems fairly
|
|
|
17 stable, however. YMMV, YAYOR, etc.
|
|
|
18
|
|
|
19
|
|
|
20 Building
|
|
|
21 --------
|
|
|
22
|
|
|
23 Everything in this libfaim dist should build cleanly on any UNIX(-like)
|
|
|
24 operating system. Originally developed on Linux+glibc. Past versions
|
|
|
25 known to work on Linux+libc5, FreeBSD, HP/UX, Solaris, Mac OS X Server,
|
|
|
26 and others.
|
|
|
27
|
|
|
28 libfaim builds as both libfaim.a and libfaim.so. If your platform for
|
|
|
29 some reason does not support dynamic libraries (eg, you get errors when
|
|
|
30 building libfaim.so), you'll have to tweak the makefiles a bit to get
|
|
|
31 the utils/ directory to build.
|
|
|
32
|
|
|
33 Otherwise, just do a 'make'. I don't believe I use any specific features
|
|
|
34 GNU make, but if something fails, make sure you have it. And bash too.
|
|
|
35
|
|
|
36
|
|
|
37 Accessories
|
|
|
38 -----------
|
|
|
39
|
|
|
40 In utils/, you'll find a few things extra:
|
|
|
41
|
|
|
42 faimtest: very rudimentary front-end. no user interface, but does
|
|
|
43 illustrate the basics of logging in and sending/recieving
|
|
|
44 messages and buddy list notifications. Potential front-
|
|
|
45 end authors start here.
|
|
|
46
|
|
|
47 aimpasswd: utility to change an AIM password without using a full
|
|
|
48 client. Note that at the time of this writing, this
|
|
|
49 didn't work quite right yet. See the top of the code for
|
|
|
50 latest status.
|
|
|
51
|
|
|
52 License
|
|
|
53 -------
|
|
|
54
|
|
|
55 libfaim is covered under my copyright under the terms of the Lesser GNU
|
|
|
56 Public License, as documented in the file COPYING in the top level directory.
|
|
|
57
|
|
|
58
|
|
|
59 Documentation
|
|
|
60 -------------
|
|
|
61
|
|
|
62 Unfortunatly, there is not currently any documentation on the libfaim API.
|
|
|
63 Use the source and utils/faimtest/faimtest.c as a reference when coding
|
|
|
64 front-ends.
|
|
|
65
|
|
|
66
|
|
|
67 Contact Info
|
|
|
68 ------------
|
|
|
69
|
|
|
70 The author (Adam Fritzler), can be reached at afritz@iname.com or mid@auk.cx.
|
|
|
71
|
|
|
72 I did have mailing lists available for faim-related discussion, but they
|
|
|
73 have dwindled and eventually broke and to my knowledge have yet to fix
|
|
|
74 themselves.
|
|
|
75
|
|
|
76 Front-end information:
|
|
|
77 http://www.auk.cx/faim/
|
|
|
78 Protocol information:
|
|
|
79 http://www.auk.cx/faim/protocol/
|
|
|
80
|
