Blame view
include/linux/rwsem.h
2.57 KB
1da177e4c
|
1 2 3 4 5 6 7 8 9 10 |
/* rwsem.h: R/W semaphores, public interface * * Written by David Howells (dhowells@redhat.com). * Derived from asm-i386/semaphore.h */ #ifndef _LINUX_RWSEM_H #define _LINUX_RWSEM_H #include <linux/linkage.h> |
1da177e4c
|
11 |
#ifdef __KERNEL__ |
1da177e4c
|
12 13 14 15 16 17 18 19 20 21 22 23 |
#include <linux/types.h> #include <linux/kernel.h> #include <asm/system.h> #include <asm/atomic.h> struct rw_semaphore; #ifdef CONFIG_RWSEM_GENERIC_SPINLOCK #include <linux/rwsem-spinlock.h> /* use a generic implementation */ #else #include <asm/rwsem.h> /* use an arch-specific implementation */ #endif |
1da177e4c
|
24 25 26 |
/* * lock for reading */ |
4ea2176df
|
27 |
extern void down_read(struct rw_semaphore *sem); |
1da177e4c
|
28 29 30 31 |
/* * trylock for reading -- returns 1 if successful, 0 if contention */ |
4ea2176df
|
32 |
extern int down_read_trylock(struct rw_semaphore *sem); |
1da177e4c
|
33 34 35 36 |
/* * lock for writing */ |
4ea2176df
|
37 |
extern void down_write(struct rw_semaphore *sem); |
1da177e4c
|
38 39 40 41 |
/* * trylock for writing -- returns 1 if successful, 0 if contention */ |
4ea2176df
|
42 |
extern int down_write_trylock(struct rw_semaphore *sem); |
1da177e4c
|
43 44 45 46 |
/* * release a read lock */ |
4ea2176df
|
47 |
extern void up_read(struct rw_semaphore *sem); |
1da177e4c
|
48 49 50 51 |
/* * release a write lock */ |
4ea2176df
|
52 |
extern void up_write(struct rw_semaphore *sem); |
1da177e4c
|
53 54 55 56 |
/* * downgrade write lock to read lock */ |
4ea2176df
|
57 58 59 60 |
extern void downgrade_write(struct rw_semaphore *sem); #ifdef CONFIG_DEBUG_LOCK_ALLOC /* |
5fca80e8b
|
61 62 63 64 65 66 67 68 69 70 71 |
* nested locking. NOTE: rwsems are not allowed to recurse * (which occurs if the same task tries to acquire the same * lock instance multiple times), but multiple locks of the * same lock class might be taken, if the order of the locks * is always the same. This ordering rule can be expressed * to lockdep via the _nested() APIs, but enumerating the * subclasses that are used. (If the nesting relationship is * static then another method for expressing nested locking is * the explicit definition of lock class keys and the use of * lockdep_set_class() at lock initialization time. * See Documentation/lockdep-design.txt for more details.) |
4ea2176df
|
72 73 74 75 |
*/ extern void down_read_nested(struct rw_semaphore *sem, int subclass); extern void down_write_nested(struct rw_semaphore *sem, int subclass); /* |
5fca80e8b
|
76 77 78 79 |
* Take/release a lock when not the owner will release it. * * [ This API should be avoided as much as possible - the * proper abstraction for this case is completions. ] |
4ea2176df
|
80 81 82 83 84 85 86 87 88 |
*/ extern void down_read_non_owner(struct rw_semaphore *sem); extern void up_read_non_owner(struct rw_semaphore *sem); #else # define down_read_nested(sem, subclass) down_read(sem) # define down_write_nested(sem, subclass) down_write(sem) # define down_read_non_owner(sem) down_read(sem) # define up_read_non_owner(sem) up_read(sem) #endif |
1da177e4c
|
89 90 91 |
#endif /* __KERNEL__ */ #endif /* _LINUX_RWSEM_H */ |