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 
9 #pragma once
10 
19 #include "priority_queue.h"
20 #include "thread.h"
21 
22 #include <errno.h>
23 #include <stdbool.h>
24 
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
36 typedef struct
37 {
45  int readers;
46 
51 
57 
61 typedef struct {
62  bool is_writer;
65  bool continue_;
67 
77 
90 
99 
109 
118 int pthread_rwlock_timedrdlock(pthread_rwlock_t *rwlock, const struct timespec *abstime);
119 
128 
138 
147 int pthread_rwlock_timedwrlock(pthread_rwlock_t *rwlock, const struct timespec *abstime);
148 
159 
166 
173 
174 #ifdef __cplusplus
175 }
176 #endif
177 
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:170
Mutex structure.
Definition: mutex.h:39
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.