|
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
|
|
237
|
7 over a year of development, its still nowhere close.
|
|
2
|
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
|
|
237
|
17 stable, however. YMMV, YAYOR, etc. I suppose I should say regardless of
|
|
|
18 that warning, that several clients use it and people use those clients
|
|
|
19 on a daily basis (in particular, me).
|
|
2
|
20
|
|
|
21
|
|
|
22 Building
|
|
|
23 --------
|
|
|
24
|
|
|
25 Everything in this libfaim dist should build cleanly on any UNIX(-like)
|
|
|
26 operating system. Originally developed on Linux+glibc. Past versions
|
|
237
|
27 known to work on Linux+libc5, FreeBSD, HP/UX, Solaris, Mac OS X Server,
|
|
|
28 Win32 using VC++ 98/6 and others.
|
|
2
|
29
|
|
|
30 libfaim builds as both libfaim.a and libfaim.so. If your platform for
|
|
|
31 some reason does not support dynamic libraries (eg, you get errors when
|
|
|
32 building libfaim.so), you'll have to tweak the makefiles a bit to get
|
|
|
33 the utils/ directory to build.
|
|
|
34
|
|
|
35 Otherwise, just do a 'make'. I don't believe I use any specific features
|
|
|
36 GNU make, but if something fails, make sure you have it. And bash too.
|
|
|
37
|
|
|
38
|
|
|
39 Accessories
|
|
|
40 -----------
|
|
|
41
|
|
|
42 In utils/, you'll find a few things extra:
|
|
|
43
|
|
|
44 faimtest: very rudimentary front-end. no user interface, but does
|
|
|
45 illustrate the basics of logging in and sending/recieving
|
|
|
46 messages and buddy list notifications. Potential front-
|
|
|
47 end authors start here.
|
|
|
48
|
|
|
49 aimpasswd: utility to change an AIM password without using a full
|
|
|
50 client. Note that at the time of this writing, this
|
|
|
51 didn't work quite right yet. See the top of the code for
|
|
|
52 latest status.
|
|
|
53
|
|
|
54 License
|
|
|
55 -------
|
|
|
56
|
|
|
57 libfaim is covered under my copyright under the terms of the Lesser GNU
|
|
|
58 Public License, as documented in the file COPYING in the top level directory.
|
|
|
59
|
|
|
60
|
|
|
61 Documentation
|
|
|
62 -------------
|
|
|
63
|
|
|
64 Unfortunatly, there is not currently any documentation on the libfaim API.
|
|
|
65 Use the source and utils/faimtest/faimtest.c as a reference when coding
|
|
|
66 front-ends.
|
|
|
67
|
|
237
|
68 Mailing Lists
|
|
|
69 -------------
|
|
|
70
|
|
|
71 Thanks to Sourceforge, we have our mailing lists back. See:
|
|
|
72 http://www.sourceforge.org/mail/?group_id=920 for instructions
|
|
|
73 on subscribing to the lists:
|
|
|
74
|
|
|
75 libfaim-devel: Discussion of libfaim and its developement.
|
|
|
76 libfaim-aim-protocol: Discussion of the finer points of OSCAR hacking
|
|
|
77
|
|
2
|
78
|
|
|
79 Contact Info
|
|
|
80 ------------
|
|
|
81
|
|
237
|
82 The author (Adam Fritzler), can be reached at mid@auk.cx.
|
|
2
|
83
|
|
|
84 Front-end information:
|
|
|
85 http://www.auk.cx/faim/
|
|
|
86 Protocol information:
|
|
|
87 http://www.auk.cx/faim/protocol/
|
|
|
88
|
