diff options
Diffstat (limited to 'src/include/platform_interface.h')
| -rw-r--r-- | src/include/platform_interface.h | 344 |
1 files changed, 344 insertions, 0 deletions
diff --git a/src/include/platform_interface.h b/src/include/platform_interface.h new file mode 100644 index 00000000..9e63f7a7 --- /dev/null +++ b/src/include/platform_interface.h @@ -0,0 +1,344 @@ +/* + This file is part of libmicrohttpd + Copyright (C) 2014 Karlson2k (Evgeny Grin) + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library. + If not, see <http://www.gnu.org/licenses/>. +*/ + +/** + * @file include/platform_interface.h + * @brief internal platform abstraction functions + * @author Karlson2k (Evgeny Grin) + */ + +#ifndef MHD_PLATFORM_INTERFACE_H +#define MHD_PLATFORM_INTERFACE_H + +#include "platform.h" +#if defined(_WIN32) && !defined(__CYGWIN__) +#include "w32functions.h" +#endif + +/* ***************************** + General function mapping + *****************************/ +#if !defined(_WIN32) || defined(__CYGWIN__) +/** + * Check two strings case-insensitive equality + * @param a first string to check + * @param b second string to check + * @return boolean true if strings are equal, boolean false if strings are unequal + */ +#define MHD_str_equal_caseless_(a,b) (0==strcasecmp((a),(b))) +#else +/** + * Check two strings case-insensitive equality + * @param a first string to check + * @param b second string to check + * @return boolean true if strings are equal, boolean false if strings are unequal + */ +#define MHD_str_equal_caseless_(a,b) (0==_stricmp((a),(b))) +#endif + +#if !defined(_WIN32) || defined(__CYGWIN__) +/** + * Check not more than n chars in two strings case-insensitive equality + * @param a first string to check + * @param b second string to check + * @param n maximum number of chars to check + * @return boolean true if strings are equal, boolean false if strings are unequal + */ +#define MHD_str_equal_caseless_n_(a,b,n) (0==strncasecmp((a),(b),(n))) +#else +/** + * Check not more than n chars in two strings case-insensitive equality + * @param a first string to check + * @param b second string to check + * @param n maximum number of chars to check + * @return boolean true if strings are equal, boolean false if strings are unequal + */ +#define MHD_str_equal_caseless_n_(a,b,n) (0==_strnicmp((a),(b),(n))) +#endif + +/* Platform-independent snprintf name */ +#if !defined(_WIN32) || defined(__CYGWIN__) +#define MHD_snprintf_ snprintf +#else +#define MHD_snprintf_ W32_snprintf +#endif + + + +/* MHD_socket_close_(fd) close any FDs (non-W32) / close only socket FDs (W32) */ +#if !defined(_WIN32) || defined(__CYGWIN__) +#define MHD_socket_close_(fd) close((fd)) +#else +#define MHD_socket_close_(fd) closesocket((fd)) +#endif + +/* MHD_socket_errno_ is errno of last function (non-W32) / errno of last socket function (W32) */ +#if !defined(_WIN32) || defined(__CYGWIN__) +#define MHD_socket_errno_ errno +#else +#define MHD_socket_errno_ MHD_W32_errno_from_winsock_() +#endif + +/* MHD_socket_last_strerr_ is description string of last errno (non-W32) / + * description string of last socket error (W32) */ +#if !defined(_WIN32) || defined(__CYGWIN__) +#define MHD_socket_last_strerr_() strerror(errno) +#else +#define MHD_socket_last_strerr_() MHD_W32_strerror_last_winsock_() +#endif + +/* MHD_strerror_ is strerror (both non-W32/W32) */ +#if !defined(_WIN32) || defined(__CYGWIN__) +#define MHD_strerror_(errnum) strerror((errnum)) +#else +#define MHD_strerror_(errnum) MHD_W32_strerror_((errnum)) +#endif + +/* MHD_set_socket_errno_ set errno to errnum (non-W32) / set socket last error to errnum (W32) */ +#if !defined(_WIN32) || defined(__CYGWIN__) +#define MHD_set_socket_errno_(errnum) errno=(errnum) +#else +#define MHD_set_socket_errno_(errnum) MHD_W32_set_last_winsock_error_((errnum)) +#endif + +/* MHD_SYS_select_ is wrapper macro for system select() function */ +#if !defined(MHD_WINSOCK_SOCKETS) +#define MHD_SYS_select_(n,r,w,e,t) select((n),(r),(w),(e),(t)) +#else +#define MHD_SYS_select_(n,r,w,e,t) select((int)0,(r),(w),(e),(t)) +#endif + +#if defined(HAVE_POLL) +/* MHD_sys_poll_ is wrapper macro for system poll() function */ +#if !defined(MHD_WINSOCK_SOCKETS) +#define MHD_sys_poll_ poll +#else /* MHD_WINSOCK_SOCKETS */ +#define MHD_sys_poll_ WSAPoll +#endif /* MHD_WINSOCK_SOCKETS */ +#endif /* HAVE_POLL */ + +/* MHD_pipe_ create pipe (!MHD_DONT_USE_PIPES) / + * create two connected sockets (MHD_DONT_USE_PIPES) */ +#ifndef MHD_DONT_USE_PIPES +#define MHD_pipe_(fdarr) pipe((fdarr)) +#else /* MHD_DONT_USE_PIPES */ +#if !defined(_WIN32) || defined(__CYGWIN__) +#define MHD_pipe_(fdarr) socketpair(AF_LOCAL, SOCK_STREAM, 0, (fdarr)) +#else /* !defined(_WIN32) || defined(__CYGWIN__) */ +#define MHD_pipe_(fdarr) MHD_W32_pair_of_sockets_((fdarr)) +#endif /* !defined(_WIN32) || defined(__CYGWIN__) */ +#endif /* MHD_DONT_USE_PIPES */ + +/* MHD_pipe_errno_ is errno of last function (!MHD_DONT_USE_PIPES) / + * errno of last emulated pipe function (MHD_DONT_USE_PIPES) */ +#ifndef MHD_DONT_USE_PIPES +#define MHD_pipe_errno_ errno +#else +#define MHD_pipe_errno_ MHD_socket_errno_ +#endif + +/* MHD_pipe_last_strerror_ is description string of last errno (!MHD_DONT_USE_PIPES) / + * description string of last pipe error (MHD_DONT_USE_PIPES) */ +#ifndef MHD_DONT_USE_PIPES +#define MHD_pipe_last_strerror_() strerror(errno) +#else +#define MHD_pipe_last_strerror_() MHD_socket_last_strerr_() +#endif + +/* MHD_pipe_write_ write data to real pipe (!MHD_DONT_USE_PIPES) / + * write data to emulated pipe (MHD_DONT_USE_PIPES) */ +#ifndef MHD_DONT_USE_PIPES +#define MHD_pipe_write_(fd, ptr, sz) write((fd), (const void*)(ptr), (sz)) +#else +#define MHD_pipe_write_(fd, ptr, sz) send((fd), (const char*)(ptr), (sz), 0) +#endif + +/* MHD_pipe_read_ read data from real pipe (!MHD_DONT_USE_PIPES) / + * read data from emulated pipe (MHD_DONT_USE_PIPES) */ +#ifndef MHD_DONT_USE_PIPES +#define MHD_pipe_read_(fd, ptr, sz) read((fd), (void*)(ptr), (sz)) +#else +#define MHD_pipe_read_(fd, ptr, sz) recv((fd), (char*)(ptr), (sz), 0) +#endif + +/* MHD_pipe_close_(fd) close any FDs (non-W32) / + * close emulated pipe FDs (W32) */ +#ifndef MHD_DONT_USE_PIPES +#define MHD_pipe_close_(fd) close((fd)) +#else +#define MHD_pipe_close_(fd) MHD_socket_close_((fd)) +#endif + +/* MHD_INVALID_PIPE_ is a value of bad pipe FD */ +#ifndef MHD_DONT_USE_PIPES +#define MHD_INVALID_PIPE_ (-1) +#else +#define MHD_INVALID_PIPE_ MHD_INVALID_SOCKET +#endif + +#if !defined(_WIN32) || defined(__CYGWIN__) +#define MHD_random_() random() +#else +#define MHD_random_() MHD_W32_random_() +#endif + +#if defined(MHD_USE_POSIX_THREADS) +typedef pthread_t MHD_thread_handle_; +#elif defined(MHD_USE_W32_THREADS) +#include <windows.h> +typedef HANDLE MHD_thread_handle_; +#else +#error "No threading API is available." +#endif + +#if defined(MHD_USE_POSIX_THREADS) +#define MHD_THRD_RTRN_TYPE_ void* +#define MHD_THRD_CALL_SPEC_ +#elif defined(MHD_USE_W32_THREADS) +#define MHD_THRD_RTRN_TYPE_ unsigned +#define MHD_THRD_CALL_SPEC_ __stdcall +#endif + +#if defined(MHD_USE_POSIX_THREADS) +/** + * Wait until specified thread is ended + * @param thread ID to watch + * @return zero on success, nonzero on failure + */ +#define MHD_join_thread_(thread) pthread_join((thread), NULL) +#elif defined(MHD_USE_W32_THREADS) +/** + * Wait until specified thread is ended + * Close thread handle on success + * @param thread handle to watch + * @return zero on success, nonzero on failure + */ +#define MHD_join_thread_(thread) (WAIT_OBJECT_0 == WaitForSingleObject((thread), INFINITE) ? (CloseHandle((thread)), 0) : 1 ) +#endif + +#if defined(MHD_USE_W32_THREADS) +#define MHD_W32_MUTEX_ 1 +#include <windows.h> +typedef CRITICAL_SECTION MHD_mutex_; +#elif defined(HAVE_PTHREAD_H) && defined(MHD_USE_POSIX_THREADS) +#define MHD_PTHREAD_MUTEX_ 1 +typedef pthread_mutex_t MHD_mutex_; +#else +#error "No base mutex API is available." +#endif + +#if defined(MHD_PTHREAD_MUTEX_) +/** + * Create new mutex. + * @param mutex pointer to the mutex + * @return #MHD_YES on success, #MHD_NO on failure + */ +#define MHD_mutex_create_(mutex) \ + ((0 == pthread_mutex_init ((mutex), NULL)) ? MHD_YES : MHD_NO) +#elif defined(MHD_W32_MUTEX_) +/** + * Create new mutex. + * @param mutex pointer to mutex + * @return #MHD_YES on success, #MHD_NO on failure + */ +#define MHD_mutex_create_(mutex) \ + ((NULL != (mutex) && 0 != InitializeCriticalSectionAndSpinCount((mutex),2000)) ? MHD_YES : MHD_NO) +#endif + +#if defined(MHD_PTHREAD_MUTEX_) +/** + * Destroy previously created mutex. + * @param mutex pointer to mutex + * @return #MHD_YES on success, #MHD_NO on failure + */ +#define MHD_mutex_destroy_(mutex) \ + ((0 == pthread_mutex_destroy ((mutex))) ? MHD_YES : MHD_NO) +#elif defined(MHD_W32_MUTEX_) +/** + * Destroy previously created mutex. + * @param mutex pointer to mutex + * @return #MHD_YES on success, #MHD_NO on failure + */ +#define MHD_mutex_destroy_(mutex) \ + ((NULL != (mutex)) ? (DeleteCriticalSection(mutex), MHD_YES) : MHD_NO) +#endif + +#if defined(MHD_PTHREAD_MUTEX_) +/** + * Acquire lock on previously created mutex. + * If mutex was already locked by other thread, function + * blocks until mutex becomes available. + * @param mutex pointer to mutex + * @return #MHD_YES on success, #MHD_NO on failure + */ +#define MHD_mutex_lock_(mutex) \ + ((0 == pthread_mutex_lock((mutex))) ? MHD_YES : MHD_NO) +#elif defined(MHD_W32_MUTEX_) +/** + * Acquire lock on previously created mutex. + * If mutex was already locked by other thread, function + * blocks until mutex becomes available. + * @param mutex pointer to mutex + * @return #MHD_YES on success, #MHD_NO on failure + */ +#define MHD_mutex_lock_(mutex) \ + ((NULL != (mutex)) ? (EnterCriticalSection((mutex)), MHD_YES) : MHD_NO) +#endif + +#if defined(MHD_PTHREAD_MUTEX_) +/** + * Try to acquire lock on previously created mutex. + * Function returns immediately. + * @param mutex pointer to mutex + * @return #MHD_YES if mutex is locked, #MHD_NO if + * mutex was not locked. + */ +#define MHD_mutex_trylock_(mutex) \ + ((0 == pthread_mutex_trylock((mutex))) ? MHD_YES : MHD_NO) +#elif defined(MHD_W32_MUTEX_) +/** + * Try to acquire lock on previously created mutex. + * Function returns immediately. + * @param mutex pointer to mutex + * @return #MHD_YES if mutex is locked, #MHD_NO if + * mutex was not locked. + */ +#define MHD_mutex_trylock_(mutex) \ + ((NULL != (mutex) && 0 != TryEnterCriticalSection ((mutex))) ? MHD_YES : MHD_NO) +#endif + +#if defined(MHD_PTHREAD_MUTEX_) +/** + * Unlock previously created and locked mutex. + * @param mutex pointer to mutex + * @return #MHD_YES on success, #MHD_NO on failure + */ +#define MHD_mutex_unlock_(mutex) \ + ((0 == pthread_mutex_unlock((mutex))) ? MHD_YES : MHD_NO) +#elif defined(MHD_W32_MUTEX_) +/** + * Unlock previously created and locked mutex. + * @param mutex pointer to mutex + * @return #MHD_YES on success, #MHD_NO on failure + */ +#define MHD_mutex_unlock_(mutex) \ + ((NULL != (mutex)) ? (LeaveCriticalSection((mutex)), MHD_YES) : MHD_NO) +#endif + +#endif // MHD_PLATFORM_INTERFACE_H |