Commit | Line | Data |
---|---|---|
e311edbc | 1 | /* SPDX-License-Identifier: GPL-2.0-only */ |
9a19fea4 | 2 | /* |
3 | * klist.h - Some generic list helpers, extending struct list_head a bit. | |
4 | * | |
5 | * Implementations are found in lib/klist.c | |
6 | * | |
9a19fea4 | 7 | * Copyright (C) 2005 Patrick Mochel |
9a19fea4 | 8 | */ |
9 | ||
d856f1e3 JB |
10 | #ifndef _LINUX_KLIST_H |
11 | #define _LINUX_KLIST_H | |
12 | ||
9a19fea4 | 13 | #include <linux/spinlock.h> |
9a19fea4 | 14 | #include <linux/kref.h> |
15 | #include <linux/list.h> | |
16 | ||
34bb61f9 | 17 | struct klist_node; |
9a19fea4 | 18 | struct klist { |
19 | spinlock_t k_lock; | |
20 | struct list_head k_list; | |
34bb61f9 JB |
21 | void (*get)(struct klist_node *); |
22 | void (*put)(struct klist_node *); | |
795abaf1 | 23 | } __attribute__ ((aligned (sizeof(void *)))); |
9a19fea4 | 24 | |
1da43e4a TH |
25 | #define KLIST_INIT(_name, _get, _put) \ |
26 | { .k_lock = __SPIN_LOCK_UNLOCKED(_name.k_lock), \ | |
27 | .k_list = LIST_HEAD_INIT(_name.k_list), \ | |
28 | .get = _get, \ | |
29 | .put = _put, } | |
30 | ||
31 | #define DEFINE_KLIST(_name, _get, _put) \ | |
32 | struct klist _name = KLIST_INIT(_name, _get, _put) | |
9a19fea4 | 33 | |
c3bb7fad | 34 | extern void klist_init(struct klist *k, void (*get)(struct klist_node *), |
34bb61f9 | 35 | void (*put)(struct klist_node *)); |
9a19fea4 | 36 | |
37 | struct klist_node { | |
a1ed5b0c | 38 | void *n_klist; /* never access directly */ |
9a19fea4 | 39 | struct list_head n_node; |
40 | struct kref n_ref; | |
9a19fea4 | 41 | }; |
42 | ||
c3bb7fad GKH |
43 | extern void klist_add_tail(struct klist_node *n, struct klist *k); |
44 | extern void klist_add_head(struct klist_node *n, struct klist *k); | |
0f9859ca | 45 | extern void klist_add_behind(struct klist_node *n, struct klist_node *pos); |
93dd4001 | 46 | extern void klist_add_before(struct klist_node *n, struct klist_node *pos); |
9a19fea4 | 47 | |
c3bb7fad GKH |
48 | extern void klist_del(struct klist_node *n); |
49 | extern void klist_remove(struct klist_node *n); | |
9a19fea4 | 50 | |
c3bb7fad | 51 | extern int klist_node_attached(struct klist_node *n); |
8b0c250b | 52 | |
9a19fea4 | 53 | |
54 | struct klist_iter { | |
c3bb7fad | 55 | struct klist *i_klist; |
c3bb7fad | 56 | struct klist_node *i_cur; |
9a19fea4 | 57 | }; |
58 | ||
59 | ||
c3bb7fad GKH |
60 | extern void klist_iter_init(struct klist *k, struct klist_iter *i); |
61 | extern void klist_iter_init_node(struct klist *k, struct klist_iter *i, | |
62 | struct klist_node *n); | |
63 | extern void klist_iter_exit(struct klist_iter *i); | |
2e0fed7f | 64 | extern struct klist_node *klist_prev(struct klist_iter *i); |
c3bb7fad | 65 | extern struct klist_node *klist_next(struct klist_iter *i); |
9a19fea4 | 66 | |
d856f1e3 | 67 | #endif |