293d5ce62a2150793b787cdd7a683f931c9eeeb3
[firefly-linux-kernel-4.4.55.git] / drivers / md / dm.h
1 /*
2  * Internal header file for device mapper
3  *
4  * Copyright (C) 2001, 2002 Sistina Software
5  * Copyright (C) 2004-2006 Red Hat, Inc. All rights reserved.
6  *
7  * This file is released under the LGPL.
8  */
9
10 #ifndef DM_INTERNAL_H
11 #define DM_INTERNAL_H
12
13 #include <linux/fs.h>
14 #include <linux/device-mapper.h>
15 #include <linux/list.h>
16 #include <linux/blkdev.h>
17 #include <linux/hdreg.h>
18
19 #define DM_NAME "device-mapper"
20
21 #define DMERR(f, arg...) printk(KERN_ERR DM_NAME ": " DM_MSG_PREFIX ": " f "\n", ## arg)
22 #define DMWARN(f, arg...) printk(KERN_WARNING DM_NAME ": " DM_MSG_PREFIX ": " f "\n", ## arg)
23 #define DMINFO(f, arg...) printk(KERN_INFO DM_NAME ": " DM_MSG_PREFIX ": " f "\n", ## arg)
24 #ifdef CONFIG_DM_DEBUG
25 #  define DMDEBUG(f, arg...) printk(KERN_DEBUG DM_NAME ": " DM_MSG_PREFIX " DEBUG: " f "\n", ## arg)
26 #else
27 #  define DMDEBUG(f, arg...) do {} while (0)
28 #endif
29
30 #define DMEMIT(x...) sz += ((sz >= maxlen) ? \
31                           0 : scnprintf(result + sz, maxlen - sz, x))
32
33 #define SECTOR_SHIFT 9
34
35 /*
36  * Definitions of return values from target end_io function.
37  */
38 #define DM_ENDIO_INCOMPLETE     1
39
40 /*
41  * Definitions of return values from target map function.
42  */
43 #define DM_MAPIO_SUBMITTED      0
44 #define DM_MAPIO_REMAPPED       1
45
46 /*
47  * Suspend feature flags
48  */
49 #define DM_SUSPEND_LOCKFS_FLAG          (1 << 0)
50
51 /*
52  * List of devices that a metadevice uses and should open/close.
53  */
54 struct dm_dev {
55         struct list_head list;
56
57         atomic_t count;
58         int mode;
59         struct block_device *bdev;
60         char name[16];
61 };
62
63 struct dm_table;
64
65 /*-----------------------------------------------------------------
66  * Internal table functions.
67  *---------------------------------------------------------------*/
68 void dm_table_event_callback(struct dm_table *t,
69                              void (*fn)(void *), void *context);
70 struct dm_target *dm_table_get_target(struct dm_table *t, unsigned int index);
71 struct dm_target *dm_table_find_target(struct dm_table *t, sector_t sector);
72 void dm_table_set_restrictions(struct dm_table *t, struct request_queue *q);
73 struct list_head *dm_table_get_devices(struct dm_table *t);
74 void dm_table_presuspend_targets(struct dm_table *t);
75 void dm_table_postsuspend_targets(struct dm_table *t);
76 int dm_table_resume_targets(struct dm_table *t);
77 int dm_table_any_congested(struct dm_table *t, int bdi_bits);
78 void dm_table_unplug_all(struct dm_table *t);
79 int dm_table_flush_all(struct dm_table *t);
80
81 /*-----------------------------------------------------------------
82  * A registry of target types.
83  *---------------------------------------------------------------*/
84 int dm_target_init(void);
85 void dm_target_exit(void);
86 struct target_type *dm_get_target_type(const char *name);
87 void dm_put_target_type(struct target_type *t);
88 int dm_target_iterate(void (*iter_func)(struct target_type *tt,
89                                         void *param), void *param);
90
91 /*-----------------------------------------------------------------
92  * Useful inlines.
93  *---------------------------------------------------------------*/
94 static inline int array_too_big(unsigned long fixed, unsigned long obj,
95                                 unsigned long num)
96 {
97         return (num > (ULONG_MAX - fixed) / obj);
98 }
99
100 /*
101  * Ceiling(n / sz)
102  */
103 #define dm_div_up(n, sz) (((n) + (sz) - 1) / (sz))
104
105 #define dm_sector_div_up(n, sz) ( \
106 { \
107         sector_t _r = ((n) + (sz) - 1); \
108         sector_div(_r, (sz)); \
109         _r; \
110 } \
111 )
112
113 /*
114  * ceiling(n / size) * size
115  */
116 #define dm_round_up(n, sz) (dm_div_up((n), (sz)) * (sz))
117
118 static inline sector_t to_sector(unsigned long n)
119 {
120         return (n >> 9);
121 }
122
123 static inline unsigned long to_bytes(sector_t n)
124 {
125         return (n << 9);
126 }
127
128 int dm_split_args(int *argc, char ***argvp, char *input);
129
130 /*
131  * The device-mapper can be driven through one of two interfaces;
132  * ioctl or filesystem, depending which patch you have applied.
133  */
134 int dm_interface_init(void);
135 void dm_interface_exit(void);
136
137 /*
138  * Targets for linear and striped mappings
139  */
140 int dm_linear_init(void);
141 void dm_linear_exit(void);
142
143 int dm_stripe_init(void);
144 void dm_stripe_exit(void);
145
146 void *dm_vcalloc(unsigned long nmemb, unsigned long elem_size);
147 union map_info *dm_get_mapinfo(struct bio *bio);
148 int dm_open_count(struct mapped_device *md);
149 int dm_lock_for_deletion(struct mapped_device *md);
150
151 #endif