pthread_rwlock.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2014 RenĂ© Kijewski <rene.kijewski@fu-berlin.de>
3  *
4  * This file is subject to the terms and conditions of the GNU Lesser
5  * General Public License v2.1. See the file LICENSE in the top level
6  * directory for more details.
7  */
8 
17 #ifndef PTHREAD_RWLOCK_H
18 #define PTHREAD_RWLOCK_H
19 
20 #include "priority_queue.h"
21 #include "thread.h"
22 
23 #include <errno.h>
24 #include <stdbool.h>
25 
26 #ifdef __cplusplus
27 extern "C" {
28 #endif
29 
37 typedef struct
38 {
46  int readers;
47 
52 
58 
62 typedef struct {
63  bool is_writer;
66  bool continue_;
68 
78 
91 
100 
110 
119 int pthread_rwlock_timedrdlock(pthread_rwlock_t *rwlock, const struct timespec *abstime);
120 
129 
139 
148 int pthread_rwlock_timedwrlock(pthread_rwlock_t *rwlock, const struct timespec *abstime);
149 
160 
167 
174 
175 #ifdef __cplusplus
176 }
177 #endif
178 
179 #endif /* PTHREAD_RWLOCK_H */
180 
A simple priority queue.
int pthread_rwlock_trywrlock(pthread_rwlock_t *rwlock)
Try to lock a reader/writer lock for writing.
int pthread_rwlock_init(pthread_rwlock_t *rwlock, const pthread_rwlockattr_t *attr)
Initialize a reader/writer lock.
int pthread_rwlock_timedwrlock(pthread_rwlock_t *rwlock, const struct timespec *abstime)
Try to acquire a write lock in a given timeframe.
int pthread_rwlock_wrlock(pthread_rwlock_t *rwlock)
Lock a reader/writer lock for writing.
int pthread_rwlock_destroy(pthread_rwlock_t *rwlock)
Destroy a reader/writer lock.
int pthread_rwlock_unlock(pthread_rwlock_t *rwlock)
Unlock the reader/writer lock.
bool __pthread_rwlock_blocked_readingly(const pthread_rwlock_t *rwlock)
Internal function to determine of the lock can be acquired for reading.
int pthread_rwlock_tryrdlock(pthread_rwlock_t *rwlock)
Try to lock a reader/writer lock for reader.
bool __pthread_rwlock_blocked_writingly(const pthread_rwlock_t *rwlock)
Internal function to determine of the lock can be acquired for writing.
int pthread_rwlock_rdlock(pthread_rwlock_t *rwlock)
Lock a reader/writer lock for reading.
int pthread_rwlock_timedrdlock(pthread_rwlock_t *rwlock, const struct timespec *abstime)
Try to acquire a read lock in a given timeframe.
Internal structure that stores one waiting thread.
thread_t * thread
waiting thread
bool is_writer
false: reader; true: writer
priority_queue_node_t qnode
Node to store in pthread_rwlock_t::queue.
bool continue_
This is not a spurious wakeup.
thread_t holds thread's context data.
Definition: thread.h:168
Mutex structure.
Definition: mutex.h:146
data type for priority queue nodes
data type for priority queues
A fair reader writer lock.
int readers
The current amount of reader inside the critical section.
mutex_t mutex
Provides mutual exclusion on reading and writing on the structure.
priority_queue_t queue
Queue of waiting threads.
Attributes for a new reader/writer lock.