dm-snap.c 25 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208
  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. /*
  304. * Construct a snapshot mapping: <origin_dev> <COW-dev> <p/n> <chunk-size>
  305. */
  306. static int snapshot_ctr(struct dm_target *ti, unsigned int argc, char **argv)
  307. {
  308. struct dm_snapshot *s;
  309. unsigned long chunk_size;
  310. int r = -EINVAL;
  311. char persistent;
  312. char *origin_path;
  313. char *cow_path;
  314. char *value;
  315. int blocksize;
  316. if (argc < 4) {
  317. ti->error = "dm-snapshot: requires exactly 4 arguments";
  318. r = -EINVAL;
  319. goto bad1;
  320. }
  321. origin_path = argv[0];
  322. cow_path = argv[1];
  323. persistent = toupper(*argv[2]);
  324. if (persistent != 'P' && persistent != 'N') {
  325. ti->error = "Persistent flag is not P or N";
  326. r = -EINVAL;
  327. goto bad1;
  328. }
  329. chunk_size = simple_strtoul(argv[3], &value, 10);
  330. if (chunk_size == 0 || value == NULL) {
  331. ti->error = "Invalid chunk size";
  332. r = -EINVAL;
  333. goto bad1;
  334. }
  335. s = kmalloc(sizeof(*s), GFP_KERNEL);
  336. if (s == NULL) {
  337. ti->error = "Cannot allocate snapshot context private "
  338. "structure";
  339. r = -ENOMEM;
  340. goto bad1;
  341. }
  342. r = dm_get_device(ti, origin_path, 0, ti->len, FMODE_READ, &s->origin);
  343. if (r) {
  344. ti->error = "Cannot get origin device";
  345. goto bad2;
  346. }
  347. r = dm_get_device(ti, cow_path, 0, 0,
  348. FMODE_READ | FMODE_WRITE, &s->cow);
  349. if (r) {
  350. dm_put_device(ti, s->origin);
  351. ti->error = "Cannot get COW device";
  352. goto bad2;
  353. }
  354. /*
  355. * Chunk size must be multiple of page size. Silently
  356. * round up if it's not.
  357. */
  358. chunk_size = round_up(chunk_size, PAGE_SIZE >> 9);
  359. /* Validate the chunk size against the device block size */
  360. blocksize = s->cow->bdev->bd_disk->queue->hardsect_size;
  361. if (chunk_size % (blocksize >> 9)) {
  362. ti->error = "Chunk size is not a multiple of device blocksize";
  363. r = -EINVAL;
  364. goto bad3;
  365. }
  366. /* Check chunk_size is a power of 2 */
  367. if (chunk_size & (chunk_size - 1)) {
  368. ti->error = "Chunk size is not a power of 2";
  369. r = -EINVAL;
  370. goto bad3;
  371. }
  372. s->chunk_size = chunk_size;
  373. s->chunk_mask = chunk_size - 1;
  374. s->type = persistent;
  375. s->chunk_shift = ffs(chunk_size) - 1;
  376. s->valid = 1;
  377. s->have_metadata = 0;
  378. s->last_percent = 0;
  379. init_rwsem(&s->lock);
  380. s->table = ti->table;
  381. /* Allocate hash table for COW data */
  382. if (init_hash_tables(s)) {
  383. ti->error = "Unable to allocate hash table space";
  384. r = -ENOMEM;
  385. goto bad3;
  386. }
  387. /*
  388. * Check the persistent flag - done here because we need the iobuf
  389. * to check the LV header
  390. */
  391. s->store.snap = s;
  392. if (persistent == 'P')
  393. r = dm_create_persistent(&s->store, chunk_size);
  394. else
  395. r = dm_create_transient(&s->store, s, blocksize);
  396. if (r) {
  397. ti->error = "Couldn't create exception store";
  398. r = -EINVAL;
  399. goto bad4;
  400. }
  401. r = kcopyd_client_create(SNAPSHOT_PAGES, &s->kcopyd_client);
  402. if (r) {
  403. ti->error = "Could not create kcopyd client";
  404. goto bad5;
  405. }
  406. /* Add snapshot to the list of snapshots for this origin */
  407. if (register_snapshot(s)) {
  408. r = -EINVAL;
  409. ti->error = "Cannot register snapshot origin";
  410. goto bad6;
  411. }
  412. ti->private = s;
  413. ti->split_io = chunk_size;
  414. return 0;
  415. bad6:
  416. kcopyd_client_destroy(s->kcopyd_client);
  417. bad5:
  418. s->store.destroy(&s->store);
  419. bad4:
  420. exit_exception_table(&s->pending, pending_cache);
  421. exit_exception_table(&s->complete, exception_cache);
  422. bad3:
  423. dm_put_device(ti, s->cow);
  424. dm_put_device(ti, s->origin);
  425. bad2:
  426. kfree(s);
  427. bad1:
  428. return r;
  429. }
  430. static void snapshot_dtr(struct dm_target *ti)
  431. {
  432. struct dm_snapshot *s = (struct dm_snapshot *) ti->private;
  433. unregister_snapshot(s);
  434. exit_exception_table(&s->pending, pending_cache);
  435. exit_exception_table(&s->complete, exception_cache);
  436. /* Deallocate memory used */
  437. s->store.destroy(&s->store);
  438. dm_put_device(ti, s->origin);
  439. dm_put_device(ti, s->cow);
  440. kcopyd_client_destroy(s->kcopyd_client);
  441. kfree(s);
  442. }
  443. /*
  444. * Flush a list of buffers.
  445. */
  446. static void flush_bios(struct bio *bio)
  447. {
  448. struct bio *n;
  449. while (bio) {
  450. n = bio->bi_next;
  451. bio->bi_next = NULL;
  452. generic_make_request(bio);
  453. bio = n;
  454. }
  455. }
  456. /*
  457. * Error a list of buffers.
  458. */
  459. static void error_bios(struct bio *bio)
  460. {
  461. struct bio *n;
  462. while (bio) {
  463. n = bio->bi_next;
  464. bio->bi_next = NULL;
  465. bio_io_error(bio, bio->bi_size);
  466. bio = n;
  467. }
  468. }
  469. static struct bio *__flush_bios(struct pending_exception *pe)
  470. {
  471. struct pending_exception *sibling;
  472. if (list_empty(&pe->siblings))
  473. return bio_list_get(&pe->origin_bios);
  474. sibling = list_entry(pe->siblings.next,
  475. struct pending_exception, siblings);
  476. list_del(&pe->siblings);
  477. /* This is fine as long as kcopyd is single-threaded. If kcopyd
  478. * becomes multi-threaded, we'll need some locking here.
  479. */
  480. bio_list_merge(&sibling->origin_bios, &pe->origin_bios);
  481. return NULL;
  482. }
  483. static void pending_complete(struct pending_exception *pe, int success)
  484. {
  485. struct exception *e;
  486. struct dm_snapshot *s = pe->snap;
  487. struct bio *flush = NULL;
  488. if (success) {
  489. e = alloc_exception();
  490. if (!e) {
  491. DMWARN("Unable to allocate exception.");
  492. down_write(&s->lock);
  493. s->store.drop_snapshot(&s->store);
  494. s->valid = 0;
  495. flush = __flush_bios(pe);
  496. up_write(&s->lock);
  497. error_bios(bio_list_get(&pe->snapshot_bios));
  498. goto out;
  499. }
  500. *e = pe->e;
  501. /*
  502. * Add a proper exception, and remove the
  503. * in-flight exception from the list.
  504. */
  505. down_write(&s->lock);
  506. insert_exception(&s->complete, e);
  507. remove_exception(&pe->e);
  508. flush = __flush_bios(pe);
  509. /* Submit any pending write bios */
  510. up_write(&s->lock);
  511. flush_bios(bio_list_get(&pe->snapshot_bios));
  512. } else {
  513. /* Read/write error - snapshot is unusable */
  514. down_write(&s->lock);
  515. if (s->valid)
  516. DMERR("Error reading/writing snapshot");
  517. s->store.drop_snapshot(&s->store);
  518. s->valid = 0;
  519. remove_exception(&pe->e);
  520. flush = __flush_bios(pe);
  521. up_write(&s->lock);
  522. error_bios(bio_list_get(&pe->snapshot_bios));
  523. dm_table_event(s->table);
  524. }
  525. out:
  526. free_pending_exception(pe);
  527. if (flush)
  528. flush_bios(flush);
  529. }
  530. static void commit_callback(void *context, int success)
  531. {
  532. struct pending_exception *pe = (struct pending_exception *) context;
  533. pending_complete(pe, success);
  534. }
  535. /*
  536. * Called when the copy I/O has finished. kcopyd actually runs
  537. * this code so don't block.
  538. */
  539. static void copy_callback(int read_err, unsigned int write_err, void *context)
  540. {
  541. struct pending_exception *pe = (struct pending_exception *) context;
  542. struct dm_snapshot *s = pe->snap;
  543. if (read_err || write_err)
  544. pending_complete(pe, 0);
  545. else
  546. /* Update the metadata if we are persistent */
  547. s->store.commit_exception(&s->store, &pe->e, commit_callback,
  548. pe);
  549. }
  550. /*
  551. * Dispatches the copy operation to kcopyd.
  552. */
  553. static inline void start_copy(struct pending_exception *pe)
  554. {
  555. struct dm_snapshot *s = pe->snap;
  556. struct io_region src, dest;
  557. struct block_device *bdev = s->origin->bdev;
  558. sector_t dev_size;
  559. dev_size = get_dev_size(bdev);
  560. src.bdev = bdev;
  561. src.sector = chunk_to_sector(s, pe->e.old_chunk);
  562. src.count = min(s->chunk_size, dev_size - src.sector);
  563. dest.bdev = s->cow->bdev;
  564. dest.sector = chunk_to_sector(s, pe->e.new_chunk);
  565. dest.count = src.count;
  566. /* Hand over to kcopyd */
  567. kcopyd_copy(s->kcopyd_client,
  568. &src, 1, &dest, 0, copy_callback, pe);
  569. }
  570. /*
  571. * Looks to see if this snapshot already has a pending exception
  572. * for this chunk, otherwise it allocates a new one and inserts
  573. * it into the pending table.
  574. *
  575. * NOTE: a write lock must be held on snap->lock before calling
  576. * this.
  577. */
  578. static struct pending_exception *
  579. __find_pending_exception(struct dm_snapshot *s, struct bio *bio)
  580. {
  581. struct exception *e;
  582. struct pending_exception *pe;
  583. chunk_t chunk = sector_to_chunk(s, bio->bi_sector);
  584. /*
  585. * Is there a pending exception for this already ?
  586. */
  587. e = lookup_exception(&s->pending, chunk);
  588. if (e) {
  589. /* cast the exception to a pending exception */
  590. pe = container_of(e, struct pending_exception, e);
  591. } else {
  592. /*
  593. * Create a new pending exception, we don't want
  594. * to hold the lock while we do this.
  595. */
  596. up_write(&s->lock);
  597. pe = alloc_pending_exception();
  598. down_write(&s->lock);
  599. e = lookup_exception(&s->pending, chunk);
  600. if (e) {
  601. free_pending_exception(pe);
  602. pe = container_of(e, struct pending_exception, e);
  603. } else {
  604. pe->e.old_chunk = chunk;
  605. bio_list_init(&pe->origin_bios);
  606. bio_list_init(&pe->snapshot_bios);
  607. INIT_LIST_HEAD(&pe->siblings);
  608. pe->snap = s;
  609. pe->started = 0;
  610. if (s->store.prepare_exception(&s->store, &pe->e)) {
  611. free_pending_exception(pe);
  612. s->valid = 0;
  613. return NULL;
  614. }
  615. insert_exception(&s->pending, &pe->e);
  616. }
  617. }
  618. return pe;
  619. }
  620. static inline void remap_exception(struct dm_snapshot *s, struct exception *e,
  621. struct bio *bio)
  622. {
  623. bio->bi_bdev = s->cow->bdev;
  624. bio->bi_sector = chunk_to_sector(s, e->new_chunk) +
  625. (bio->bi_sector & s->chunk_mask);
  626. }
  627. static int snapshot_map(struct dm_target *ti, struct bio *bio,
  628. union map_info *map_context)
  629. {
  630. struct exception *e;
  631. struct dm_snapshot *s = (struct dm_snapshot *) ti->private;
  632. int r = 1;
  633. chunk_t chunk;
  634. struct pending_exception *pe;
  635. chunk = sector_to_chunk(s, bio->bi_sector);
  636. /* Full snapshots are not usable */
  637. if (!s->valid)
  638. return -EIO;
  639. /*
  640. * Write to snapshot - higher level takes care of RW/RO
  641. * flags so we should only get this if we are
  642. * writeable.
  643. */
  644. if (bio_rw(bio) == WRITE) {
  645. /* FIXME: should only take write lock if we need
  646. * to copy an exception */
  647. down_write(&s->lock);
  648. /* If the block is already remapped - use that, else remap it */
  649. e = lookup_exception(&s->complete, chunk);
  650. if (e) {
  651. remap_exception(s, e, bio);
  652. up_write(&s->lock);
  653. } else {
  654. pe = __find_pending_exception(s, bio);
  655. if (!pe) {
  656. if (s->store.drop_snapshot)
  657. s->store.drop_snapshot(&s->store);
  658. s->valid = 0;
  659. r = -EIO;
  660. up_write(&s->lock);
  661. } else {
  662. remap_exception(s, &pe->e, bio);
  663. bio_list_add(&pe->snapshot_bios, bio);
  664. if (!pe->started) {
  665. /* this is protected by snap->lock */
  666. pe->started = 1;
  667. up_write(&s->lock);
  668. start_copy(pe);
  669. } else
  670. up_write(&s->lock);
  671. r = 0;
  672. }
  673. }
  674. } else {
  675. /*
  676. * FIXME: this read path scares me because we
  677. * always use the origin when we have a pending
  678. * exception. However I can't think of a
  679. * situation where this is wrong - ejt.
  680. */
  681. /* Do reads */
  682. down_read(&s->lock);
  683. /* See if it it has been remapped */
  684. e = lookup_exception(&s->complete, chunk);
  685. if (e)
  686. remap_exception(s, e, bio);
  687. else
  688. bio->bi_bdev = s->origin->bdev;
  689. up_read(&s->lock);
  690. }
  691. return r;
  692. }
  693. static void snapshot_resume(struct dm_target *ti)
  694. {
  695. struct dm_snapshot *s = (struct dm_snapshot *) ti->private;
  696. if (s->have_metadata)
  697. return;
  698. if (s->store.read_metadata(&s->store)) {
  699. down_write(&s->lock);
  700. s->valid = 0;
  701. up_write(&s->lock);
  702. }
  703. s->have_metadata = 1;
  704. }
  705. static int snapshot_status(struct dm_target *ti, status_type_t type,
  706. char *result, unsigned int maxlen)
  707. {
  708. struct dm_snapshot *snap = (struct dm_snapshot *) ti->private;
  709. switch (type) {
  710. case STATUSTYPE_INFO:
  711. if (!snap->valid)
  712. snprintf(result, maxlen, "Invalid");
  713. else {
  714. if (snap->store.fraction_full) {
  715. sector_t numerator, denominator;
  716. snap->store.fraction_full(&snap->store,
  717. &numerator,
  718. &denominator);
  719. snprintf(result, maxlen,
  720. SECTOR_FORMAT "/" SECTOR_FORMAT,
  721. numerator, denominator);
  722. }
  723. else
  724. snprintf(result, maxlen, "Unknown");
  725. }
  726. break;
  727. case STATUSTYPE_TABLE:
  728. /*
  729. * kdevname returns a static pointer so we need
  730. * to make private copies if the output is to
  731. * make sense.
  732. */
  733. snprintf(result, maxlen, "%s %s %c " SECTOR_FORMAT,
  734. snap->origin->name, snap->cow->name,
  735. snap->type, snap->chunk_size);
  736. break;
  737. }
  738. return 0;
  739. }
  740. /*-----------------------------------------------------------------
  741. * Origin methods
  742. *---------------------------------------------------------------*/
  743. static void list_merge(struct list_head *l1, struct list_head *l2)
  744. {
  745. struct list_head *l1_n, *l2_p;
  746. l1_n = l1->next;
  747. l2_p = l2->prev;
  748. l1->next = l2;
  749. l2->prev = l1;
  750. l2_p->next = l1_n;
  751. l1_n->prev = l2_p;
  752. }
  753. static int __origin_write(struct list_head *snapshots, struct bio *bio)
  754. {
  755. int r = 1, first = 1;
  756. struct dm_snapshot *snap;
  757. struct exception *e;
  758. struct pending_exception *pe, *last = NULL;
  759. chunk_t chunk;
  760. /* Do all the snapshots on this origin */
  761. list_for_each_entry (snap, snapshots, list) {
  762. /* Only deal with valid snapshots */
  763. if (!snap->valid)
  764. continue;
  765. down_write(&snap->lock);
  766. /*
  767. * Remember, different snapshots can have
  768. * different chunk sizes.
  769. */
  770. chunk = sector_to_chunk(snap, bio->bi_sector);
  771. /*
  772. * Check exception table to see if block
  773. * is already remapped in this snapshot
  774. * and trigger an exception if not.
  775. */
  776. e = lookup_exception(&snap->complete, chunk);
  777. if (!e) {
  778. pe = __find_pending_exception(snap, bio);
  779. if (!pe) {
  780. snap->store.drop_snapshot(&snap->store);
  781. snap->valid = 0;
  782. } else {
  783. if (last)
  784. list_merge(&pe->siblings,
  785. &last->siblings);
  786. last = pe;
  787. r = 0;
  788. }
  789. }
  790. up_write(&snap->lock);
  791. }
  792. /*
  793. * Now that we have a complete pe list we can start the copying.
  794. */
  795. if (last) {
  796. pe = last;
  797. do {
  798. down_write(&pe->snap->lock);
  799. if (first)
  800. bio_list_add(&pe->origin_bios, bio);
  801. if (!pe->started) {
  802. pe->started = 1;
  803. up_write(&pe->snap->lock);
  804. start_copy(pe);
  805. } else
  806. up_write(&pe->snap->lock);
  807. first = 0;
  808. pe = list_entry(pe->siblings.next,
  809. struct pending_exception, siblings);
  810. } while (pe != last);
  811. }
  812. return r;
  813. }
  814. /*
  815. * Called on a write from the origin driver.
  816. */
  817. static int do_origin(struct dm_dev *origin, struct bio *bio)
  818. {
  819. struct origin *o;
  820. int r = 1;
  821. down_read(&_origins_lock);
  822. o = __lookup_origin(origin->bdev);
  823. if (o)
  824. r = __origin_write(&o->snapshots, bio);
  825. up_read(&_origins_lock);
  826. return r;
  827. }
  828. /*
  829. * Origin: maps a linear range of a device, with hooks for snapshotting.
  830. */
  831. /*
  832. * Construct an origin mapping: <dev_path>
  833. * The context for an origin is merely a 'struct dm_dev *'
  834. * pointing to the real device.
  835. */
  836. static int origin_ctr(struct dm_target *ti, unsigned int argc, char **argv)
  837. {
  838. int r;
  839. struct dm_dev *dev;
  840. if (argc != 1) {
  841. ti->error = "dm-origin: incorrect number of arguments";
  842. return -EINVAL;
  843. }
  844. r = dm_get_device(ti, argv[0], 0, ti->len,
  845. dm_table_get_mode(ti->table), &dev);
  846. if (r) {
  847. ti->error = "Cannot get target device";
  848. return r;
  849. }
  850. ti->private = dev;
  851. return 0;
  852. }
  853. static void origin_dtr(struct dm_target *ti)
  854. {
  855. struct dm_dev *dev = (struct dm_dev *) ti->private;
  856. dm_put_device(ti, dev);
  857. }
  858. static int origin_map(struct dm_target *ti, struct bio *bio,
  859. union map_info *map_context)
  860. {
  861. struct dm_dev *dev = (struct dm_dev *) ti->private;
  862. bio->bi_bdev = dev->bdev;
  863. /* Only tell snapshots if this is a write */
  864. return (bio_rw(bio) == WRITE) ? do_origin(dev, bio) : 1;
  865. }
  866. #define min_not_zero(l, r) (l == 0) ? r : ((r == 0) ? l : min(l, r))
  867. /*
  868. * Set the target "split_io" field to the minimum of all the snapshots'
  869. * chunk sizes.
  870. */
  871. static void origin_resume(struct dm_target *ti)
  872. {
  873. struct dm_dev *dev = (struct dm_dev *) ti->private;
  874. struct dm_snapshot *snap;
  875. struct origin *o;
  876. chunk_t chunk_size = 0;
  877. down_read(&_origins_lock);
  878. o = __lookup_origin(dev->bdev);
  879. if (o)
  880. list_for_each_entry (snap, &o->snapshots, list)
  881. chunk_size = min_not_zero(chunk_size, snap->chunk_size);
  882. up_read(&_origins_lock);
  883. ti->split_io = chunk_size;
  884. }
  885. static int origin_status(struct dm_target *ti, status_type_t type, char *result,
  886. unsigned int maxlen)
  887. {
  888. struct dm_dev *dev = (struct dm_dev *) ti->private;
  889. switch (type) {
  890. case STATUSTYPE_INFO:
  891. result[0] = '\0';
  892. break;
  893. case STATUSTYPE_TABLE:
  894. snprintf(result, maxlen, "%s", dev->name);
  895. break;
  896. }
  897. return 0;
  898. }
  899. static struct target_type origin_target = {
  900. .name = "snapshot-origin",
  901. .version = {1, 0, 1},
  902. .module = THIS_MODULE,
  903. .ctr = origin_ctr,
  904. .dtr = origin_dtr,
  905. .map = origin_map,
  906. .resume = origin_resume,
  907. .status = origin_status,
  908. };
  909. static struct target_type snapshot_target = {
  910. .name = "snapshot",
  911. .version = {1, 0, 1},
  912. .module = THIS_MODULE,
  913. .ctr = snapshot_ctr,
  914. .dtr = snapshot_dtr,
  915. .map = snapshot_map,
  916. .resume = snapshot_resume,
  917. .status = snapshot_status,
  918. };
  919. static int __init dm_snapshot_init(void)
  920. {
  921. int r;
  922. r = dm_register_target(&snapshot_target);
  923. if (r) {
  924. DMERR("snapshot target register failed %d", r);
  925. return r;
  926. }
  927. r = dm_register_target(&origin_target);
  928. if (r < 0) {
  929. DMERR("Device mapper: Origin: register failed %d\n", r);
  930. goto bad1;
  931. }
  932. r = init_origin_hash();
  933. if (r) {
  934. DMERR("init_origin_hash failed.");
  935. goto bad2;
  936. }
  937. exception_cache = kmem_cache_create("dm-snapshot-ex",
  938. sizeof(struct exception),
  939. __alignof__(struct exception),
  940. 0, NULL, NULL);
  941. if (!exception_cache) {
  942. DMERR("Couldn't create exception cache.");
  943. r = -ENOMEM;
  944. goto bad3;
  945. }
  946. pending_cache =
  947. kmem_cache_create("dm-snapshot-in",
  948. sizeof(struct pending_exception),
  949. __alignof__(struct pending_exception),
  950. 0, NULL, NULL);
  951. if (!pending_cache) {
  952. DMERR("Couldn't create pending cache.");
  953. r = -ENOMEM;
  954. goto bad4;
  955. }
  956. pending_pool = mempool_create(128, mempool_alloc_slab,
  957. mempool_free_slab, pending_cache);
  958. if (!pending_pool) {
  959. DMERR("Couldn't create pending pool.");
  960. r = -ENOMEM;
  961. goto bad5;
  962. }
  963. return 0;
  964. bad5:
  965. kmem_cache_destroy(pending_cache);
  966. bad4:
  967. kmem_cache_destroy(exception_cache);
  968. bad3:
  969. exit_origin_hash();
  970. bad2:
  971. dm_unregister_target(&origin_target);
  972. bad1:
  973. dm_unregister_target(&snapshot_target);
  974. return r;
  975. }
  976. static void __exit dm_snapshot_exit(void)
  977. {
  978. int r;
  979. r = dm_unregister_target(&snapshot_target);
  980. if (r)
  981. DMERR("snapshot unregister failed %d", r);
  982. r = dm_unregister_target(&origin_target);
  983. if (r)
  984. DMERR("origin unregister failed %d", r);
  985. exit_origin_hash();
  986. mempool_destroy(pending_pool);
  987. kmem_cache_destroy(pending_cache);
  988. kmem_cache_destroy(exception_cache);
  989. }
  990. /* Module hooks */
  991. module_init(dm_snapshot_init);
  992. module_exit(dm_snapshot_exit);
  993. MODULE_DESCRIPTION(DM_NAME " snapshot target");
  994. MODULE_AUTHOR("Joe Thornber");
  995. MODULE_LICENSE("GPL");