00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026 #ifndef EVENT2_UTIL_H_INCLUDED_
00027 #define EVENT2_UTIL_H_INCLUDED_
00028
00035 #include <event2/visibility.h>
00036
00037 #ifdef __cplusplus
00038 extern "C" {
00039 #endif
00040
00041 #include <event2/event-config.h>
00042 #ifdef EVENT__HAVE_SYS_TIME_H
00043 #include <sys/time.h>
00044 #endif
00045 #ifdef EVENT__HAVE_STDINT_H
00046 #include <stdint.h>
00047 #elif defined(EVENT__HAVE_INTTYPES_H)
00048 #include <inttypes.h>
00049 #endif
00050 #ifdef EVENT__HAVE_SYS_TYPES_H
00051 #include <sys/types.h>
00052 #endif
00053 #ifdef EVENT__HAVE_STDDEF_H
00054 #include <stddef.h>
00055 #endif
00056 #ifdef _MSC_VER
00057 #include <BaseTsd.h>
00058 #endif
00059 #include <stdarg.h>
00060 #ifdef EVENT__HAVE_NETDB_H
00061 #if !defined(_GNU_SOURCE)
00062 #define _GNU_SOURCE
00063 #endif
00064 #include <netdb.h>
00065 #endif
00066
00067 #ifdef _WIN32
00068 #include <winsock2.h>
00069 #ifdef EVENT__HAVE_GETADDRINFO
00070
00071 #include <ws2tcpip.h>
00072 #endif
00073 #else
00074 #ifdef EVENT__HAVE_ERRNO_H
00075 #include <errno.h>
00076 #endif
00077 #include <sys/socket.h>
00078 #endif
00079
00080 #include <time.h>
00081
00082
00083 #if defined(EVENT__SIZEOF_VOID__) && !defined(EVENT__SIZEOF_VOID_P)
00084 #define EVENT__SIZEOF_VOID_P EVENT__SIZEOF_VOID__
00085 #endif
00086
00116 #ifdef EVENT__HAVE_UINT64_T
00117 #define ev_uint64_t uint64_t
00118 #define ev_int64_t int64_t
00119 #elif defined(_WIN32)
00120 #define ev_uint64_t unsigned __int64
00121 #define ev_int64_t signed __int64
00122 #elif EVENT__SIZEOF_LONG_LONG == 8
00123 #define ev_uint64_t unsigned long long
00124 #define ev_int64_t long long
00125 #elif EVENT__SIZEOF_LONG == 8
00126 #define ev_uint64_t unsigned long
00127 #define ev_int64_t long
00128 #elif defined(EVENT_IN_DOXYGEN_)
00129 #define ev_uint64_t ...
00130 #define ev_int64_t ...
00131 #else
00132 #error "No way to define ev_uint64_t"
00133 #endif
00134
00135 #ifdef EVENT__HAVE_UINT32_T
00136 #define ev_uint32_t uint32_t
00137 #define ev_int32_t int32_t
00138 #elif defined(_WIN32)
00139 #define ev_uint32_t unsigned int
00140 #define ev_int32_t signed int
00141 #elif EVENT__SIZEOF_LONG == 4
00142 #define ev_uint32_t unsigned long
00143 #define ev_int32_t signed long
00144 #elif EVENT__SIZEOF_INT == 4
00145 #define ev_uint32_t unsigned int
00146 #define ev_int32_t signed int
00147 #elif defined(EVENT_IN_DOXYGEN_)
00148 #define ev_uint32_t ...
00149 #define ev_int32_t ...
00150 #else
00151 #error "No way to define ev_uint32_t"
00152 #endif
00153
00154 #ifdef EVENT__HAVE_UINT16_T
00155 #define ev_uint16_t uint16_t
00156 #define ev_int16_t int16_t
00157 #elif defined(_WIN32)
00158 #define ev_uint16_t unsigned short
00159 #define ev_int16_t signed short
00160 #elif EVENT__SIZEOF_INT == 2
00161 #define ev_uint16_t unsigned int
00162 #define ev_int16_t signed int
00163 #elif EVENT__SIZEOF_SHORT == 2
00164 #define ev_uint16_t unsigned short
00165 #define ev_int16_t signed short
00166 #elif defined(EVENT_IN_DOXYGEN_)
00167 #define ev_uint16_t ...
00168 #define ev_int16_t ...
00169 #else
00170 #error "No way to define ev_uint16_t"
00171 #endif
00172
00173 #ifdef EVENT__HAVE_UINT8_T
00174 #define ev_uint8_t uint8_t
00175 #define ev_int8_t int8_t
00176 #elif defined(EVENT_IN_DOXYGEN_)
00177 #define ev_uint8_t ...
00178 #define ev_int8_t ...
00179 #else
00180 #define ev_uint8_t unsigned char
00181 #define ev_int8_t signed char
00182 #endif
00183
00184 #ifdef EVENT__HAVE_UINTPTR_T
00185 #define ev_uintptr_t uintptr_t
00186 #define ev_intptr_t intptr_t
00187 #elif EVENT__SIZEOF_VOID_P <= 4
00188 #define ev_uintptr_t ev_uint32_t
00189 #define ev_intptr_t ev_int32_t
00190 #elif EVENT__SIZEOF_VOID_P <= 8
00191 #define ev_uintptr_t ev_uint64_t
00192 #define ev_intptr_t ev_int64_t
00193 #elif defined(EVENT_IN_DOXYGEN_)
00194 #define ev_uintptr_t ...
00195 #define ev_intptr_t ...
00196 #else
00197 #error "No way to define ev_uintptr_t"
00198 #endif
00199
00200 #ifdef EVENT__ssize_t
00201 #define ev_ssize_t EVENT__ssize_t
00202 #else
00203 #define ev_ssize_t ssize_t
00204 #endif
00205
00206
00207
00208
00209
00210
00211
00212
00213 #ifdef _WIN32
00214 #define ev_off_t ev_int64_t
00215 #elif EVENT__SIZEOF_OFF_T == 8
00216 #define ev_off_t ev_int64_t
00217 #elif EVENT__SIZEOF_OFF_T == 4
00218 #define ev_off_t ev_int32_t
00219 #elif defined(EVENT_IN_DOXYGEN_)
00220 #define ev_off_t ...
00221 #else
00222 #define ev_off_t off_t
00223 #endif
00224
00226
00227
00228
00229
00230
00231
00232
00241 #ifndef EVENT__HAVE_STDINT_H
00242 #define EV_UINT64_MAX ((((ev_uint64_t)0xffffffffUL) << 32) | 0xffffffffUL)
00243 #define EV_INT64_MAX ((((ev_int64_t) 0x7fffffffL) << 32) | 0xffffffffL)
00244 #define EV_INT64_MIN ((-EV_INT64_MAX) - 1)
00245 #define EV_UINT32_MAX ((ev_uint32_t)0xffffffffUL)
00246 #define EV_INT32_MAX ((ev_int32_t) 0x7fffffffL)
00247 #define EV_INT32_MIN ((-EV_INT32_MAX) - 1)
00248 #define EV_UINT16_MAX ((ev_uint16_t)0xffffUL)
00249 #define EV_INT16_MAX ((ev_int16_t) 0x7fffL)
00250 #define EV_INT16_MIN ((-EV_INT16_MAX) - 1)
00251 #define EV_UINT8_MAX 255
00252 #define EV_INT8_MAX 127
00253 #define EV_INT8_MIN ((-EV_INT8_MAX) - 1)
00254 #else
00255 #define EV_UINT64_MAX UINT64_MAX
00256 #define EV_INT64_MAX INT64_MAX
00257 #define EV_INT64_MIN INT64_MIN
00258 #define EV_UINT32_MAX UINT32_MAX
00259 #define EV_INT32_MAX INT32_MAX
00260 #define EV_INT32_MIN INT32_MIN
00261 #define EV_UINT16_MAX UINT16_MAX
00262 #define EV_INT16_MAX INT16_MAX
00263 #define EV_UINT8_MAX UINT8_MAX
00264 #define EV_INT8_MAX INT8_MAX
00265 #define EV_INT8_MIN INT8_MIN
00266
00267 #endif
00268
00269
00275 #if EVENT__SIZEOF_SIZE_T == 8
00276 #define EV_SIZE_MAX EV_UINT64_MAX
00277 #define EV_SSIZE_MAX EV_INT64_MAX
00278 #elif EVENT__SIZEOF_SIZE_T == 4
00279 #define EV_SIZE_MAX EV_UINT32_MAX
00280 #define EV_SSIZE_MAX EV_INT32_MAX
00281 #elif defined(EVENT_IN_DOXYGEN_)
00282 #define EV_SIZE_MAX ...
00283 #define EV_SSIZE_MAX ...
00284 #else
00285 #error "No way to define SIZE_MAX"
00286 #endif
00287
00288 #define EV_SSIZE_MIN ((-EV_SSIZE_MAX) - 1)
00289
00291 #ifdef _WIN32
00292 #define ev_socklen_t int
00293 #elif defined(EVENT__socklen_t)
00294 #define ev_socklen_t EVENT__socklen_t
00295 #else
00296 #define ev_socklen_t socklen_t
00297 #endif
00298
00299 #ifdef EVENT__HAVE_STRUCT_SOCKADDR_STORAGE___SS_FAMILY
00300 #if !defined(EVENT__HAVE_STRUCT_SOCKADDR_STORAGE_SS_FAMILY) \
00301 && !defined(ss_family)
00302 #define ss_family __ss_family
00303 #endif
00304 #endif
00305
00309 #ifdef _WIN32
00310 #define evutil_socket_t intptr_t
00311 #else
00312 #define evutil_socket_t int
00313 #endif
00314
00327 struct evutil_monotonic_timer
00328 #ifdef EVENT_IN_DOXYGEN_
00329 {}
00330 #endif
00331 ;
00332
00333 #define EV_MONOT_PRECISE 1
00334 #define EV_MONOT_FALLBACK 2
00335
00342 EVENT2_EXPORT_SYMBOL int
00343 evutil_date_rfc1123(char *date, const size_t datelen, const struct tm *tm);
00344
00350 EVENT2_EXPORT_SYMBOL
00351 struct evutil_monotonic_timer * evutil_monotonic_timer_new(void);
00352
00356 EVENT2_EXPORT_SYMBOL
00357 void evutil_monotonic_timer_free(struct evutil_monotonic_timer *timer);
00358
00362 EVENT2_EXPORT_SYMBOL
00363 int evutil_configure_monotonic_time(struct evutil_monotonic_timer *timer,
00364 int flags);
00365
00376 EVENT2_EXPORT_SYMBOL
00377 int evutil_gettime_monotonic(struct evutil_monotonic_timer *timer,
00378 struct timeval *tp);
00379
00391 EVENT2_EXPORT_SYMBOL
00392 int evutil_socketpair(int d, int type, int protocol, evutil_socket_t sv[2]);
00398 EVENT2_EXPORT_SYMBOL
00399 int evutil_make_socket_nonblocking(evutil_socket_t sock);
00400
00412 EVENT2_EXPORT_SYMBOL
00413 int evutil_make_listen_socket_reuseable(evutil_socket_t sock);
00414
00425 EVENT2_EXPORT_SYMBOL
00426 int evutil_make_listen_socket_reuseable_port(evutil_socket_t sock);
00427
00434 EVENT2_EXPORT_SYMBOL
00435 int evutil_make_socket_closeonexec(evutil_socket_t sock);
00436
00443 EVENT2_EXPORT_SYMBOL
00444 int evutil_closesocket(evutil_socket_t sock);
00445 #define EVUTIL_CLOSESOCKET(s) evutil_closesocket(s)
00446
00458 EVENT2_EXPORT_SYMBOL
00459 int evutil_make_tcp_listen_socket_deferred(evutil_socket_t sock);
00460
00461 #ifdef _WIN32
00462
00463 #define EVUTIL_SOCKET_ERROR() WSAGetLastError()
00464
00465 #define EVUTIL_SET_SOCKET_ERROR(errcode) \
00466 do { WSASetLastError(errcode); } while (0)
00467
00468 EVENT2_EXPORT_SYMBOL
00469 int evutil_socket_geterror(evutil_socket_t sock);
00471 EVENT2_EXPORT_SYMBOL
00472 const char *evutil_socket_error_to_string(int errcode);
00473 #elif defined(EVENT_IN_DOXYGEN_)
00474
00489 #define EVUTIL_SOCKET_ERROR() ...
00490
00491 #define EVUTIL_SET_SOCKET_ERROR(errcode) ...
00492
00493 #define evutil_socket_geterror(sock) ...
00494
00495 #define evutil_socket_error_to_string(errcode) ...
00496
00497 #else
00498 #define EVUTIL_SOCKET_ERROR() (errno)
00499 #define EVUTIL_SET_SOCKET_ERROR(errcode) \
00500 do { errno = (errcode); } while (0)
00501 #define evutil_socket_geterror(sock) (errno)
00502 #define evutil_socket_error_to_string(errcode) (strerror(errcode))
00503 #endif
00504
00505
00514 #ifdef EVENT__HAVE_TIMERADD
00515 #define evutil_timeradd(tvp, uvp, vvp) timeradd((tvp), (uvp), (vvp))
00516 #define evutil_timersub(tvp, uvp, vvp) timersub((tvp), (uvp), (vvp))
00517 #else
00518 #define evutil_timeradd(tvp, uvp, vvp) \
00519 do { \
00520 (vvp)->tv_sec = (tvp)->tv_sec + (uvp)->tv_sec; \
00521 (vvp)->tv_usec = (tvp)->tv_usec + (uvp)->tv_usec; \
00522 if ((vvp)->tv_usec >= 1000000) { \
00523 (vvp)->tv_sec++; \
00524 (vvp)->tv_usec -= 1000000; \
00525 } \
00526 } while (0)
00527 #define evutil_timersub(tvp, uvp, vvp) \
00528 do { \
00529 (vvp)->tv_sec = (tvp)->tv_sec - (uvp)->tv_sec; \
00530 (vvp)->tv_usec = (tvp)->tv_usec - (uvp)->tv_usec; \
00531 if ((vvp)->tv_usec < 0) { \
00532 (vvp)->tv_sec--; \
00533 (vvp)->tv_usec += 1000000; \
00534 } \
00535 } while (0)
00536 #endif
00537
00538 #ifdef EVENT__HAVE_TIMERCLEAR
00539 #define evutil_timerclear(tvp) timerclear(tvp)
00540 #else
00541 #define evutil_timerclear(tvp) (tvp)->tv_sec = (tvp)->tv_usec = 0
00542 #endif
00543
00547 #define evutil_timercmp(tvp, uvp, cmp) \
00548 (((tvp)->tv_sec == (uvp)->tv_sec) ? \
00549 ((tvp)->tv_usec cmp (uvp)->tv_usec) : \
00550 ((tvp)->tv_sec cmp (uvp)->tv_sec))
00551
00552 #ifdef EVENT__HAVE_TIMERISSET
00553 #define evutil_timerisset(tvp) timerisset(tvp)
00554 #else
00555 #define evutil_timerisset(tvp) ((tvp)->tv_sec || (tvp)->tv_usec)
00556 #endif
00557
00559 #ifdef offsetof
00560 #define evutil_offsetof(type, field) offsetof(type, field)
00561 #else
00562 #define evutil_offsetof(type, field) ((off_t)(&((type *)0)->field))
00563 #endif
00564
00565
00567 EVENT2_EXPORT_SYMBOL
00568 ev_int64_t evutil_strtoll(const char *s, char **endptr, int base);
00569
00571 #ifdef EVENT__HAVE_GETTIMEOFDAY
00572 #define evutil_gettimeofday(tv, tz) gettimeofday((tv), (tz))
00573 #else
00574 struct timezone;
00575 EVENT2_EXPORT_SYMBOL
00576 int evutil_gettimeofday(struct timeval *tv, struct timezone *tz);
00577 #endif
00578
00582 EVENT2_EXPORT_SYMBOL
00583 int evutil_snprintf(char *buf, size_t buflen, const char *format, ...)
00584 #ifdef __GNUC__
00585 __attribute__((format(printf, 3, 4)))
00586 #endif
00587 ;
00591 EVENT2_EXPORT_SYMBOL
00592 int evutil_vsnprintf(char *buf, size_t buflen, const char *format, va_list ap)
00593 #ifdef __GNUC__
00594 __attribute__((format(printf, 3, 0)))
00595 #endif
00596 ;
00597
00599 EVENT2_EXPORT_SYMBOL
00600 const char *evutil_inet_ntop(int af, const void *src, char *dst, size_t len);
00602 EVENT2_EXPORT_SYMBOL
00603 int evutil_inet_pton(int af, const char *src, void *dst);
00604 struct sockaddr;
00605
00626 EVENT2_EXPORT_SYMBOL
00627 int evutil_parse_sockaddr_port(const char *str, struct sockaddr *out, int *outlen);
00628
00634 EVENT2_EXPORT_SYMBOL
00635 int evutil_sockaddr_cmp(const struct sockaddr *sa1, const struct sockaddr *sa2,
00636 int include_port);
00637
00641 EVENT2_EXPORT_SYMBOL
00642 int evutil_ascii_strcasecmp(const char *str1, const char *str2);
00646 EVENT2_EXPORT_SYMBOL
00647 int evutil_ascii_strncasecmp(const char *str1, const char *str2, size_t n);
00648
00649
00650
00651 #ifdef EVENT__HAVE_STRUCT_ADDRINFO
00652 #define evutil_addrinfo addrinfo
00653 #else
00654
00659 struct evutil_addrinfo {
00660 int ai_flags;
00661 int ai_family;
00662 int ai_socktype;
00663 int ai_protocol;
00664 size_t ai_addrlen;
00665 char *ai_canonname;
00666 struct sockaddr *ai_addr;
00667 struct evutil_addrinfo *ai_next;
00668 };
00669 #endif
00670
00677 #if defined(EAI_ADDRFAMILY) && defined(EVENT__HAVE_GETADDRINFO)
00678 #define EVUTIL_EAI_ADDRFAMILY EAI_ADDRFAMILY
00679 #else
00680 #define EVUTIL_EAI_ADDRFAMILY -901
00681 #endif
00682 #if defined(EAI_AGAIN) && defined(EVENT__HAVE_GETADDRINFO)
00683 #define EVUTIL_EAI_AGAIN EAI_AGAIN
00684 #else
00685 #define EVUTIL_EAI_AGAIN -902
00686 #endif
00687 #if defined(EAI_BADFLAGS) && defined(EVENT__HAVE_GETADDRINFO)
00688 #define EVUTIL_EAI_BADFLAGS EAI_BADFLAGS
00689 #else
00690 #define EVUTIL_EAI_BADFLAGS -903
00691 #endif
00692 #if defined(EAI_FAIL) && defined(EVENT__HAVE_GETADDRINFO)
00693 #define EVUTIL_EAI_FAIL EAI_FAIL
00694 #else
00695 #define EVUTIL_EAI_FAIL -904
00696 #endif
00697 #if defined(EAI_FAMILY) && defined(EVENT__HAVE_GETADDRINFO)
00698 #define EVUTIL_EAI_FAMILY EAI_FAMILY
00699 #else
00700 #define EVUTIL_EAI_FAMILY -905
00701 #endif
00702 #if defined(EAI_MEMORY) && defined(EVENT__HAVE_GETADDRINFO)
00703 #define EVUTIL_EAI_MEMORY EAI_MEMORY
00704 #else
00705 #define EVUTIL_EAI_MEMORY -906
00706 #endif
00707
00708
00709
00710 #if defined(EAI_NODATA) && defined(EVENT__HAVE_GETADDRINFO) && (!defined(EAI_NONAME) || EAI_NODATA != EAI_NONAME)
00711 #define EVUTIL_EAI_NODATA EAI_NODATA
00712 #else
00713 #define EVUTIL_EAI_NODATA -907
00714 #endif
00715 #if defined(EAI_NONAME) && defined(EVENT__HAVE_GETADDRINFO)
00716 #define EVUTIL_EAI_NONAME EAI_NONAME
00717 #else
00718 #define EVUTIL_EAI_NONAME -908
00719 #endif
00720 #if defined(EAI_SERVICE) && defined(EVENT__HAVE_GETADDRINFO)
00721 #define EVUTIL_EAI_SERVICE EAI_SERVICE
00722 #else
00723 #define EVUTIL_EAI_SERVICE -909
00724 #endif
00725 #if defined(EAI_SOCKTYPE) && defined(EVENT__HAVE_GETADDRINFO)
00726 #define EVUTIL_EAI_SOCKTYPE EAI_SOCKTYPE
00727 #else
00728 #define EVUTIL_EAI_SOCKTYPE -910
00729 #endif
00730 #if defined(EAI_SYSTEM) && defined(EVENT__HAVE_GETADDRINFO)
00731 #define EVUTIL_EAI_SYSTEM EAI_SYSTEM
00732 #else
00733 #define EVUTIL_EAI_SYSTEM -911
00734 #endif
00735
00736 #define EVUTIL_EAI_CANCEL -90001
00737
00738 #if defined(AI_PASSIVE) && defined(EVENT__HAVE_GETADDRINFO)
00739 #define EVUTIL_AI_PASSIVE AI_PASSIVE
00740 #else
00741 #define EVUTIL_AI_PASSIVE 0x1000
00742 #endif
00743 #if defined(AI_CANONNAME) && defined(EVENT__HAVE_GETADDRINFO)
00744 #define EVUTIL_AI_CANONNAME AI_CANONNAME
00745 #else
00746 #define EVUTIL_AI_CANONNAME 0x2000
00747 #endif
00748 #if defined(AI_NUMERICHOST) && defined(EVENT__HAVE_GETADDRINFO)
00749 #define EVUTIL_AI_NUMERICHOST AI_NUMERICHOST
00750 #else
00751 #define EVUTIL_AI_NUMERICHOST 0x4000
00752 #endif
00753 #if defined(AI_NUMERICSERV) && defined(EVENT__HAVE_GETADDRINFO)
00754 #define EVUTIL_AI_NUMERICSERV AI_NUMERICSERV
00755 #else
00756 #define EVUTIL_AI_NUMERICSERV 0x8000
00757 #endif
00758 #if defined(AI_V4MAPPED) && defined(EVENT__HAVE_GETADDRINFO)
00759 #define EVUTIL_AI_V4MAPPED AI_V4MAPPED
00760 #else
00761 #define EVUTIL_AI_V4MAPPED 0x10000
00762 #endif
00763 #if defined(AI_ALL) && defined(EVENT__HAVE_GETADDRINFO)
00764 #define EVUTIL_AI_ALL AI_ALL
00765 #else
00766 #define EVUTIL_AI_ALL 0x20000
00767 #endif
00768 #if defined(AI_ADDRCONFIG) && defined(EVENT__HAVE_GETADDRINFO)
00769 #define EVUTIL_AI_ADDRCONFIG AI_ADDRCONFIG
00770 #else
00771 #define EVUTIL_AI_ADDRCONFIG 0x40000
00772 #endif
00773
00775 struct evutil_addrinfo;
00787 EVENT2_EXPORT_SYMBOL
00788 int evutil_getaddrinfo(const char *nodename, const char *servname,
00789 const struct evutil_addrinfo *hints_in, struct evutil_addrinfo **res);
00790
00792 EVENT2_EXPORT_SYMBOL
00793 void evutil_freeaddrinfo(struct evutil_addrinfo *ai);
00794
00795 EVENT2_EXPORT_SYMBOL
00796 const char *evutil_gai_strerror(int err);
00797
00807 EVENT2_EXPORT_SYMBOL
00808 void evutil_secure_rng_get_bytes(void *buf, size_t n);
00809
00826 EVENT2_EXPORT_SYMBOL
00827 int evutil_secure_rng_init(void);
00828
00842 EVENT2_EXPORT_SYMBOL
00843 int evutil_secure_rng_set_urandom_device_file(char *fname);
00844
00859 EVENT2_EXPORT_SYMBOL
00860 void evutil_secure_rng_add_bytes(const char *dat, size_t datlen);
00861
00862 #ifdef __cplusplus
00863 }
00864 #endif
00865
00866 #endif