include/faimconfig.h

   1 /*
   2  *  faimconfig.h
   3  *
   4  * Contains various compile-time options that apply _only_ to libfaim.
   5  *
   6  */
   7
   8 #ifndef __FAIMCONFIG_H__
   9 #define __FAIMCONFIG_H__
  10
  11 /*
  12  * USE_SNAC_FOR_IMS is an old feature that allowed better
  13  * tracking of error messages by caching SNAC IDs of outgoing
  14  * ICBMs and comparing them to incoming errors.  However,
  15  * its a helluvalot of overhead for something that should
  16  * rarely happen.
  17  *
  18  * Default: defined.  This is now defined by default
  19  * because it should be stable and its not too bad.
  20  * And Josh wanted it.
  21  *
  22  */
  23 #define USE_SNAC_FOR_IMS
  24
  25 /*
  26  * Default Authorizer server name and TCP port for the OSCAR farm.
  27  *
  28  * You shouldn't need to change this unless you're writing
  29  * your own server.
  30  *
  31  * Note that only one server is needed to start the whole
  32  * AIM process.  The later server addresses come from
  33  * the authorizer service.
  34  *
  35  * This is only here for convenience.  Its still up to
  36  * the client to connect to it.
  37  *
  38  */
  39 #define FAIM_LOGIN_SERVER "login.oscar.aol.com"
  40 #define FAIM_LOGIN_PORT 5190
  41
  42 /*
  43  * The integer extraction/copying functions in aim_util.c have
  44  * both a function version and a macro version.  The macro
  45  * version is suggested.  Since the function version is more
  46  * readable, I leave both around for reference.
  47  *
  48  * Default: defined.
  49  */
  50 #define AIMUTIL_USEMACROS
  51
  52 /*
  53  * What type of synchronisation to use.
  54  *
  55  * We don't actually use threads, but can use the POSIX mutex
  56  * in order to maintain thread safety.  You can use the fake locking
  57  * if you really don't like pthreads (which I don't) or if you don't
  58  * have it.
  59  *
  60  *   USEPTHREADS - Use POSIX mutecies
  61  *   USEFAKELOCKS - Use little stub spinners to help find locking bugs
  62  *   USENOPLOCKS - No-op out all synchro calls at compile time
  63  *
  64  * Default: use noplocks by default.
  65  *
  66  * !!!NOTE: Even with USEPTHREADS turned on, libfaim is not fully thread
  67  *          safe.  It will still take some effort to add locking calls to
  68  *          the places that need them.  In fact, this feature in general
  69  *          is in danger of being officially deprecated and removed from
  70  *          the code.
  71  *
  72  */
  73 #undef FAIM_USEPTHREADS
  74 #undef FAIM_USEFAKELOCKS
  75 #define FAIM_USENOPLOCKS
  76
  77 /*
  78  * Size of the SNAC caching hash.
  79  *
  80  * Default: 16
  81  *
  82  */
  83 #define FAIM_SNAC_HASH_SIZE 16
  84
  85 /*
  86  * If building on Win32,define WIN32_STATIC if you don't want
  87  * to compile libfaim as a DLL (and instead link it right into
  88  * your app).
  89  */
  90 #define WIN32_STATIC
  91
  92 #endif /* __FAIMCONFIG_H__ */
  93
  94