/* libc-internal interface for mutex locks. Mach cthreads version. Copyright (C) 1996-2016 Free Software Foundation, Inc. This file is part of the GNU C Library. The GNU C 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. The GNU C 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 the GNU C Library; if not, see . */ #ifndef _LIBC_LOCK_H #define _LIBC_LOCK_H 1 #ifdef _LIBC #include #define __libc_lock_t struct mutex #else typedef struct __libc_lock_opaque__ __libc_lock_t; #endif /* Type for key of thread specific data. */ typedef cthread_key_t __libc_key_t; /* Define a lock variable NAME with storage class CLASS. The lock must be initialized with __libc_lock_init before it can be used (or define it with __libc_lock_define_initialized, below). Use `extern' for CLASS to declare a lock defined in another module. In public structure definitions you must use a pointer to the lock structure (i.e., NAME begins with a `*'), because its storage size will not be known outside of libc. */ #define __libc_lock_define(CLASS,NAME) \ CLASS __libc_lock_t NAME; /* Define an initialized lock variable NAME with storage class CLASS. */ #define __libc_lock_define_initialized(CLASS,NAME) \ CLASS __libc_lock_t NAME = MUTEX_INITIALIZER; /* Initialize the named lock variable, leaving it in a consistent, unlocked state. */ #define __libc_lock_init(NAME) __mutex_init (&(NAME)) /* Finalize the named lock variable, which must be locked. It cannot be used again until __libc_lock_init is called again on it. This must be called on a lock variable before the containing storage is reused. */ #define __libc_lock_fini(NAME) __mutex_unlock (&(NAME)) /* Lock the named lock variable. */ #define __libc_lock_lock(NAME) __mutex_lock (&(NAME)) /* Lock the named lock variable. */ #define __libc_lock_trylock(NAME) (!__mutex_trylock (&(NAME))) /* Unlock the named lock variable. */ #define __libc_lock_unlock(NAME) __mutex_unlock (&(NAME)) /* XXX for now */ #define __libc_rwlock_define __libc_lock_define_recursive #define __libc_rwlock_define_initialized __libc_lock_define_initialized_recursive #define __libc_rwlock_init __libc_lock_init_recursive #define __libc_rwlock_fini __libc_lock_fini_recursive #define __libc_rwlock_rdlock __libc_lock_lock_recursive #define __libc_rwlock_wrlock __libc_lock_lock_recursive #define __libc_rwlock_tryrdlock __libc_lock_trylock_recursive #define __libc_rwlock_trywrlock __libc_lock_trylock_recursive #define __libc_rwlock_unlock __libc_lock_unlock_recursive /* Start a critical region with a cleanup function */ #define __libc_cleanup_region_start(DOIT, FCT, ARG) \ { \ typeof (***(FCT)) *__save_FCT = (DOIT) ? (FCT) : 0; \ typeof (ARG) __save_ARG = ARG; \ /* close brace is in __libc_cleanup_region_end below. */ /* End a critical region started with __libc_cleanup_region_start. */ #define __libc_cleanup_region_end(DOIT) \ if ((DOIT) && __save_FCT != 0) \ (*__save_FCT)(__save_ARG); \ } /* Sometimes we have to exit the block in the middle. */ #define __libc_cleanup_end(DOIT) \ if ((DOIT) && __save_FCT != 0) \ (*__save_FCT)(__save_ARG); \ /* Use mutexes as once control variables. */ struct __libc_once { __libc_lock_t lock; int done; }; #define __libc_once_define(CLASS,NAME) \ CLASS struct __libc_once NAME = { MUTEX_INITIALIZER, 0 } /* Call handler iff the first call. */ #define __libc_once(ONCE_CONTROL, INIT_FUNCTION) \ do { \ __libc_lock_lock (ONCE_CONTROL.lock); \ if (!ONCE_CONTROL.done) \ (INIT_FUNCTION) (); \ ONCE_CONTROL.done = 1; \ __libc_lock_unlock (ONCE_CONTROL.lock); \ } while (0) /* Get once control variable. */ #define __libc_once_get(ONCE_CONTROL) ((ONCE_CONTROL).done != 0) #ifdef _LIBC /* We need portable names for some functions. E.g., when they are used as argument to __libc_cleanup_region_start. */ #define __libc_mutex_unlock __mutex_unlock #endif #define __libc_key_create(KEY,DEST) cthread_keycreate (KEY) #define __libc_setspecific(KEY,VAL) cthread_setspecific (KEY, VAL) void *__libc_getspecific (__libc_key_t key); /* XXX until cthreads supports recursive locks */ #define __libc_lock_define_initialized_recursive __libc_lock_define_initialized #define __libc_lock_init_recursive __libc_lock_init #define __libc_lock_fini_recursive __libc_lock_fini #define __libc_lock_trylock_recursive __libc_lock_trylock #define __libc_lock_unlock_recursive __libc_lock_unlock #define __libc_lock_lock_recursive __libc_lock_lock #define __rtld_lock_define_initialized_recursive __libc_lock_define_initialized #define __rtld_lock_fini_recursive __libc_lock_fini #define __rtld_lock_trylock_recursive __libc_lock_trylock #define __rtld_lock_unlock_recursive __libc_lock_unlock #define __rtld_lock_lock_recursive __libc_lock_lock #endif /* libc-lock.h */