os/ossrv/genericopenlibs/openenvcore/libc/include/reentrant.h
author sl
Tue, 10 Jun 2014 14:32:02 +0200
changeset 1 260cb5ec6c19
permissions -rw-r--r--
Update contrib.
     1 /*-
     2  * Copyright (c) 1997,98 The NetBSD Foundation, Inc.
     3  * All rights reserved.
     4  *
     5  * This code is derived from software contributed to The NetBSD Foundation
     6  * by J.T. Conklin.
     7  *
     8  * Redistribution and use in source and binary forms, with or without
     9  * modification, are permitted provided that the following conditions
    10  * are met:
    11  * 1. Redistributions of source code must retain the above copyright
    12  *    notice, this list of conditions and the following disclaimer.
    13  * 2. Redistributions in binary form must reproduce the above copyright
    14  *    notice, this list of conditions and the following disclaimer in the
    15  *    documentation and/or other materials provided with the distribution.
    16  * 4. Neither the name of The NetBSD Foundation nor the names of its
    17  *    contributors may be used to endorse or promote products derived
    18  *    from this software without specific prior written permission.
    19  *
    20  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
    21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
    22  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    23  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
    24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
    25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
    26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
    27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
    28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
    29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
    30  * POSSIBILITY OF SUCH DAMAGE.
    31  *
    32  * $FreeBSD: src/lib/libc/include/reentrant.h,v 1.3 2004/02/25 21:03:45 green Exp $
    33  */
    34 
    35 /*
    36  * Requirements:
    37  * 
    38  * 1. The thread safe mechanism should be lightweight so the library can
    39  *    be used by non-threaded applications without unreasonable overhead.
    40  * 
    41  * 2. There should be no dependency on a thread engine for non-threaded
    42  *    applications.
    43  * 
    44  * 3. There should be no dependency on any particular thread engine.
    45  * 
    46  * 4. The library should be able to be compiled without support for thread
    47  *    safety.
    48  * 
    49  * 
    50  * Rationale:
    51  * 
    52  * One approach for thread safety is to provide discrete versions of the
    53  * library: one thread safe, the other not.  The disadvantage of this is
    54  * that libc is rather large, and two copies of a library which are 99%+
    55  * identical is not an efficent use of resources.
    56  * 
    57  * Another approach is to provide a single thread safe library.  However,
    58  * it should not add significant run time or code size overhead to non-
    59  * threaded applications.
    60  * 
    61  * Since the NetBSD C library is used in other projects, it should be
    62  * easy to replace the mutual exclusion primitives with ones provided by
    63  * another system.  Similarly, it should also be easy to remove all
    64  * support for thread safety completely if the target environment does
    65  * not support threads.
    66  * 
    67  * 
    68  * Implementation Details:
    69  * 
    70  * The mutex primitives used by the library (mutex_t, mutex_lock, etc.)
    71  * are macros which expand to the cooresponding primitives provided by
    72  * the thread engine or to nothing.  The latter is used so that code is
    73  * not unreasonably cluttered with #ifdefs when all thread safe support
    74  * is removed.
    75  * 
    76  * The mutex macros can be directly mapped to the mutex primitives from
    77  * pthreads, however it should be reasonably easy to wrap another mutex
    78  * implementation so it presents a similar interface.
    79  * 
    80  * Stub implementations of the mutex functions are provided with *weak*
    81  * linkage.  These functions simply return success.  When linked with a
    82  * thread library (i.e. -lpthread), the functions will override the
    83  * stubs.
    84  */
    85 
    86 #include <pthread.h>
    87 #ifndef __SYMBIAN32__
    88 #include <pthread_np.h>
    89 #endif
    90 #include "libc_private.h"
    91 
    92 #define mutex_t			pthread_mutex_t
    93 #define cond_t			pthread_cond_t
    94 #define rwlock_t		pthread_rwlock_t
    95 #define once_t			pthread_once_t
    96 
    97 #define thread_key_t		pthread_key_t
    98 #define MUTEX_INITIALIZER	PTHREAD_MUTEX_INITIALIZER
    99 #define RWLOCK_INITIALIZER	PTHREAD_RWLOCK_INITIALIZER
   100 #define ONCE_INITIALIZER	PTHREAD_ONCE_INIT
   101 
   102 #define mutex_init(m, a)	_pthread_mutex_init(m, a)
   103 #define mutex_lock(m)		if (__isthreaded) \
   104 				_pthread_mutex_lock(m)
   105 #define mutex_unlock(m)		if (__isthreaded) \
   106 				_pthread_mutex_unlock(m)
   107 #define mutex_trylock(m)	(__isthreaded ? 0 : _pthread_mutex_trylock(m))
   108 
   109 #define cond_init(c, a, p)	_pthread_cond_init(c, a)
   110 #define cond_signal(m)		if (__isthreaded) \
   111 				_pthread_cond_signal(m)
   112 #define cond_broadcast(m)	if (__isthreaded) \
   113 				_pthread_cond_broadcast(m)
   114 #define cond_wait(c, m)		if (__isthreaded) \
   115 				_pthread_cond_wait(c, m)
   116 
   117 #define rwlock_init(l, a)	_pthread_rwlock_init(l, a)
   118 #define rwlock_rdlock(l)	if (__isthreaded) \
   119 				_pthread_rwlock_rdlock(l)
   120 #define rwlock_wrlock(l)	if (__isthreaded) \
   121 				_pthread_rwlock_wrlock(l)
   122 #define rwlock_unlock(l)	if (__isthreaded) \
   123 				_pthread_rwlock_unlock(l)
   124 
   125 #define thr_keycreate(k, d)	_pthread_key_create(k, d)
   126 #define thr_setspecific(k, p)	_pthread_setspecific(k, p)
   127 #define thr_getspecific(k)	_pthread_getspecific(k)
   128 #define thr_sigsetmask(f, n, o)	_pthread_sigmask(f, n, o)
   129 
   130 #define thr_once(o, i)		_pthread_once(o, i)
   131 #define thr_self()		_pthread_self()
   132 #define thr_exit(x)		_pthread_exit(x)
   133 #define thr_main()		_pthread_main_np()