/* EINA - EFL data type library * Copyright (C) 2008 Cedric Bail * * 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 . */ #ifdef HAVE_CONFIG_H # include "config.h" #endif #include #ifdef EFL_HAVE_POSIX_THREADS # include #endif #ifdef EFL_HAVE_WIN32_THREADS # define WIN32_LEAN_AND_MEAN # include # undef WIN32_LEAN_AND_MEAN #endif #include "eina_config.h" #include "eina_private.h" #include "eina_types.h" #include "eina_main.h" #include "eina_error.h" #include "eina_log.h" #include "eina_hash.h" #include "eina_binshare.h" #include "eina_stringshare.h" #include "eina_ustringshare.h" #include "eina_list.h" #include "eina_matrixsparse.h" #include "eina_array.h" #include "eina_counter.h" #include "eina_benchmark.h" #include "eina_magic.h" #include "eina_rectangle.h" #include "eina_safety_checks.h" /*============================================================================* * Local * *============================================================================*/ /** * @cond LOCAL */ static Eina_Version _version = { VMAJ, VMIN, VMIC, VREV }; static int _eina_main_count = 0; #ifdef EFL_HAVE_THREADS static int _eina_main_thread_count = 0; #endif static int _eina_log_dom = -1; #ifdef ERR #undef ERR #endif #define ERR(...) EINA_LOG_DOM_ERR(_eina_log_dom, __VA_ARGS__) #ifdef DBG #undef DBG #endif #define DBG(...) EINA_LOG_DOM_DBG(_eina_log_dom, __VA_ARGS__) Eina_Bool _threads_activated = EINA_FALSE; #ifdef EFL_HAVE_THREADS # ifdef EFL_HAVE_POSIX_THREADS static pthread_mutex_t _mutex = PTHREAD_MUTEX_INITIALIZER; # define LOCK() if(_threads_activated) pthread_mutex_lock(&_mutex) # define UNLOCK() if(_threads_activated) pthread_mutex_unlock(&_mutex) # define UNLOCK_FORCE() pthread_mutex_unlock(&_mutex) # else /* EFL_HAVE_WIN32_THREADS */ static HANDLE _mutex = NULL; # define LOCK() if(_threads_activated) WaitForSingleObject(_mutex, INFINITE) # define UNLOCK() if(_threads_activated) ReleaseMutex(_mutex) # define UNLOCK_FORCE() ReleaseMutex(_mutex) # endif #else # define LOCK() do {} while (0) # define UNLOCK() do {} while (0) # define UNLOCK_FORCE() do {} while (0) #endif /* place module init/shutdown functions here to avoid other modules * calling them by mistake. */ #define S(x) extern Eina_Bool eina_ ## x ## _init(void); \ extern Eina_Bool eina_ ## x ## _shutdown(void) S(log); S(error); S(safety_checks); S(magic_string); S(iterator); S(accessor); S(array); S(module); S(mempool); S(list); S(binshare); S(stringshare); S(ustringshare); S(matrixsparse); S(convert); S(counter); S(benchmark); S(rectangle); S(strbuf); S(ustrbuf); S(quadtree); #undef S struct eina_desc_setup { const char *name; Eina_Bool (*init)(void); Eina_Bool (*shutdown)(void); }; static const struct eina_desc_setup _eina_desc_setup[] = { #define S(x) {# x, eina_ ## x ## _init, eina_ ## x ## _shutdown} /* log is a special case as it needs printf */ S(error), S(safety_checks), S(magic_string), S(iterator), S(accessor), S(array), S(module), S(mempool), S(list), S(binshare), S(stringshare), S(ustringshare), S(matrixsparse), S(convert), S(counter), S(benchmark), S(rectangle), S(strbuf), S(ustrbuf), S(quadtree) #undef S }; static const size_t _eina_desc_setup_len = sizeof(_eina_desc_setup) / sizeof(_eina_desc_setup[0]); static void _eina_shutdown_from_desc(const struct eina_desc_setup *itr) { for (itr--; itr >= _eina_desc_setup; itr--) { if (!itr->shutdown()) ERR("Problems shutting down eina module '%s', ignored.", itr->name); } eina_log_domain_unregister(_eina_log_dom); _eina_log_dom = -1; eina_log_shutdown(); } /** * @endcond */ /*============================================================================* * Global * *============================================================================*/ /*============================================================================* * API * *============================================================================*/ /** * @addtogroup Eina_Main_Group Main * * @brief These functions provide general initialisation and shut down * functions. * * @{ */ /** * @var eina_version * @brief Eina version (defined at configuration time) */ EAPI Eina_Version *eina_version = &_version; /** * @brief Initialize the Eina library. * * @return 1 or greater on success, 0 on error. * * This function sets up all the eina modules. It returns 0 on * failure (that is, when one of the module fails to initialize), * otherwise it returns the number of times it has already been * called. * * When Eina is not used anymore, call eina_shutdown() to shut down * the Eina library. */ EAPI int eina_init(void) { const struct eina_desc_setup *itr, *itr_end; if (EINA_LIKELY(_eina_main_count > 0)) return ++_eina_main_count; if (!eina_log_init()) { fprintf(stderr, "Could not initialize eina logging system.\n"); return 0; } _eina_log_dom = eina_log_domain_register("eina", EINA_LOG_COLOR_DEFAULT); if (_eina_log_dom < 0) { EINA_LOG_ERR("Could not register log domain: eina"); eina_log_shutdown(); return 0; } itr = _eina_desc_setup; itr_end = itr + _eina_desc_setup_len; for (; itr < itr_end; itr++) { if (!itr->init()) { ERR("Could not initialize eina module '%s'.", itr->name); _eina_shutdown_from_desc(itr); return 0; } } _eina_main_count = 1; return 1; } /** * @brief Shut down the Eina library. * * @return 0 when all the modules is completely shut down, 1 or * greater otherwise. * * This function shuts down the Eina library. It returns 0 when it has * been called the same number of times than eina_init(). In that case * it shut down all the Eina modules. * * Once this function succeeds (that is, @c 0 is returned), you must * not call any of the Eina function anymore. You must call * eina_init() again to use the Eina functions again. */ EAPI int eina_shutdown(void) { _eina_main_count--; if (EINA_UNLIKELY(_eina_main_count == 0)) _eina_shutdown_from_desc(_eina_desc_setup + _eina_desc_setup_len); return _eina_main_count; } /** * @brief Initialize the mutexes of the Eina library. * * @return 1 or greater on success, 0 on error. * * This function sets up all the mutexes in all eina modules. It returns 0 on * failure (that is, when one of the module fails to initialize), * otherwise it returns the number of times it has already been * called. * * When the mutexes are not used anymore, call eina_threads_shutdown() to shut down * the mutexes. */ EAPI int eina_threads_init(void) { #ifdef EFL_HAVE_THREADS int ret; # ifdef EFL_HAVE_WIN32_THREADS if (!_mutex) _mutex = CreateMutex(NULL, FALSE, NULL); if (!_mutex) return 0; # endif LOCK(); ++_eina_main_thread_count; ret = _eina_main_thread_count; if(_eina_main_thread_count > 1) { UNLOCK(); return ret; } eina_share_common_threads_init(); eina_log_threads_init(); _threads_activated = EINA_TRUE; return ret; #else return 0; #endif } /** * @brief Shut down mutexes in the Eina library. * * @return 0 when all mutexes are completely shut down, 1 or * greater otherwise. * * This function shuts down the mutexes in the Eina library. It returns 0 when it has * been called the same number of times than eina_threads_init(). In that case * it shut down all the mutexes. * * Once this function succeeds (that is, @c 0 is returned), you must * not call any of the Eina function in a thread anymore. You must call * eina_threads_init() again to use the Eina functions in a thread again. */ EAPI int eina_threads_shutdown(void) { #ifdef EFL_HAVE_THREADS int ret; LOCK(); ret = --_eina_main_thread_count; if(_eina_main_thread_count > 0) { UNLOCK(); return ret; } eina_share_common_threads_shutdown(); eina_log_threads_shutdown(); _threads_activated = EINA_FALSE; UNLOCK_FORCE(); # ifdef EFL_HAVE_WIN32_THREADS if (_mutex) CloseHandle(_mutex); # endif return ret; #else return 0; #endif } /** * @} */