Commit c3bb7fadaf52de3637b834002dac27f6250b4b49

Authored by Greg Kroah-Hartman
1 parent c3b19ff06e

klist: fix coding style errors in klist.h and klist.c

Finally clean up the odd spacing in these files.

Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>

Showing 2 changed files with 100 additions and 136 deletions Side-by-side Diff

include/linux/klist.h
... ... @@ -34,39 +34,39 @@
34 34 #define DEFINE_KLIST(_name, _get, _put) \
35 35 struct klist _name = KLIST_INIT(_name, _get, _put)
36 36  
37   -extern void klist_init(struct klist * k, void (*get)(struct klist_node *),
  37 +extern void klist_init(struct klist *k, void (*get)(struct klist_node *),
38 38 void (*put)(struct klist_node *));
39 39  
40 40 struct klist_node {
41   - struct klist * n_klist;
  41 + struct klist *n_klist;
42 42 struct list_head n_node;
43 43 struct kref n_ref;
44 44 struct completion n_removed;
45 45 };
46 46  
47   -extern void klist_add_tail(struct klist_node * n, struct klist * k);
48   -extern void klist_add_head(struct klist_node * n, struct klist * k);
  47 +extern void klist_add_tail(struct klist_node *n, struct klist *k);
  48 +extern void klist_add_head(struct klist_node *n, struct klist *k);
49 49 extern void klist_add_after(struct klist_node *n, struct klist_node *pos);
50 50 extern void klist_add_before(struct klist_node *n, struct klist_node *pos);
51 51  
52   -extern void klist_del(struct klist_node * n);
53   -extern void klist_remove(struct klist_node * n);
  52 +extern void klist_del(struct klist_node *n);
  53 +extern void klist_remove(struct klist_node *n);
54 54  
55   -extern int klist_node_attached(struct klist_node * n);
  55 +extern int klist_node_attached(struct klist_node *n);
56 56  
57 57  
58 58 struct klist_iter {
59   - struct klist * i_klist;
60   - struct list_head * i_head;
61   - struct klist_node * i_cur;
  59 + struct klist *i_klist;
  60 + struct list_head *i_head;
  61 + struct klist_node *i_cur;
62 62 };
63 63  
64 64  
65   -extern void klist_iter_init(struct klist * k, struct klist_iter * i);
66   -extern void klist_iter_init_node(struct klist * k, struct klist_iter * i,
67   - struct klist_node * n);
68   -extern void klist_iter_exit(struct klist_iter * i);
69   -extern struct klist_node * klist_next(struct klist_iter * i);
  65 +extern void klist_iter_init(struct klist *k, struct klist_iter *i);
  66 +extern void klist_iter_init_node(struct klist *k, struct klist_iter *i,
  67 + struct klist_node *n);
  68 +extern void klist_iter_exit(struct klist_iter *i);
  69 +extern struct klist_node *klist_next(struct klist_iter *i);
70 70  
71 71 #endif
1 1 /*
2   - * klist.c - Routines for manipulating klists.
  2 + * klist.c - Routines for manipulating klists.
3 3 *
  4 + * Copyright (C) 2005 Patrick Mochel
4 5 *
5   - * This klist interface provides a couple of structures that wrap around
6   - * struct list_head to provide explicit list "head" (struct klist) and
7   - * list "node" (struct klist_node) objects. For struct klist, a spinlock
8   - * is included that protects access to the actual list itself. struct
9   - * klist_node provides a pointer to the klist that owns it and a kref
10   - * reference count that indicates the number of current users of that node
11   - * in the list.
  6 + * This file is released under the GPL v2.
12 7 *
13   - * The entire point is to provide an interface for iterating over a list
14   - * that is safe and allows for modification of the list during the
15   - * iteration (e.g. insertion and removal), including modification of the
16   - * current node on the list.
  8 + * This klist interface provides a couple of structures that wrap around
  9 + * struct list_head to provide explicit list "head" (struct klist) and list
  10 + * "node" (struct klist_node) objects. For struct klist, a spinlock is
  11 + * included that protects access to the actual list itself. struct
  12 + * klist_node provides a pointer to the klist that owns it and a kref
  13 + * reference count that indicates the number of current users of that node
  14 + * in the list.
17 15 *
18   - * It works using a 3rd object type - struct klist_iter - that is declared
19   - * and initialized before an iteration. klist_next() is used to acquire the
20   - * next element in the list. It returns NULL if there are no more items.
21   - * Internally, that routine takes the klist's lock, decrements the reference
22   - * count of the previous klist_node and increments the count of the next
23   - * klist_node. It then drops the lock and returns.
  16 + * The entire point is to provide an interface for iterating over a list
  17 + * that is safe and allows for modification of the list during the
  18 + * iteration (e.g. insertion and removal), including modification of the
  19 + * current node on the list.
24 20 *
25   - * There are primitives for adding and removing nodes to/from a klist.
26   - * When deleting, klist_del() will simply decrement the reference count.
27   - * Only when the count goes to 0 is the node removed from the list.
28   - * klist_remove() will try to delete the node from the list and block
29   - * until it is actually removed. This is useful for objects (like devices)
30   - * that have been removed from the system and must be freed (but must wait
31   - * until all accessors have finished).
  21 + * It works using a 3rd object type - struct klist_iter - that is declared
  22 + * and initialized before an iteration. klist_next() is used to acquire the
  23 + * next element in the list. It returns NULL if there are no more items.
  24 + * Internally, that routine takes the klist's lock, decrements the
  25 + * reference count of the previous klist_node and increments the count of
  26 + * the next klist_node. It then drops the lock and returns.
32 27 *
33   - * Copyright (C) 2005 Patrick Mochel
34   - *
35   - * This file is released under the GPL v2.
  28 + * There are primitives for adding and removing nodes to/from a klist.
  29 + * When deleting, klist_del() will simply decrement the reference count.
  30 + * Only when the count goes to 0 is the node removed from the list.
  31 + * klist_remove() will try to delete the node from the list and block until
  32 + * it is actually removed. This is useful for objects (like devices) that
  33 + * have been removed from the system and must be freed (but must wait until
  34 + * all accessors have finished).
36 35 */
37 36  
38 37 #include <linux/klist.h>
... ... @@ -40,10 +39,10 @@
40 39  
41 40  
42 41 /**
43   - * klist_init - Initialize a klist structure.
44   - * @k: The klist we're initializing.
45   - * @get: The get function for the embedding object (NULL if none)
46   - * @put: The put function for the embedding object (NULL if none)
  42 + * klist_init - Initialize a klist structure.
  43 + * @k: The klist we're initializing.
  44 + * @get: The get function for the embedding object (NULL if none)
  45 + * @put: The put function for the embedding object (NULL if none)
47 46 *
48 47 * Initialises the klist structure. If the klist_node structures are
49 48 * going to be embedded in refcounted objects (necessary for safe
... ... @@ -51,8 +50,7 @@
51 50 * functions that take and release references on the embedding
52 51 * objects.
53 52 */
54   -
55   -void klist_init(struct klist * k, void (*get)(struct klist_node *),
  53 +void klist_init(struct klist *k, void (*get)(struct klist_node *),
56 54 void (*put)(struct klist_node *))
57 55 {
58 56 INIT_LIST_HEAD(&k->k_list);
59 57  
60 58  
61 59  
... ... @@ -60,26 +58,23 @@
60 58 k->get = get;
61 59 k->put = put;
62 60 }
63   -
64 61 EXPORT_SYMBOL_GPL(klist_init);
65 62  
66   -
67   -static void add_head(struct klist * k, struct klist_node * n)
  63 +static void add_head(struct klist *k, struct klist_node *n)
68 64 {
69 65 spin_lock(&k->k_lock);
70 66 list_add(&n->n_node, &k->k_list);
71 67 spin_unlock(&k->k_lock);
72 68 }
73 69  
74   -static void add_tail(struct klist * k, struct klist_node * n)
  70 +static void add_tail(struct klist *k, struct klist_node *n)
75 71 {
76 72 spin_lock(&k->k_lock);
77 73 list_add_tail(&n->n_node, &k->k_list);
78 74 spin_unlock(&k->k_lock);
79 75 }
80 76  
81   -
82   -static void klist_node_init(struct klist * k, struct klist_node * n)
  77 +static void klist_node_init(struct klist *k, struct klist_node *n)
83 78 {
84 79 INIT_LIST_HEAD(&n->n_node);
85 80 init_completion(&n->n_removed);
86 81  
87 82  
88 83  
89 84  
90 85  
91 86  
92 87  
93 88  
... ... @@ -89,37 +84,30 @@
89 84 k->get(n);
90 85 }
91 86  
92   -
93 87 /**
94   - * klist_add_head - Initialize a klist_node and add it to front.
95   - * @n: node we're adding.
96   - * @k: klist it's going on.
  88 + * klist_add_head - Initialize a klist_node and add it to front.
  89 + * @n: node we're adding.
  90 + * @k: klist it's going on.
97 91 */
98   -
99   -void klist_add_head(struct klist_node * n, struct klist * k)
  92 +void klist_add_head(struct klist_node *n, struct klist *k)
100 93 {
101 94 klist_node_init(k, n);
102 95 add_head(k, n);
103 96 }
104   -
105 97 EXPORT_SYMBOL_GPL(klist_add_head);
106 98  
107   -
108 99 /**
109   - * klist_add_tail - Initialize a klist_node and add it to back.
110   - * @n: node we're adding.
111   - * @k: klist it's going on.
  100 + * klist_add_tail - Initialize a klist_node and add it to back.
  101 + * @n: node we're adding.
  102 + * @k: klist it's going on.
112 103 */
113   -
114   -void klist_add_tail(struct klist_node * n, struct klist * k)
  104 +void klist_add_tail(struct klist_node *n, struct klist *k)
115 105 {
116 106 klist_node_init(k, n);
117 107 add_tail(k, n);
118 108 }
119   -
120 109 EXPORT_SYMBOL_GPL(klist_add_tail);
121 110  
122   -
123 111 /**
124 112 * klist_add_after - Init a klist_node and add it after an existing node
125 113 * @n: node we're adding.
126 114  
127 115  
128 116  
129 117  
130 118  
131 119  
... ... @@ -152,30 +140,27 @@
152 140 }
153 141 EXPORT_SYMBOL_GPL(klist_add_before);
154 142  
155   -
156   -static void klist_release(struct kref * kref)
  143 +static void klist_release(struct kref *kref)
157 144 {
158   - struct klist_node * n = container_of(kref, struct klist_node, n_ref);
  145 + struct klist_node *n = container_of(kref, struct klist_node, n_ref);
159 146  
160 147 list_del(&n->n_node);
161 148 complete(&n->n_removed);
162 149 n->n_klist = NULL;
163 150 }
164 151  
165   -static int klist_dec_and_del(struct klist_node * n)
  152 +static int klist_dec_and_del(struct klist_node *n)
166 153 {
167 154 return kref_put(&n->n_ref, klist_release);
168 155 }
169 156  
170   -
171 157 /**
172   - * klist_del - Decrement the reference count of node and try to remove.
173   - * @n: node we're deleting.
  158 + * klist_del - Decrement the reference count of node and try to remove.
  159 + * @n: node we're deleting.
174 160 */
175   -
176   -void klist_del(struct klist_node * n)
  161 +void klist_del(struct klist_node *n)
177 162 {
178   - struct klist * k = n->n_klist;
  163 + struct klist *k = n->n_klist;
179 164 void (*put)(struct klist_node *) = k->put;
180 165  
181 166 spin_lock(&k->k_lock);
182 167  
183 168  
184 169  
185 170  
186 171  
187 172  
188 173  
189 174  
190 175  
191 176  
192 177  
193 178  
... ... @@ -185,48 +170,40 @@
185 170 if (put)
186 171 put(n);
187 172 }
188   -
189 173 EXPORT_SYMBOL_GPL(klist_del);
190 174  
191   -
192 175 /**
193   - * klist_remove - Decrement the refcount of node and wait for it to go away.
194   - * @n: node we're removing.
  176 + * klist_remove - Decrement the refcount of node and wait for it to go away.
  177 + * @n: node we're removing.
195 178 */
196   -
197   -void klist_remove(struct klist_node * n)
  179 +void klist_remove(struct klist_node *n)
198 180 {
199 181 klist_del(n);
200 182 wait_for_completion(&n->n_removed);
201 183 }
202   -
203 184 EXPORT_SYMBOL_GPL(klist_remove);
204 185  
205   -
206 186 /**
207   - * klist_node_attached - Say whether a node is bound to a list or not.
208   - * @n: Node that we're testing.
  187 + * klist_node_attached - Say whether a node is bound to a list or not.
  188 + * @n: Node that we're testing.
209 189 */
210   -
211   -int klist_node_attached(struct klist_node * n)
  190 +int klist_node_attached(struct klist_node *n)
212 191 {
213 192 return (n->n_klist != NULL);
214 193 }
215   -
216 194 EXPORT_SYMBOL_GPL(klist_node_attached);
217 195  
218   -
219 196 /**
220   - * klist_iter_init_node - Initialize a klist_iter structure.
221   - * @k: klist we're iterating.
222   - * @i: klist_iter we're filling.
223   - * @n: node to start with.
  197 + * klist_iter_init_node - Initialize a klist_iter structure.
  198 + * @k: klist we're iterating.
  199 + * @i: klist_iter we're filling.
  200 + * @n: node to start with.
224 201 *
225   - * Similar to klist_iter_init(), but starts the action off with @n,
226   - * instead of with the list head.
  202 + * Similar to klist_iter_init(), but starts the action off with @n,
  203 + * instead of with the list head.
227 204 */
228   -
229   -void klist_iter_init_node(struct klist * k, struct klist_iter * i, struct klist_node * n)
  205 +void klist_iter_init_node(struct klist *k, struct klist_iter *i,
  206 + struct klist_node *n)
230 207 {
231 208 i->i_klist = k;
232 209 i->i_head = &k->k_list;
233 210  
234 211  
235 212  
236 213  
237 214  
238 215  
239 216  
240 217  
241 218  
242 219  
243 220  
244 221  
245 222  
246 223  
247 224  
248 225  
... ... @@ -234,66 +211,56 @@
234 211 if (n)
235 212 kref_get(&n->n_ref);
236 213 }
237   -
238 214 EXPORT_SYMBOL_GPL(klist_iter_init_node);
239 215  
240   -
241 216 /**
242   - * klist_iter_init - Iniitalize a klist_iter structure.
243   - * @k: klist we're iterating.
244   - * @i: klist_iter structure we're filling.
  217 + * klist_iter_init - Iniitalize a klist_iter structure.
  218 + * @k: klist we're iterating.
  219 + * @i: klist_iter structure we're filling.
245 220 *
246   - * Similar to klist_iter_init_node(), but start with the list head.
  221 + * Similar to klist_iter_init_node(), but start with the list head.
247 222 */
248   -
249   -void klist_iter_init(struct klist * k, struct klist_iter * i)
  223 +void klist_iter_init(struct klist *k, struct klist_iter *i)
250 224 {
251 225 klist_iter_init_node(k, i, NULL);
252 226 }
253   -
254 227 EXPORT_SYMBOL_GPL(klist_iter_init);
255 228  
256   -
257 229 /**
258   - * klist_iter_exit - Finish a list iteration.
259   - * @i: Iterator structure.
  230 + * klist_iter_exit - Finish a list iteration.
  231 + * @i: Iterator structure.
260 232 *
261   - * Must be called when done iterating over list, as it decrements the
262   - * refcount of the current node. Necessary in case iteration exited before
263   - * the end of the list was reached, and always good form.
  233 + * Must be called when done iterating over list, as it decrements the
  234 + * refcount of the current node. Necessary in case iteration exited before
  235 + * the end of the list was reached, and always good form.
264 236 */
265   -
266   -void klist_iter_exit(struct klist_iter * i)
  237 +void klist_iter_exit(struct klist_iter *i)
267 238 {
268 239 if (i->i_cur) {
269 240 klist_del(i->i_cur);
270 241 i->i_cur = NULL;
271 242 }
272 243 }
273   -
274 244 EXPORT_SYMBOL_GPL(klist_iter_exit);
275 245  
276   -
277   -static struct klist_node * to_klist_node(struct list_head * n)
  246 +static struct klist_node *to_klist_node(struct list_head *n)
278 247 {
279 248 return container_of(n, struct klist_node, n_node);
280 249 }
281 250  
282   -
283 251 /**
284   - * klist_next - Ante up next node in list.
285   - * @i: Iterator structure.
  252 + * klist_next - Ante up next node in list.
  253 + * @i: Iterator structure.
286 254 *
287   - * First grab list lock. Decrement the reference count of the previous
288   - * node, if there was one. Grab the next node, increment its reference
289   - * count, drop the lock, and return that next node.
  255 + * First grab list lock. Decrement the reference count of the previous
  256 + * node, if there was one. Grab the next node, increment its reference
  257 + * count, drop the lock, and return that next node.
290 258 */
291   -
292   -struct klist_node * klist_next(struct klist_iter * i)
  259 +struct klist_node *klist_next(struct klist_iter *i)
293 260 {
294   - struct list_head * next;
295   - struct klist_node * lnode = i->i_cur;
296   - struct klist_node * knode = NULL;
  261 + struct list_head *next;
  262 + struct klist_node *lnode = i->i_cur;
  263 + struct klist_node *knode = NULL;
297 264 void (*put)(struct klist_node *) = i->i_klist->put;
298 265  
299 266 spin_lock(&i->i_klist->k_lock);
... ... @@ -314,6 +281,5 @@
314 281 put(lnode);
315 282 return knode;
316 283 }
317   -
318 284 EXPORT_SYMBOL_GPL(klist_next);