blob: 631b77f2ac70fb38c1481305bd4f088c1073e7d7 [file] [log] [blame]
Dave Hansen534acc02009-07-29 15:04:18 -07001#ifndef _FLEX_ARRAY_H
2#define _FLEX_ARRAY_H
3
4#include <linux/types.h>
5#include <asm/page.h>
6
7#define FLEX_ARRAY_PART_SIZE PAGE_SIZE
8#define FLEX_ARRAY_BASE_SIZE PAGE_SIZE
9
10struct flex_array_part;
11
12/*
13 * This is meant to replace cases where an array-like
14 * structure has gotten too big to fit into kmalloc()
15 * and the developer is getting tempted to use
16 * vmalloc().
17 */
18
19struct flex_array {
20 union {
21 struct {
22 int element_size;
23 int total_nr_elements;
David Rientjes8e7ee272009-08-26 14:29:21 -070024 struct flex_array_part *parts[];
Dave Hansen534acc02009-07-29 15:04:18 -070025 };
26 /*
27 * This little trick makes sure that
28 * sizeof(flex_array) == PAGE_SIZE
29 */
30 char padding[FLEX_ARRAY_BASE_SIZE];
31 };
32};
33
David Rientjes45b588d2009-09-21 17:04:33 -070034/* Number of bytes left in base struct flex_array, excluding metadata */
35#define FLEX_ARRAY_BASE_BYTES_LEFT \
36 (FLEX_ARRAY_BASE_SIZE - offsetof(struct flex_array, parts))
37
38/* Number of pointers in base to struct flex_array_part pages */
39#define FLEX_ARRAY_NR_BASE_PTRS \
40 (FLEX_ARRAY_BASE_BYTES_LEFT / sizeof(struct flex_array_part *))
41
42/* Number of elements of size that fit in struct flex_array_part */
43#define FLEX_ARRAY_ELEMENTS_PER_PART(size) \
44 (FLEX_ARRAY_PART_SIZE / size)
45
46/*
47 * Defines a statically allocated flex array and ensures its parameters are
48 * valid.
49 */
50#define DEFINE_FLEX_ARRAY(__arrayname, __element_size, __total) \
51 struct flex_array __arrayname = { { { \
52 .element_size = (__element_size), \
53 .total_nr_elements = (__total), \
54 } } }; \
55 static inline void __arrayname##_invalid_parameter(void) \
56 { \
57 BUILD_BUG_ON((__total) > FLEX_ARRAY_NR_BASE_PTRS * \
58 FLEX_ARRAY_ELEMENTS_PER_PART(__element_size)); \
59 }
Dave Hansen534acc02009-07-29 15:04:18 -070060
David Rientjesb62e4082009-08-26 14:29:22 -070061struct flex_array *flex_array_alloc(int element_size, unsigned int total,
62 gfp_t flags);
63int flex_array_prealloc(struct flex_array *fa, unsigned int start,
64 unsigned int end, gfp_t flags);
Dave Hansen534acc02009-07-29 15:04:18 -070065void flex_array_free(struct flex_array *fa);
66void flex_array_free_parts(struct flex_array *fa);
David Rientjesb62e4082009-08-26 14:29:22 -070067int flex_array_put(struct flex_array *fa, unsigned int element_nr, void *src,
Dave Hansen534acc02009-07-29 15:04:18 -070068 gfp_t flags);
David Rientjese6de3982009-09-21 17:04:30 -070069int flex_array_clear(struct flex_array *fa, unsigned int element_nr);
David Rientjesb62e4082009-08-26 14:29:22 -070070void *flex_array_get(struct flex_array *fa, unsigned int element_nr);
David Rientjes4af5a2f2009-09-21 17:04:31 -070071int flex_array_shrink(struct flex_array *fa);
Dave Hansen534acc02009-07-29 15:04:18 -070072
Eric Parisea98eed2010-08-09 17:20:56 -070073#define flex_array_put_ptr(fa, nr, src, gfp) \
74 flex_array_put(fa, nr, &(void *)(src), gfp)
75
76void *flex_array_get_ptr(struct flex_array *fa, unsigned int element_nr);
77
Dave Hansen534acc02009-07-29 15:04:18 -070078#endif /* _FLEX_ARRAY_H */