/* 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