aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/md/dm-snap.h
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
committerLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
commit1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 (patch)
tree0bba044c4ce775e45a88a51686b5d9f90697ea9d /drivers/md/dm-snap.h
Linux-2.6.12-rc2
Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip!
Diffstat (limited to 'drivers/md/dm-snap.h')
-rw-r--r--drivers/md/dm-snap.h161
1 files changed, 161 insertions, 0 deletions
diff --git a/drivers/md/dm-snap.h b/drivers/md/dm-snap.h
new file mode 100644
index 000000000000..375aa24d4d7d
--- /dev/null
+++ b/drivers/md/dm-snap.h
@@ -0,0 +1,161 @@
1/*
2 * dm-snapshot.c
3 *
4 * Copyright (C) 2001-2002 Sistina Software (UK) Limited.
5 *
6 * This file is released under the GPL.
7 */
8
9#ifndef DM_SNAPSHOT_H
10#define DM_SNAPSHOT_H
11
12#include "dm.h"
13#include <linux/blkdev.h>
14
15struct exception_table {
16 uint32_t hash_mask;
17 struct list_head *table;
18};
19
20/*
21 * The snapshot code deals with largish chunks of the disk at a
22 * time. Typically 64k - 256k.
23 */
24/* FIXME: can we get away with limiting these to a uint32_t ? */
25typedef sector_t chunk_t;
26
27/*
28 * An exception is used where an old chunk of data has been
29 * replaced by a new one.
30 */
31struct exception {
32 struct list_head hash_list;
33
34 chunk_t old_chunk;
35 chunk_t new_chunk;
36};
37
38/*
39 * Abstraction to handle the meta/layout of exception stores (the
40 * COW device).
41 */
42struct exception_store {
43
44 /*
45 * Destroys this object when you've finished with it.
46 */
47 void (*destroy) (struct exception_store *store);
48
49 /*
50 * The target shouldn't read the COW device until this is
51 * called.
52 */
53 int (*read_metadata) (struct exception_store *store);
54
55 /*
56 * Find somewhere to store the next exception.
57 */
58 int (*prepare_exception) (struct exception_store *store,
59 struct exception *e);
60
61 /*
62 * Update the metadata with this exception.
63 */
64 void (*commit_exception) (struct exception_store *store,
65 struct exception *e,
66 void (*callback) (void *, int success),
67 void *callback_context);
68
69 /*
70 * The snapshot is invalid, note this in the metadata.
71 */
72 void (*drop_snapshot) (struct exception_store *store);
73
74 /*
75 * Return how full the snapshot is.
76 */
77 void (*fraction_full) (struct exception_store *store,
78 sector_t *numerator,
79 sector_t *denominator);
80
81 struct dm_snapshot *snap;
82 void *context;
83};
84
85struct dm_snapshot {
86 struct rw_semaphore lock;
87 struct dm_table *table;
88
89 struct dm_dev *origin;
90 struct dm_dev *cow;
91
92 /* List of snapshots per Origin */
93 struct list_head list;
94
95 /* Size of data blocks saved - must be a power of 2 */
96 chunk_t chunk_size;
97 chunk_t chunk_mask;
98 chunk_t chunk_shift;
99
100 /* You can't use a snapshot if this is 0 (e.g. if full) */
101 int valid;
102 int have_metadata;
103
104 /* Used for display of table */
105 char type;
106
107 /* The last percentage we notified */
108 int last_percent;
109
110 struct exception_table pending;
111 struct exception_table complete;
112
113 /* The on disk metadata handler */
114 struct exception_store store;
115
116 struct kcopyd_client *kcopyd_client;
117};
118
119/*
120 * Used by the exception stores to load exceptions hen
121 * initialising.
122 */
123int dm_add_exception(struct dm_snapshot *s, chunk_t old, chunk_t new);
124
125/*
126 * Constructor and destructor for the default persistent
127 * store.
128 */
129int dm_create_persistent(struct exception_store *store, uint32_t chunk_size);
130
131int dm_create_transient(struct exception_store *store,
132 struct dm_snapshot *s, int blocksize);
133
134/*
135 * Return the number of sectors in the device.
136 */
137static inline sector_t get_dev_size(struct block_device *bdev)
138{
139 return bdev->bd_inode->i_size >> SECTOR_SHIFT;
140}
141
142static inline chunk_t sector_to_chunk(struct dm_snapshot *s, sector_t sector)
143{
144 return (sector & ~s->chunk_mask) >> s->chunk_shift;
145}
146
147static inline sector_t chunk_to_sector(struct dm_snapshot *s, chunk_t chunk)
148{
149 return chunk << s->chunk_shift;
150}
151
152static inline int bdev_equal(struct block_device *lhs, struct block_device *rhs)
153{
154 /*
155 * There is only ever one instance of a particular block
156 * device so we can compare pointers safely.
157 */
158 return lhs == rhs;
159}
160
161#endif