dm-snap.c 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218
  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. #include <linux/blkdev.h>
  9. #include <linux/config.h>
  10. #include <linux/ctype.h>
  11. #include <linux/device-mapper.h>
  12. #include <linux/fs.h>
  13. #include <linux/init.h>
  14. #include <linux/kdev_t.h>
  15. #include <linux/list.h>
  16. #include <linux/mempool.h>
  17. #include <linux/module.h>
  18. #include <linux/slab.h>
  19. #include <linux/vmalloc.h>
  20. #include "dm-snap.h"
  21. #include "dm-bio-list.h"
  22. #include "kcopyd.h"
  23. /*
  24. * The percentage increment we will wake up users at
  25. */
  26. #define WAKE_UP_PERCENT 5
  27. /*
  28. * kcopyd priority of snapshot operations
  29. */
  30. #define SNAPSHOT_COPY_PRIORITY 2
  31. /*
  32. * Each snapshot reserves this many pages for io
  33. */
  34. #define SNAPSHOT_PAGES 256
  35. struct pending_exception {
  36. struct exception e;
  37. /*
  38. * Origin buffers waiting for this to complete are held
  39. * in a bio list
  40. */
  41. struct bio_list origin_bios;
  42. struct bio_list snapshot_bios;
  43. /*
  44. * Other pending_exceptions that are processing this
  45. * chunk. When this list is empty, we know we can
  46. * complete the origins.
  47. */
  48. struct list_head siblings;
  49. /* Pointer back to snapshot context */
  50. struct dm_snapshot *snap;
  51. /*
  52. * 1 indicates the exception has already been sent to
  53. * kcopyd.
  54. */
  55. int started;
  56. };
  57. /*
  58. * Hash table mapping origin volumes to lists of snapshots and
  59. * a lock to protect it
  60. */
  61. static kmem_cache_t *exception_cache;
  62. static kmem_cache_t *pending_cache;
  63. static mempool_t *pending_pool;
  64. /*
  65. * One of these per registered origin, held in the snapshot_origins hash
  66. */
  67. struct origin {
  68. /* The origin device */
  69. struct block_device *bdev;
  70. struct list_head hash_list;
  71. /* List of snapshots for this origin */
  72. struct list_head snapshots;
  73. };
  74. /*
  75. * Size of the hash table for origin volumes. If we make this
  76. * the size of the minors list then it should be nearly perfect
  77. */
  78. #define ORIGIN_HASH_SIZE 256
  79. #define ORIGIN_MASK 0xFF
  80. static struct list_head *_origins;
  81. static struct rw_semaphore _origins_lock;
  82. static int init_origin_hash(void)
  83. {
  84. int i;
  85. _origins = kmalloc(ORIGIN_HASH_SIZE * sizeof(struct list_head),
  86. GFP_KERNEL);
  87. if (!_origins) {
  88. DMERR("Device mapper: Snapshot: unable to allocate memory");
  89. return -ENOMEM;
  90. }
  91. for (i = 0; i < ORIGIN_HASH_SIZE; i++)
  92. INIT_LIST_HEAD(_origins + i);
  93. init_rwsem(&_origins_lock);
  94. return 0;
  95. }
  96. static void exit_origin_hash(void)
  97. {
  98. kfree(_origins);
  99. }
  100. static inline unsigned int origin_hash(struct block_device *bdev)
  101. {
  102. return bdev->bd_dev & ORIGIN_MASK;
  103. }
  104. static struct origin *__lookup_origin(struct block_device *origin)
  105. {
  106. struct list_head *ol;
  107. struct origin *o;
  108. ol = &_origins[origin_hash(origin)];
  109. list_for_each_entry (o, ol, hash_list)
  110. if (bdev_equal(o->bdev, origin))
  111. return o;
  112. return NULL;
  113. }
  114. static void __insert_origin(struct origin *o)
  115. {
  116. struct list_head *sl = &_origins[origin_hash(o->bdev)];
  117. list_add_tail(&o->hash_list, sl);
  118. }
  119. /*
  120. * Make a note of the snapshot and its origin so we can look it
  121. * up when the origin has a write on it.
  122. */
  123. static int register_snapshot(struct dm_snapshot *snap)
  124. {
  125. struct origin *o;
  126. struct block_device *bdev = snap->origin->bdev;
  127. down_write(&_origins_lock);
  128. o = __lookup_origin(bdev);
  129. if (!o) {
  130. /* New origin */
  131. o = kmalloc(sizeof(*o), GFP_KERNEL);
  132. if (!o) {
  133. up_write(&_origins_lock);
  134. return -ENOMEM;
  135. }
  136. /* Initialise the struct */
  137. INIT_LIST_HEAD(&o->snapshots);
  138. o->bdev = bdev;
  139. __insert_origin(o);
  140. }
  141. list_add_tail(&snap->list, &o->snapshots);
  142. up_write(&_origins_lock);
  143. return 0;
  144. }
  145. static void unregister_snapshot(struct dm_snapshot *s)
  146. {
  147. struct origin *o;
  148. down_write(&_origins_lock);
  149. o = __lookup_origin(s->origin->bdev);
  150. list_del(&s->list);
  151. if (list_empty(&o->snapshots)) {
  152. list_del(&o->hash_list);
  153. kfree(o);
  154. }
  155. up_write(&_origins_lock);
  156. }
  157. /*
  158. * Implementation of the exception hash tables.
  159. */
  160. static int init_exception_table(struct exception_table *et, uint32_t size)
  161. {
  162. unsigned int i;
  163. et->hash_mask = size - 1;
  164. et->table = dm_vcalloc(size, sizeof(struct list_head));
  165. if (!et->table)
  166. return -ENOMEM;
  167. for (i = 0; i < size; i++)
  168. INIT_LIST_HEAD(et->table + i);
  169. return 0;
  170. }
  171. static void exit_exception_table(struct exception_table *et, kmem_cache_t *mem)
  172. {
  173. struct list_head *slot;
  174. struct exception *ex, *next;
  175. int i, size;
  176. size = et->hash_mask + 1;
  177. for (i = 0; i < size; i++) {
  178. slot = et->table + i;
  179. list_for_each_entry_safe (ex, next, slot, hash_list)
  180. kmem_cache_free(mem, ex);
  181. }
  182. vfree(et->table);
  183. }
  184. static inline uint32_t exception_hash(struct exception_table *et, chunk_t chunk)
  185. {
  186. return chunk & et->hash_mask;
  187. }
  188. static void insert_exception(struct exception_table *eh, struct exception *e)
  189. {
  190. struct list_head *l = &eh->table[exception_hash(eh, e->old_chunk)];
  191. list_add(&e->hash_list, l);
  192. }
  193. static inline void remove_exception(struct exception *e)
  194. {
  195. list_del(&e->hash_list);
  196. }
  197. /*
  198. * Return the exception data for a sector, or NULL if not
  199. * remapped.
  200. */
  201. static struct exception *lookup_exception(struct exception_table *et,
  202. chunk_t chunk)
  203. {
  204. struct list_head *slot;
  205. struct exception *e;
  206. slot = &et->table[exception_hash(et, chunk)];
  207. list_for_each_entry (e, slot, hash_list)
  208. if (e->old_chunk == chunk)
  209. return e;
  210. return NULL;
  211. }
  212. static inline struct exception *alloc_exception(void)
  213. {
  214. struct exception *e;
  215. e = kmem_cache_alloc(exception_cache, GFP_NOIO);
  216. if (!e)
  217. e = kmem_cache_alloc(exception_cache, GFP_ATOMIC);
  218. return e;
  219. }
  220. static inline void free_exception(struct exception *e)
  221. {
  222. kmem_cache_free(exception_cache, e);
  223. }
  224. static inline struct pending_exception *alloc_pending_exception(void)
  225. {
  226. return mempool_alloc(pending_pool, GFP_NOIO);
  227. }
  228. static inline void free_pending_exception(struct pending_exception *pe)
  229. {
  230. mempool_free(pe, pending_pool);
  231. }
  232. int dm_add_exception(struct dm_snapshot *s, chunk_t old, chunk_t new)
  233. {
  234. struct exception *e;
  235. e = alloc_exception();
  236. if (!e)
  237. return -ENOMEM;
  238. e->old_chunk = old;
  239. e->new_chunk = new;
  240. insert_exception(&s->complete, e);
  241. return 0;
  242. }
  243. /*
  244. * Hard coded magic.
  245. */
  246. static int calc_max_buckets(void)
  247. {
  248. /* use a fixed size of 2MB */
  249. unsigned long mem = 2 * 1024 * 1024;
  250. mem /= sizeof(struct list_head);
  251. return mem;
  252. }
  253. /*
  254. * Rounds a number down to a power of 2.
  255. */
  256. static inline uint32_t round_down(uint32_t n)
  257. {
  258. while (n & (n - 1))
  259. n &= (n - 1);
  260. return n;
  261. }
  262. /*
  263. * Allocate room for a suitable hash table.
  264. */
  265. static int init_hash_tables(struct dm_snapshot *s)
  266. {
  267. sector_t hash_size, cow_dev_size, origin_dev_size, max_buckets;
  268. /*
  269. * Calculate based on the size of the original volume or
  270. * the COW volume...
  271. */
  272. cow_dev_size = get_dev_size(s->cow->bdev);
  273. origin_dev_size = get_dev_size(s->origin->bdev);
  274. max_buckets = calc_max_buckets();
  275. hash_size = min(origin_dev_size, cow_dev_size) >> s->chunk_shift;
  276. hash_size = min(hash_size, max_buckets);
  277. /* Round it down to a power of 2 */
  278. hash_size = round_down(hash_size);
  279. if (init_exception_table(&s->complete, hash_size))
  280. return -ENOMEM;
  281. /*
  282. * Allocate hash table for in-flight exceptions
  283. * Make this smaller than the real hash table
  284. */
  285. hash_size >>= 3;
  286. if (hash_size < 64)
  287. hash_size = 64;
  288. if (init_exception_table(&s->pending, hash_size)) {
  289. exit_exception_table(&s->complete, exception_cache);
  290. return -ENOMEM;
  291. }
  292. return 0;
  293. }
  294. /*
  295. * Round a number up to the nearest 'size' boundary. size must
  296. * be a power of 2.
  297. */
  298. static inline ulong round_up(ulong n, ulong size)
  299. {
  300. size--;
  301. return (n + size) & ~size;
  302. }
  303. static void read_snapshot_metadata(struct dm_snapshot *s)
  304. {
  305. if (s->store.read_metadata(&s->store)) {
  306. down_write(&s->lock);
  307. s->valid = 0;
  308. up_write(&s->lock);
  309. }
  310. }
  311. /*
  312. * Construct a snapshot mapping: <origin_dev> <COW-dev> <p/n> <chunk-size>
  313. */
  314. static int snapshot_ctr(struct dm_target *ti, unsigned int argc, char **argv)
  315. {
  316. struct dm_snapshot *s;
  317. unsigned long chunk_size;
  318. int r = -EINVAL;
  319. char persistent;
  320. char *origin_path;
  321. char *cow_path;
  322. char *value;
  323. int blocksize;
  324. if (argc < 4) {
  325. ti->error = "dm-snapshot: requires exactly 4 arguments";
  326. r = -EINVAL;
  327. goto bad1;
  328. }
  329. origin_path = argv[0];
  330. cow_path = argv[1];
  331. persistent = toupper(*argv[2]);
  332. if (persistent != 'P' && persistent != 'N') {
  333. ti->error = "Persistent flag is not P or N";
  334. r = -EINVAL;
  335. goto bad1;
  336. }
  337. chunk_size = simple_strtoul(argv[3], &value, 10);
  338. if (chunk_size == 0 || value == NULL) {
  339. ti->error = "Invalid chunk size";
  340. r = -EINVAL;
  341. goto bad1;
  342. }
  343. s = kmalloc(sizeof(*s), GFP_KERNEL);
  344. if (s == NULL) {
  345. ti->error = "Cannot allocate snapshot context private "
  346. "structure";
  347. r = -ENOMEM;
  348. goto bad1;
  349. }
  350. r = dm_get_device(ti, origin_path, 0, ti->len, FMODE_READ, &s->origin);
  351. if (r) {
  352. ti->error = "Cannot get origin device";
  353. goto bad2;
  354. }
  355. r = dm_get_device(ti, cow_path, 0, 0,
  356. FMODE_READ | FMODE_WRITE, &s->cow);
  357. if (r) {
  358. dm_put_device(ti, s->origin);
  359. ti->error = "Cannot get COW device";
  360. goto bad2;
  361. }
  362. /*
  363. * Chunk size must be multiple of page size. Silently
  364. * round up if it's not.
  365. */
  366. chunk_size = round_up(chunk_size, PAGE_SIZE >> 9);
  367. /* Validate the chunk size against the device block size */
  368. blocksize = s->cow->bdev->bd_disk->queue->hardsect_size;
  369. if (chunk_size % (blocksize >> 9)) {
  370. ti->error = "Chunk size is not a multiple of device blocksize";
  371. r = -EINVAL;
  372. goto bad3;
  373. }
  374. /* Check chunk_size is a power of 2 */
  375. if (chunk_size & (chunk_size - 1)) {
  376. ti->error = "Chunk size is not a power of 2";
  377. r = -EINVAL;
  378. goto bad3;
  379. }
  380. s->chunk_size = chunk_size;
  381. s->chunk_mask = chunk_size - 1;
  382. s->type = persistent;
  383. s->chunk_shift = ffs(chunk_size) - 1;
  384. s->valid = 1;
  385. s->active = 0;
  386. s->last_percent = 0;
  387. init_rwsem(&s->lock);
  388. s->table = ti->table;
  389. /* Allocate hash table for COW data */
  390. if (init_hash_tables(s)) {
  391. ti->error = "Unable to allocate hash table space";
  392. r = -ENOMEM;
  393. goto bad3;
  394. }
  395. /*
  396. * Check the persistent flag - done here because we need the iobuf
  397. * to check the LV header
  398. */
  399. s->store.snap = s;
  400. if (persistent == 'P')
  401. r = dm_create_persistent(&s->store, chunk_size);
  402. else
  403. r = dm_create_transient(&s->store, s, blocksize);
  404. if (r) {
  405. ti->error = "Couldn't create exception store";
  406. r = -EINVAL;
  407. goto bad4;
  408. }
  409. r = kcopyd_client_create(SNAPSHOT_PAGES, &s->kcopyd_client);
  410. if (r) {
  411. ti->error = "Could not create kcopyd client";
  412. goto bad5;
  413. }
  414. /* Metadata must only be loaded into one table at once */
  415. read_snapshot_metadata(s);
  416. /* Add snapshot to the list of snapshots for this origin */
  417. /* Exceptions aren't triggered till snapshot_resume() is called */
  418. if (register_snapshot(s)) {
  419. r = -EINVAL;
  420. ti->error = "Cannot register snapshot origin";
  421. goto bad6;
  422. }
  423. ti->private = s;
  424. ti->split_io = chunk_size;
  425. return 0;
  426. bad6:
  427. kcopyd_client_destroy(s->kcopyd_client);
  428. bad5:
  429. s->store.destroy(&s->store);
  430. bad4:
  431. exit_exception_table(&s->pending, pending_cache);
  432. exit_exception_table(&s->complete, exception_cache);
  433. bad3:
  434. dm_put_device(ti, s->cow);
  435. dm_put_device(ti, s->origin);
  436. bad2:
  437. kfree(s);
  438. bad1:
  439. return r;
  440. }
  441. static void snapshot_dtr(struct dm_target *ti)
  442. {
  443. struct dm_snapshot *s = (struct dm_snapshot *) ti->private;
  444. unregister_snapshot(s);
  445. exit_exception_table(&s->pending, pending_cache);
  446. exit_exception_table(&s->complete, exception_cache);
  447. /* Deallocate memory used */
  448. s->store.destroy(&s->store);
  449. dm_put_device(ti, s->origin);
  450. dm_put_device(ti, s->cow);
  451. kcopyd_client_destroy(s->kcopyd_client);
  452. kfree(s);
  453. }
  454. /*
  455. * Flush a list of buffers.
  456. */
  457. static void flush_bios(struct bio *bio)
  458. {
  459. struct bio *n;
  460. while (bio) {
  461. n = bio->bi_next;
  462. bio->bi_next = NULL;
  463. generic_make_request(bio);
  464. bio = n;
  465. }
  466. }
  467. /*
  468. * Error a list of buffers.
  469. */
  470. static void error_bios(struct bio *bio)
  471. {
  472. struct bio *n;
  473. while (bio) {
  474. n = bio->bi_next;
  475. bio->bi_next = NULL;
  476. bio_io_error(bio, bio->bi_size);
  477. bio = n;
  478. }
  479. }
  480. static struct bio *__flush_bios(struct pending_exception *pe)
  481. {
  482. struct pending_exception *sibling;
  483. if (list_empty(&pe->siblings))
  484. return bio_list_get(&pe->origin_bios);
  485. sibling = list_entry(pe->siblings.next,
  486. struct pending_exception, siblings);
  487. list_del(&pe->siblings);
  488. /* This is fine as long as kcopyd is single-threaded. If kcopyd
  489. * becomes multi-threaded, we'll need some locking here.
  490. */
  491. bio_list_merge(&sibling->origin_bios, &pe->origin_bios);
  492. return NULL;
  493. }
  494. static void pending_complete(struct pending_exception *pe, int success)
  495. {
  496. struct exception *e;
  497. struct dm_snapshot *s = pe->snap;
  498. struct bio *flush = NULL;
  499. if (success) {
  500. e = alloc_exception();
  501. if (!e) {
  502. DMWARN("Unable to allocate exception.");
  503. down_write(&s->lock);
  504. s->store.drop_snapshot(&s->store);
  505. s->valid = 0;
  506. flush = __flush_bios(pe);
  507. up_write(&s->lock);
  508. error_bios(bio_list_get(&pe->snapshot_bios));
  509. goto out;
  510. }
  511. *e = pe->e;
  512. /*
  513. * Add a proper exception, and remove the
  514. * in-flight exception from the list.
  515. */
  516. down_write(&s->lock);
  517. insert_exception(&s->complete, e);
  518. remove_exception(&pe->e);
  519. flush = __flush_bios(pe);
  520. /* Submit any pending write bios */
  521. up_write(&s->lock);
  522. flush_bios(bio_list_get(&pe->snapshot_bios));
  523. } else {
  524. /* Read/write error - snapshot is unusable */
  525. down_write(&s->lock);
  526. if (s->valid)
  527. DMERR("Error reading/writing snapshot");
  528. s->store.drop_snapshot(&s->store);
  529. s->valid = 0;
  530. remove_exception(&pe->e);
  531. flush = __flush_bios(pe);
  532. up_write(&s->lock);
  533. error_bios(bio_list_get(&pe->snapshot_bios));
  534. dm_table_event(s->table);
  535. }
  536. out:
  537. free_pending_exception(pe);
  538. if (flush)
  539. flush_bios(flush);
  540. }
  541. static void commit_callback(void *context, int success)
  542. {
  543. struct pending_exception *pe = (struct pending_exception *) context;
  544. pending_complete(pe, success);
  545. }
  546. /*
  547. * Called when the copy I/O has finished. kcopyd actually runs
  548. * this code so don't block.
  549. */
  550. static void copy_callback(int read_err, unsigned int write_err, void *context)
  551. {
  552. struct pending_exception *pe = (struct pending_exception *) context;
  553. struct dm_snapshot *s = pe->snap;
  554. if (read_err || write_err)
  555. pending_complete(pe, 0);
  556. else
  557. /* Update the metadata if we are persistent */
  558. s->store.commit_exception(&s->store, &pe->e, commit_callback,
  559. pe);
  560. }
  561. /*
  562. * Dispatches the copy operation to kcopyd.
  563. */
  564. static void start_copy(struct pending_exception *pe)
  565. {
  566. struct dm_snapshot *s = pe->snap;
  567. struct io_region src, dest;
  568. struct block_device *bdev = s->origin->bdev;
  569. sector_t dev_size;
  570. dev_size = get_dev_size(bdev);
  571. src.bdev = bdev;
  572. src.sector = chunk_to_sector(s, pe->e.old_chunk);
  573. src.count = min(s->chunk_size, dev_size - src.sector);
  574. dest.bdev = s->cow->bdev;
  575. dest.sector = chunk_to_sector(s, pe->e.new_chunk);
  576. dest.count = src.count;
  577. /* Hand over to kcopyd */
  578. kcopyd_copy(s->kcopyd_client,
  579. &src, 1, &dest, 0, copy_callback, pe);
  580. }
  581. /*
  582. * Looks to see if this snapshot already has a pending exception
  583. * for this chunk, otherwise it allocates a new one and inserts
  584. * it into the pending table.
  585. *
  586. * NOTE: a write lock must be held on snap->lock before calling
  587. * this.
  588. */
  589. static struct pending_exception *
  590. __find_pending_exception(struct dm_snapshot *s, struct bio *bio)
  591. {
  592. struct exception *e;
  593. struct pending_exception *pe;
  594. chunk_t chunk = sector_to_chunk(s, bio->bi_sector);
  595. /*
  596. * Is there a pending exception for this already ?
  597. */
  598. e = lookup_exception(&s->pending, chunk);
  599. if (e) {
  600. /* cast the exception to a pending exception */
  601. pe = container_of(e, struct pending_exception, e);
  602. } else {
  603. /*
  604. * Create a new pending exception, we don't want
  605. * to hold the lock while we do this.
  606. */
  607. up_write(&s->lock);
  608. pe = alloc_pending_exception();
  609. down_write(&s->lock);
  610. e = lookup_exception(&s->pending, chunk);
  611. if (e) {
  612. free_pending_exception(pe);
  613. pe = container_of(e, struct pending_exception, e);
  614. } else {
  615. pe->e.old_chunk = chunk;
  616. bio_list_init(&pe->origin_bios);
  617. bio_list_init(&pe->snapshot_bios);
  618. INIT_LIST_HEAD(&pe->siblings);
  619. pe->snap = s;
  620. pe->started = 0;
  621. if (s->store.prepare_exception(&s->store, &pe->e)) {
  622. free_pending_exception(pe);
  623. s->valid = 0;
  624. return NULL;
  625. }
  626. insert_exception(&s->pending, &pe->e);
  627. }
  628. }
  629. return pe;
  630. }
  631. static inline void remap_exception(struct dm_snapshot *s, struct exception *e,
  632. struct bio *bio)
  633. {
  634. bio->bi_bdev = s->cow->bdev;
  635. bio->bi_sector = chunk_to_sector(s, e->new_chunk) +
  636. (bio->bi_sector & s->chunk_mask);
  637. }
  638. static int snapshot_map(struct dm_target *ti, struct bio *bio,
  639. union map_info *map_context)
  640. {
  641. struct exception *e;
  642. struct dm_snapshot *s = (struct dm_snapshot *) ti->private;
  643. int r = 1;
  644. chunk_t chunk;
  645. struct pending_exception *pe;
  646. chunk = sector_to_chunk(s, bio->bi_sector);
  647. /* Full snapshots are not usable */
  648. if (!s->valid)
  649. return -EIO;
  650. /*
  651. * Write to snapshot - higher level takes care of RW/RO
  652. * flags so we should only get this if we are
  653. * writeable.
  654. */
  655. if (bio_rw(bio) == WRITE) {
  656. /* FIXME: should only take write lock if we need
  657. * to copy an exception */
  658. down_write(&s->lock);
  659. /* If the block is already remapped - use that, else remap it */
  660. e = lookup_exception(&s->complete, chunk);
  661. if (e) {
  662. remap_exception(s, e, bio);
  663. up_write(&s->lock);
  664. } else {
  665. pe = __find_pending_exception(s, bio);
  666. if (!pe) {
  667. if (s->store.drop_snapshot)
  668. s->store.drop_snapshot(&s->store);
  669. s->valid = 0;
  670. r = -EIO;
  671. up_write(&s->lock);
  672. } else {
  673. remap_exception(s, &pe->e, bio);
  674. bio_list_add(&pe->snapshot_bios, bio);
  675. if (!pe->started) {
  676. /* this is protected by snap->lock */
  677. pe->started = 1;
  678. up_write(&s->lock);
  679. start_copy(pe);
  680. } else
  681. up_write(&s->lock);
  682. r = 0;
  683. }
  684. }
  685. } else {
  686. /*
  687. * FIXME: this read path scares me because we
  688. * always use the origin when we have a pending
  689. * exception. However I can't think of a
  690. * situation where this is wrong - ejt.
  691. */
  692. /* Do reads */
  693. down_read(&s->lock);
  694. /* See if it it has been remapped */
  695. e = lookup_exception(&s->complete, chunk);
  696. if (e)
  697. remap_exception(s, e, bio);
  698. else
  699. bio->bi_bdev = s->origin->bdev;
  700. up_read(&s->lock);
  701. }
  702. return r;
  703. }
  704. static void snapshot_resume(struct dm_target *ti)
  705. {
  706. struct dm_snapshot *s = (struct dm_snapshot *) ti->private;
  707. down_write(&s->lock);
  708. s->active = 1;
  709. up_write(&s->lock);
  710. }
  711. static int snapshot_status(struct dm_target *ti, status_type_t type,
  712. char *result, unsigned int maxlen)
  713. {
  714. struct dm_snapshot *snap = (struct dm_snapshot *) ti->private;
  715. switch (type) {
  716. case STATUSTYPE_INFO:
  717. if (!snap->valid)
  718. snprintf(result, maxlen, "Invalid");
  719. else {
  720. if (snap->store.fraction_full) {
  721. sector_t numerator, denominator;
  722. snap->store.fraction_full(&snap->store,
  723. &numerator,
  724. &denominator);
  725. snprintf(result, maxlen,
  726. SECTOR_FORMAT "/" SECTOR_FORMAT,
  727. numerator, denominator);
  728. }
  729. else
  730. snprintf(result, maxlen, "Unknown");
  731. }
  732. break;
  733. case STATUSTYPE_TABLE:
  734. /*
  735. * kdevname returns a static pointer so we need
  736. * to make private copies if the output is to
  737. * make sense.
  738. */
  739. snprintf(result, maxlen, "%s %s %c " SECTOR_FORMAT,
  740. snap->origin->name, snap->cow->name,
  741. snap->type, snap->chunk_size);
  742. break;
  743. }
  744. return 0;
  745. }
  746. /*-----------------------------------------------------------------
  747. * Origin methods
  748. *---------------------------------------------------------------*/
  749. static void list_merge(struct list_head *l1, struct list_head *l2)
  750. {
  751. struct list_head *l1_n, *l2_p;
  752. l1_n = l1->next;
  753. l2_p = l2->prev;
  754. l1->next = l2;
  755. l2->prev = l1;
  756. l2_p->next = l1_n;
  757. l1_n->prev = l2_p;
  758. }
  759. static int __origin_write(struct list_head *snapshots, struct bio *bio)
  760. {
  761. int r = 1, first = 1;
  762. struct dm_snapshot *snap;
  763. struct exception *e;
  764. struct pending_exception *pe, *last = NULL;
  765. chunk_t chunk;
  766. /* Do all the snapshots on this origin */
  767. list_for_each_entry (snap, snapshots, list) {
  768. /* Only deal with valid and active snapshots */
  769. if (!snap->valid || !snap->active)
  770. continue;
  771. /* Nothing to do if writing beyond end of snapshot */
  772. if (bio->bi_sector >= dm_table_get_size(snap->table))
  773. continue;
  774. down_write(&snap->lock);
  775. /*
  776. * Remember, different snapshots can have
  777. * different chunk sizes.
  778. */
  779. chunk = sector_to_chunk(snap, bio->bi_sector);
  780. /*
  781. * Check exception table to see if block
  782. * is already remapped in this snapshot
  783. * and trigger an exception if not.
  784. */
  785. e = lookup_exception(&snap->complete, chunk);
  786. if (!e) {
  787. pe = __find_pending_exception(snap, bio);
  788. if (!pe) {
  789. snap->store.drop_snapshot(&snap->store);
  790. snap->valid = 0;
  791. } else {
  792. if (last)
  793. list_merge(&pe->siblings,
  794. &last->siblings);
  795. last = pe;
  796. r = 0;
  797. }
  798. }
  799. up_write(&snap->lock);
  800. }
  801. /*
  802. * Now that we have a complete pe list we can start the copying.
  803. */
  804. if (last) {
  805. pe = last;
  806. do {
  807. down_write(&pe->snap->lock);
  808. if (first)
  809. bio_list_add(&pe->origin_bios, bio);
  810. if (!pe->started) {
  811. pe->started = 1;
  812. up_write(&pe->snap->lock);
  813. start_copy(pe);
  814. } else
  815. up_write(&pe->snap->lock);
  816. first = 0;
  817. pe = list_entry(pe->siblings.next,
  818. struct pending_exception, siblings);
  819. } while (pe != last);
  820. }
  821. return r;
  822. }
  823. /*
  824. * Called on a write from the origin driver.
  825. */
  826. static int do_origin(struct dm_dev *origin, struct bio *bio)
  827. {
  828. struct origin *o;
  829. int r = 1;
  830. down_read(&_origins_lock);
  831. o = __lookup_origin(origin->bdev);
  832. if (o)
  833. r = __origin_write(&o->snapshots, bio);
  834. up_read(&_origins_lock);
  835. return r;
  836. }
  837. /*
  838. * Origin: maps a linear range of a device, with hooks for snapshotting.
  839. */
  840. /*
  841. * Construct an origin mapping: <dev_path>
  842. * The context for an origin is merely a 'struct dm_dev *'
  843. * pointing to the real device.
  844. */
  845. static int origin_ctr(struct dm_target *ti, unsigned int argc, char **argv)
  846. {
  847. int r;
  848. struct dm_dev *dev;
  849. if (argc != 1) {
  850. ti->error = "dm-origin: incorrect number of arguments";
  851. return -EINVAL;
  852. }
  853. r = dm_get_device(ti, argv[0], 0, ti->len,
  854. dm_table_get_mode(ti->table), &dev);
  855. if (r) {
  856. ti->error = "Cannot get target device";
  857. return r;
  858. }
  859. ti->private = dev;
  860. return 0;
  861. }
  862. static void origin_dtr(struct dm_target *ti)
  863. {
  864. struct dm_dev *dev = (struct dm_dev *) ti->private;
  865. dm_put_device(ti, dev);
  866. }
  867. static int origin_map(struct dm_target *ti, struct bio *bio,
  868. union map_info *map_context)
  869. {
  870. struct dm_dev *dev = (struct dm_dev *) ti->private;
  871. bio->bi_bdev = dev->bdev;
  872. /* Only tell snapshots if this is a write */
  873. return (bio_rw(bio) == WRITE) ? do_origin(dev, bio) : 1;
  874. }
  875. #define min_not_zero(l, r) (l == 0) ? r : ((r == 0) ? l : min(l, r))
  876. /*
  877. * Set the target "split_io" field to the minimum of all the snapshots'
  878. * chunk sizes.
  879. */
  880. static void origin_resume(struct dm_target *ti)
  881. {
  882. struct dm_dev *dev = (struct dm_dev *) ti->private;
  883. struct dm_snapshot *snap;
  884. struct origin *o;
  885. chunk_t chunk_size = 0;
  886. down_read(&_origins_lock);
  887. o = __lookup_origin(dev->bdev);
  888. if (o)
  889. list_for_each_entry (snap, &o->snapshots, list)
  890. chunk_size = min_not_zero(chunk_size, snap->chunk_size);
  891. up_read(&_origins_lock);
  892. ti->split_io = chunk_size;
  893. }
  894. static int origin_status(struct dm_target *ti, status_type_t type, char *result,
  895. unsigned int maxlen)
  896. {
  897. struct dm_dev *dev = (struct dm_dev *) ti->private;
  898. switch (type) {
  899. case STATUSTYPE_INFO:
  900. result[0] = '\0';
  901. break;
  902. case STATUSTYPE_TABLE:
  903. snprintf(result, maxlen, "%s", dev->name);
  904. break;
  905. }
  906. return 0;
  907. }
  908. static struct target_type origin_target = {
  909. .name = "snapshot-origin",
  910. .version = {1, 1, 0},
  911. .module = THIS_MODULE,
  912. .ctr = origin_ctr,
  913. .dtr = origin_dtr,
  914. .map = origin_map,
  915. .resume = origin_resume,
  916. .status = origin_status,
  917. };
  918. static struct target_type snapshot_target = {
  919. .name = "snapshot",
  920. .version = {1, 1, 0},
  921. .module = THIS_MODULE,
  922. .ctr = snapshot_ctr,
  923. .dtr = snapshot_dtr,
  924. .map = snapshot_map,
  925. .resume = snapshot_resume,
  926. .status = snapshot_status,
  927. };
  928. static int __init dm_snapshot_init(void)
  929. {
  930. int r;
  931. r = dm_register_target(&snapshot_target);
  932. if (r) {
  933. DMERR("snapshot target register failed %d", r);
  934. return r;
  935. }
  936. r = dm_register_target(&origin_target);
  937. if (r < 0) {
  938. DMERR("Device mapper: Origin: register failed %d\n", r);
  939. goto bad1;
  940. }
  941. r = init_origin_hash();
  942. if (r) {
  943. DMERR("init_origin_hash failed.");
  944. goto bad2;
  945. }
  946. exception_cache = kmem_cache_create("dm-snapshot-ex",
  947. sizeof(struct exception),
  948. __alignof__(struct exception),
  949. 0, NULL, NULL);
  950. if (!exception_cache) {
  951. DMERR("Couldn't create exception cache.");
  952. r = -ENOMEM;
  953. goto bad3;
  954. }
  955. pending_cache =
  956. kmem_cache_create("dm-snapshot-in",
  957. sizeof(struct pending_exception),
  958. __alignof__(struct pending_exception),
  959. 0, NULL, NULL);
  960. if (!pending_cache) {
  961. DMERR("Couldn't create pending cache.");
  962. r = -ENOMEM;
  963. goto bad4;
  964. }
  965. pending_pool = mempool_create(128, mempool_alloc_slab,
  966. mempool_free_slab, pending_cache);
  967. if (!pending_pool) {
  968. DMERR("Couldn't create pending pool.");
  969. r = -ENOMEM;
  970. goto bad5;
  971. }
  972. return 0;
  973. bad5:
  974. kmem_cache_destroy(pending_cache);
  975. bad4:
  976. kmem_cache_destroy(exception_cache);
  977. bad3:
  978. exit_origin_hash();
  979. bad2:
  980. dm_unregister_target(&origin_target);
  981. bad1:
  982. dm_unregister_target(&snapshot_target);
  983. return r;
  984. }
  985. static void __exit dm_snapshot_exit(void)
  986. {
  987. int r;
  988. r = dm_unregister_target(&snapshot_target);
  989. if (r)
  990. DMERR("snapshot unregister failed %d", r);
  991. r = dm_unregister_target(&origin_target);
  992. if (r)
  993. DMERR("origin unregister failed %d", r);
  994. exit_origin_hash();
  995. mempool_destroy(pending_pool);
  996. kmem_cache_destroy(pending_cache);
  997. kmem_cache_destroy(exception_cache);
  998. }
  999. /* Module hooks */
  1000. module_init(dm_snapshot_init);
  1001. module_exit(dm_snapshot_exit);
  1002. MODULE_DESCRIPTION(DM_NAME " snapshot target");
  1003. MODULE_AUTHOR("Joe Thornber");
  1004. MODULE_LICENSE("GPL");