]> andersk Git - libfaim.git/blobdiff - include/aim.h
- Wed Sep 19 18:50:34 PDT 2001
[libfaim.git] / include / aim.h
index cb0b8d429a40ef37a105a85eb8d3ae50290a7480..91111dd78792890f365e850dc9847523e78af6d9 100644 (file)
 #include <faimconfig.h>
 #include <aim_cbtypes.h>
 
-#if !defined(FAIM_USEPTHREADS) && !defined(FAIM_USEFAKELOCKS) && !defined(FAIM_USENOPLOCKS)
-#error pthreads, fakelocks, or noplocks are currently required.
-#endif
-
 #include <stdio.h>
 #include <string.h>
 #include <fcntl.h>
@@ -46,40 +42,6 @@ typedef unsigned long fu32_t;
 typedef fu32_t aim_snacid_t;
 typedef fu16_t flap_seqnum_t;
 
-#ifdef FAIM_USEPTHREADS
-#include <pthread.h>
-#define faim_mutex_t pthread_mutex_t 
-#define faim_mutex_init(x) pthread_mutex_init(x, NULL)
-#define faim_mutex_lock(x) pthread_mutex_lock(x)
-#define faim_mutex_unlock(x) pthread_mutex_unlock(x)
-#define faim_mutex_destroy(x) pthread_mutex_destroy(x)
-#elif defined(FAIM_USEFAKELOCKS)
-/*
- * For platforms without pthreads, we also assume
- * we're not linking against a threaded app.  Which
- * means we don't have to do real locking.  The 
- * macros below do nothing really.  They're a joke.
- * But they get it to compile.
- * 
- * XXX NOTE that locking hasn't really been tested in a long time,
- * and most code written after dec2000 --is not thread safe--.  You'll
- * want to audit locking use before you use less-than-library level
- * concurrency.
- *
- */
-#define faim_mutex_t fu8_t 
-#define faim_mutex_init(x) *x = 0
-#define faim_mutex_lock(x) while(*x != 0) {/* spin */}; *x = 1;
-#define faim_mutex_unlock(x) while(*x != 0) {/* spin spin spin */}; *x = 0;
-#define faim_mutex_destroy(x) while(*x != 0) {/* spiiiinnn */}; *x = 0;
-#elif defined(FAIM_USENOPLOCKS)
-#define faim_mutex_t fu8_t 
-#define faim_mutex_init(x)
-#define faim_mutex_lock(x)
-#define faim_mutex_unlock(x)
-#define faim_mutex_destroy(x)
-#endif
-
 /* Portability stuff (DMP) */
 
 #ifdef _WIN32
@@ -268,12 +230,12 @@ typedef struct aim_conn_s {
        flap_seqnum_t seqnum;
        fu32_t status;
        void *priv; /* misc data the client may want to store */
+       void *internal; /* internal conn-specific libfaim data */
        time_t lastactivity; /* time of last transmit */
        int forcedlatency; 
        void *handlerlist;
-       faim_mutex_t active; /* lock around read/writes */
-       faim_mutex_t seqnum_lock; /* lock around ->seqnum changes */
        void *sessv; /* pointer to parent session */
+       void *inside; /* only accessible from inside libfaim */
        struct aim_conn_s *next;
 } aim_conn_t;
 
@@ -351,7 +313,6 @@ typedef struct aim_session_s {
 
        /* Connection information */
        aim_conn_t *connlist;
-       faim_mutex_t connlistlock;
 
        /*
         * Transmit/receive queues.
@@ -388,7 +349,6 @@ typedef struct aim_session_s {
         * XXX: Should these be per-connection? -mid
         */
        void *snac_hash[FAIM_SNAC_HASH_SIZE];
-       faim_mutex_t snac_hash_locks[FAIM_SNAC_HASH_SIZE];
        aim_snacid_t snacid_next;
 
        struct {
@@ -439,6 +399,10 @@ struct aim_userinfo_s {
 #define AIM_FLAG_AWAY          0x0020
 #define AIM_FLAG_UNKNOWN40     0x0040
 #define AIM_FLAG_UNKNOWN80     0x0080
+#define AIM_FLAG_UNKNOWN100    0x0100
+#define AIM_FLAG_UNKNOWN200    0x0200
+#define AIM_FLAG_ACTIVEBUDDY    0x0400
+#define AIM_FLAG_UNKNOWN800    0x0800
 
 #define AIM_FLAG_ALLUSERS      0x001f
 
@@ -485,9 +449,10 @@ faim_internal int aim_addtlvtochain32(aim_tlvlist_t **list, const fu16_t type, c
 faim_internal int aim_addtlvtochain_raw(aim_tlvlist_t **list, const fu16_t t, const fu16_t l, const fu8_t *v);
 faim_internal int aim_addtlvtochain_caps(aim_tlvlist_t **list, const fu16_t t, const fu16_t caps);
 faim_internal int aim_addtlvtochain_noval(aim_tlvlist_t **list, const fu16_t type);
+faim_internal int aim_addtlvtochain_userinfo(aim_tlvlist_t **list, fu16_t type, struct aim_userinfo_s *ui);
 faim_internal int aim_addtlvtochain_frozentlvlist(aim_tlvlist_t **list, fu16_t type, aim_tlvlist_t **tl);
 faim_internal int aim_counttlvchain(aim_tlvlist_t **list);
-faim_export int aim_sizetlvchain(aim_tlvlist_t **list);
+faim_internal int aim_sizetlvchain(aim_tlvlist_t **list);
 #endif /* FAIM_INTERNAL */
 
 /*
@@ -539,6 +504,7 @@ faim_export int aim_conn_setlatency(aim_conn_t *conn, int newval);
 faim_export int aim_conn_addhandler(aim_session_t *, aim_conn_t *conn, u_short family, u_short type, aim_rxcallback_t newhandler, u_short flags);
 faim_export int aim_clearhandlers(aim_conn_t *conn);
 
+faim_export aim_conn_t *aim_conn_findbygroup(aim_session_t *sess, fu16_t group);
 faim_export aim_session_t *aim_conn_getsess(aim_conn_t *conn);
 faim_export void aim_conn_close(aim_conn_t *deadconn);
 faim_export aim_conn_t *aim_newconn(aim_session_t *, int type, const char *dest);
@@ -570,6 +536,7 @@ faim_export aim_conn_t *aim_getconn_fd(aim_session_t *, int fd);
 
 #define AIM_WARN_ANON                     0x01
 
+faim_export int aim_sendpauseack(aim_session_t *sess, aim_conn_t *conn);
 faim_export int aim_send_warning(aim_session_t *sess, aim_conn_t *conn, const char *destsn, fu32_t flags);
 faim_export int aim_bos_nop(aim_session_t *, aim_conn_t *);
 faim_export int aim_flap_nop(aim_session_t *sess, aim_conn_t *conn);
@@ -609,11 +576,6 @@ faim_export int aim_ads_clientready(aim_session_t *sess, aim_conn_t *conn);
 faim_export int aim_ads_requestads(aim_session_t *sess, aim_conn_t *conn);
 
 /* aim_im.c */
-struct aim_directim_priv {
-       fu8_t cookie[8];
-       char sn[MAXSNLEN+1];
-       fu8_t ip[30];
-};
 
 struct aim_fileheader_t {
 #if 0
@@ -673,15 +635,50 @@ struct aim_chat_roominfo {
 #define AIM_IMFLAGS_SUBENC_MACINTOSH   0x0040 /* damn that Steve Jobs! */
 #define AIM_IMFLAGS_CUSTOMFEATURES     0x0080 /* features field present */
 #define AIM_IMFLAGS_EXTDATA            0x0100
+#define AIM_IMFLAGS_CUSTOMCHARSET      0x0200 /* charset fields set */
+#define AIM_IMFLAGS_MULTIPART          0x0400 /* ->mpmsg section valid */
+
+/*
+ * Multipart message structures.
+ */
+typedef struct aim_mpmsg_section_s {
+       fu16_t charset;
+       fu16_t charsubset;
+       fu8_t *data;
+       fu16_t datalen;
+       struct aim_mpmsg_section_s *next;
+} aim_mpmsg_section_t;
+
+typedef struct aim_mpmsg_s {
+       int numparts;
+       aim_mpmsg_section_t *parts;
+} aim_mpmsg_t;
 
+faim_export int aim_mpmsg_init(aim_session_t *sess, aim_mpmsg_t *mpm);
+faim_export int aim_mpmsg_addraw(aim_session_t *sess, aim_mpmsg_t *mpm, fu16_t charset, fu16_t charsubset, const fu8_t *data, fu16_t datalen);
+faim_export int aim_mpmsg_addascii(aim_session_t *sess, aim_mpmsg_t *mpm, const char *ascii);
+faim_export int aim_mpmsg_addunicode(aim_session_t *sess, aim_mpmsg_t *mpm, const fu16_t *unicode, fu16_t unicodelen);
+faim_export void aim_mpmsg_free(aim_session_t *sess, aim_mpmsg_t *mpm);
+
+/*
+ * Arguments to aim_send_im_ext().
+ *
+ * This is really complicated.  But immensely versatile.
+ *
+ */
 struct aim_sendimext_args {
 
        /* These are _required_ */
        const char *destsn;
-       fu32_t flags;
+       fu32_t flags; /* often 0 */
+
+       /* Only required if not using multipart messages */
        const char *msg;
        int msglen;
 
+       /* Required if ->msg is not provided */
+       aim_mpmsg_t *mpmsg;
+
        /* Only used if AIM_IMFLAGS_HASICON is set */
        fu32_t iconlen;
        time_t iconstamp;
@@ -690,16 +687,34 @@ struct aim_sendimext_args {
        /* Only used if AIM_IMFLAGS_CUSTOMFEATURES is set */
        fu8_t *features;
        fu8_t featureslen;
+
+       /* Only used if AIM_IMFLAGS_CUSTOMCHARSET is set and mpmsg not used */
+       fu16_t charset;
+       fu16_t charsubset;
 };
 
+/*
+ * This information is provided in the Incoming ICBM callback for
+ * Channel 1 ICBM's.  
+ *
+ * Note that although CUSTOMFEATURES and CUSTOMCHARSET say they
+ * are optional, both are always set by the current libfaim code.
+ * That may or may not change in the future.  It is mainly for
+ * consistency with aim_sendimext_args.
+ *
+ * Multipart messages require some explanation. If you want to use them,
+ * I suggest you read all the comments in im.c.
+ *
+ */
 struct aim_incomingim_ch1_args {
 
        /* Always provided */
+       aim_mpmsg_t mpmsg;
+       fu32_t icbmflags; /* some flags apply only to ->msg, not all mpmsg */
+       
+       /* Only provided if message has a human-readable section */
        char *msg;
        int msglen;
-       fu32_t icbmflags;
-       fu16_t flag1;
-       fu16_t flag2;
 
        /* Only provided if AIM_IMFLAGS_HASICON is set */
        time_t iconstamp;
@@ -713,11 +728,16 @@ struct aim_incomingim_ch1_args {
        /* Only provided if AIM_IMFLAGS_EXTDATA is set */
        fu8_t extdatalen;
        fu8_t *extdata;
+
+       /* Only used if AIM_IMFLAGS_CUSTOMCHARSET is set */
+       fu16_t charset;
+       fu16_t charsubset;
 };
 
 struct aim_incomingim_ch2_args {
-       unsigned short reqclass;
-       unsigned short status;
+       fu8_t cookie[8];
+       fu16_t reqclass;
+       fu16_t status;
        union {
                struct {
                        fu32_t checksum;
@@ -727,7 +747,9 @@ struct aim_incomingim_ch2_args {
                } icon;
                struct {
                } voice;
-               struct aim_directim_priv *directim;
+               struct {
+                       fu8_t ip[22]; /* xxx.xxx.xxx.xxx:xxxxx\0 */
+               } imimage;
                struct {
                        char *msg;
                        char *encoding;
@@ -748,8 +770,9 @@ faim_export int aim_send_im(aim_session_t *, aim_conn_t *, const char *destsn, u
 faim_export int aim_send_icon(aim_session_t *sess, aim_conn_t *conn, const char *sn, const fu8_t *icon, int iconlen, time_t stamp, fu32_t iconsum);
 faim_export fu32_t aim_iconsum(const fu8_t *buf, int buflen);
 faim_export int aim_send_im_direct(aim_session_t *, aim_conn_t *, const char *msg);
-faim_export aim_conn_t *aim_directim_initiate(aim_session_t *, aim_conn_t *, struct aim_directim_priv *, const char *destsn);
-faim_export aim_conn_t *aim_directim_connect(aim_session_t *, aim_conn_t *, struct aim_directim_priv *);
+faim_export const char *aim_directim_getsn(aim_conn_t *conn);
+faim_export aim_conn_t *aim_directim_initiate(aim_session_t *, aim_conn_t *, const char *destsn);
+faim_export aim_conn_t *aim_directim_connect(aim_session_t *, const char *sn, const char *addr, const fu8_t *cookie);
 
 faim_export aim_conn_t *aim_getfile_initiate(aim_session_t *sess, aim_conn_t *conn, const char *destsn);
 faim_export int aim_oft_getfile_request(aim_session_t *sess, aim_conn_t *conn, const char *name, int size);
This page took 0.042623 seconds and 4 git commands to generate.