(__libc_cleanup_end): New definition.
[kopensolaris-gnu/glibc.git] / bits / libc-lock.h
1 /* libc-internal interface for mutex locks.  Stub version.
2    Copyright (C) 1996, 1997, 1999 Free Software Foundation, Inc.
3    This file is part of the GNU C Library.
4
5    The GNU C Library is free software; you can redistribute it and/or
6    modify it under the terms of the GNU Library General Public License as
7    published by the Free Software Foundation; either version 2 of the
8    License, or (at your option) any later version.
9
10    The GNU C Library is distributed in the hope that it will be useful,
11    but WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13    Library General Public License for more details.
14
15    You should have received a copy of the GNU Library General Public
16    License along with the GNU C Library; see the file COPYING.LIB.  If not,
17    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18    Boston, MA 02111-1307, USA.  */
19
20 #ifndef _BITS_LIBC_LOCK_H
21 #define _BITS_LIBC_LOCK_H 1
22
23
24 /* Define a lock variable NAME with storage class CLASS.  The lock must be
25    initialized with __libc_lock_init before it can be used (or define it
26    with __libc_lock_define_initialized, below).  Use `extern' for CLASS to
27    declare a lock defined in another module.  In public structure
28    definitions you must use a pointer to the lock structure (i.e., NAME
29    begins with a `*'), because its storage size will not be known outside
30    of libc.  */
31 #define __libc_lock_define(CLASS,NAME)
32
33 /* Define an initialized lock variable NAME with storage class CLASS.  */
34 #define __libc_lock_define_initialized(CLASS,NAME)
35
36 /* Define an initialized recursive lock variable NAME with storage
37    class CLASS.  */
38 #define __libc_lock_define_initialized_recursive(CLASS,NAME)
39
40 /* Initialize the named lock variable, leaving it in a consistent, unlocked
41    state.  */
42 #define __libc_lock_init(NAME)
43
44 /* Same as last but this time we initialize a recursive mutex.  */
45 #define __libc_lock_init_recursive(NAME)
46
47 /* Finalize the named lock variable, which must be locked.  It cannot be
48    used again until __libc_lock_init is called again on it.  This must be
49    called on a lock variable before the containing storage is reused.  */
50 #define __libc_lock_fini(NAME)
51
52 /* Finalize recursive named lock.  */
53 #define __libc_lock_fini_recursive(NAME)
54
55 /* Lock the named lock variable.  */
56 #define __libc_lock_lock(NAME)
57
58 /* Lock the recursive named lock variable.  */
59 #define __libc_lock_lock_recursive(NAME)
60
61 /* Try to lock the named lock variable.  */
62 #define __libc_lock_trylock(NAME) 0
63
64 /* Try to lock the recursive named lock variable.  */
65 #define __libc_lock_trylock_recursive(NAME) 0
66
67 /* Unlock the named lock variable.  */
68 #define __libc_lock_unlock(NAME)
69
70 /* Unlock the recursive named lock variable.  */
71 #define __libc_lock_unlock_recursive(NAME)
72
73
74 /* Define once control variable.  */
75 #define __libc_once_define(CLASS, NAME) CLASS int NAME = 0
76
77 /* Call handler iff the first call.  */
78 #define __libc_once(ONCE_CONTROL, INIT_FUNCTION) \
79   do {                                                                        \
80     if ((ONCE_CONTROL) == 0) {                                                \
81       INIT_FUNCTION ();                                                       \
82       (ONCE_CONTROL) = 1;                                                     \
83     }                                                                         \
84   } while (0)
85
86
87 /* Start critical region with cleanup.  */
88 #define __libc_cleanup_region_start(FCT, ARG)
89
90 /* End critical region with cleanup.  */
91 #define __libc_cleanup_region_end(DOIT)
92
93 /* Sometimes we have to exit the block in the middle.  */
94 #define __libc_cleanup_end(DOIT)
95
96
97 /* We need portable names for some of the functions.  */
98 #define __libc_mutex_unlock
99
100 /* Type for key of thread specific data.  */
101 typedef int __libc_key_t;
102
103 /* Create key for thread specific data.  */
104 #define __libc_key_create(KEY,DEST) -1
105
106 /* Set thread-specific data associated with KEY to VAL.  */
107 #define __libc_setspecific(KEY,VAL) -1
108
109 /* Get thread-specific data associated with KEY.  */
110 #define __libc_getspecific(KEY) 0
111
112 #endif  /* bits/libc-lock.h */