00001 /* ==================================================================== 00002 * The Apache Software License, Version 1.1 00003 * 00004 * Copyright (c) 2000-2003 The Apache Software Foundation. All rights 00005 * reserved. 00006 * 00007 * Redistribution and use in source and binary forms, with or without 00008 * modification, are permitted provided that the following conditions 00009 * are met: 00010 * 00011 * 1. Redistributions of source code must retain the above copyright 00012 * notice, this list of conditions and the following disclaimer. 00013 * 00014 * 2. Redistributions in binary form must reproduce the above copyright 00015 * notice, this list of conditions and the following disclaimer in 00016 * the documentation and/or other materials provided with the 00017 * distribution. 00018 * 00019 * 3. The end-user documentation included with the redistribution, 00020 * if any, must include the following acknowledgment: 00021 * "This product includes software developed by the 00022 * Apache Software Foundation (http://www.apache.org/)." 00023 * Alternately, this acknowledgment may appear in the software itself, 00024 * if and wherever such third-party acknowledgments normally appear. 00025 * 00026 * 4. The names "Apache" and "Apache Software Foundation" must 00027 * not be used to endorse or promote products derived from this 00028 * software without prior written permission. For written 00029 * permission, please contact apache@apache.org. 00030 * 00031 * 5. Products derived from this software may not be called "Apache", 00032 * nor may "Apache" appear in their name, without prior written 00033 * permission of the Apache Software Foundation. 00034 * 00035 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED 00036 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 00037 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 00038 * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR 00039 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 00040 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 00041 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF 00042 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 00043 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 00044 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 00045 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 00046 * SUCH DAMAGE. 00047 * ==================================================================== 00048 * 00049 * This software consists of voluntary contributions made by many 00050 * individuals on behalf of the Apache Software Foundation. For more 00051 * information on the Apache Software Foundation, please see 00052 * <http://www.apache.org/>. 00053 */ 00054 00055 #ifndef APR_GLOBAL_MUTEX_H 00056 #define APR_GLOBAL_MUTEX_H 00057 00063 #include "apr.h" 00064 #include "apr_proc_mutex.h" /* only for apr_lockmech_e */ 00065 #include "apr_pools.h" 00066 #include "apr_errno.h" 00067 #if APR_PROC_MUTEX_IS_GLOBAL 00068 #include "apr_proc_mutex.h" 00069 #endif 00070 00071 #ifdef __cplusplus 00072 extern "C" { 00073 #endif /* __cplusplus */ 00074 00081 #if !APR_PROC_MUTEX_IS_GLOBAL || defined(DOXYGEN) 00082 00084 typedef struct apr_global_mutex_t apr_global_mutex_t; 00085 00086 /* Function definitions */ 00087 00112 APR_DECLARE(apr_status_t) apr_global_mutex_create(apr_global_mutex_t **mutex, 00113 const char *fname, 00114 apr_lockmech_e mech, 00115 apr_pool_t *pool); 00116 00128 APR_DECLARE(apr_status_t) apr_global_mutex_child_init( 00129 apr_global_mutex_t **mutex, 00130 const char *fname, 00131 apr_pool_t *pool); 00132 00138 APR_DECLARE(apr_status_t) apr_global_mutex_lock(apr_global_mutex_t *mutex); 00139 00147 APR_DECLARE(apr_status_t) apr_global_mutex_trylock(apr_global_mutex_t *mutex); 00148 00153 APR_DECLARE(apr_status_t) apr_global_mutex_unlock(apr_global_mutex_t *mutex); 00154 00159 APR_DECLARE(apr_status_t) apr_global_mutex_destroy(apr_global_mutex_t *mutex); 00160 00165 APR_POOL_DECLARE_ACCESSOR(global_mutex); 00166 00167 #else /* APR_PROC_MUTEX_IS_GLOBAL */ 00168 00169 /* Some platforms [e.g. Win32] have cross process locks that are truly 00170 * global locks, since there isn't the concept of cross-process locks. 00171 * Define these platforms in terms of an apr_proc_mutex_t. 00172 */ 00173 00174 #define apr_global_mutex_t apr_proc_mutex_t 00175 #define apr_global_mutex_create apr_proc_mutex_create 00176 #define apr_global_mutex_child_init apr_proc_mutex_child_init 00177 #define apr_global_mutex_lock apr_proc_mutex_lock 00178 #define apr_global_mutex_trylock apr_proc_mutex_trylock 00179 #define apr_global_mutex_unlock apr_proc_mutex_unlock 00180 #define apr_global_mutex_destroy apr_proc_mutex_destroy 00181 #define apr_global_mutex_pool_get apr_proc_mutex_pool_get 00182 00183 #endif 00184 00187 #ifdef __cplusplus 00188 } 00189 #endif 00190 00191 #endif /* ndef APR_GLOBAL_MUTEX_H */