bio-integrity.c 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515
  1. /*
  2. * bio-integrity.c - bio data integrity extensions
  3. *
  4. * Copyright (C) 2007, 2008, 2009 Oracle Corporation
  5. * Written by: Martin K. Petersen <martin.petersen@oracle.com>
  6. *
  7. * This program is free software; you can redistribute it and/or
  8. * modify it under the terms of the GNU General Public License version
  9. * 2 as published by the Free Software Foundation.
  10. *
  11. * This program is distributed in the hope that it will be useful, but
  12. * WITHOUT ANY WARRANTY; without even the implied warranty of
  13. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  14. * General Public License for more details.
  15. *
  16. * You should have received a copy of the GNU General Public License
  17. * along with this program; see the file COPYING. If not, write to
  18. * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139,
  19. * USA.
  20. *
  21. */
  22. #include <linux/blkdev.h>
  23. #include <linux/mempool.h>
  24. #include <linux/export.h>
  25. #include <linux/bio.h>
  26. #include <linux/workqueue.h>
  27. #include <linux/slab.h>
  28. #include "blk.h"
  29. #define BIP_INLINE_VECS 4
  30. static struct kmem_cache *bip_slab;
  31. static struct workqueue_struct *kintegrityd_wq;
  32. void blk_flush_integrity(void)
  33. {
  34. flush_workqueue(kintegrityd_wq);
  35. }
  36. /**
  37. * bio_integrity_alloc - Allocate integrity payload and attach it to bio
  38. * @bio: bio to attach integrity metadata to
  39. * @gfp_mask: Memory allocation mask
  40. * @nr_vecs: Number of integrity metadata scatter-gather elements
  41. *
  42. * Description: This function prepares a bio for attaching integrity
  43. * metadata. nr_vecs specifies the maximum number of pages containing
  44. * integrity metadata that can be attached.
  45. */
  46. struct bio_integrity_payload *bio_integrity_alloc(struct bio *bio,
  47. gfp_t gfp_mask,
  48. unsigned int nr_vecs)
  49. {
  50. struct bio_integrity_payload *bip;
  51. struct bio_set *bs = bio->bi_pool;
  52. unsigned inline_vecs;
  53. if (!bs || !bs->bio_integrity_pool) {
  54. bip = kmalloc(sizeof(struct bio_integrity_payload) +
  55. sizeof(struct bio_vec) * nr_vecs, gfp_mask);
  56. inline_vecs = nr_vecs;
  57. } else {
  58. bip = mempool_alloc(bs->bio_integrity_pool, gfp_mask);
  59. inline_vecs = BIP_INLINE_VECS;
  60. }
  61. if (unlikely(!bip))
  62. return ERR_PTR(-ENOMEM);
  63. memset(bip, 0, sizeof(*bip));
  64. if (nr_vecs > inline_vecs) {
  65. unsigned long idx = 0;
  66. bip->bip_vec = bvec_alloc(gfp_mask, nr_vecs, &idx,
  67. bs->bvec_integrity_pool);
  68. if (!bip->bip_vec)
  69. goto err;
  70. bip->bip_max_vcnt = bvec_nr_vecs(idx);
  71. bip->bip_slab = idx;
  72. } else {
  73. bip->bip_vec = bip->bip_inline_vecs;
  74. bip->bip_max_vcnt = inline_vecs;
  75. }
  76. bip->bip_bio = bio;
  77. bio->bi_integrity = bip;
  78. bio->bi_opf |= REQ_INTEGRITY;
  79. return bip;
  80. err:
  81. mempool_free(bip, bs->bio_integrity_pool);
  82. return ERR_PTR(-ENOMEM);
  83. }
  84. EXPORT_SYMBOL(bio_integrity_alloc);
  85. /**
  86. * bio_integrity_free - Free bio integrity payload
  87. * @bio: bio containing bip to be freed
  88. *
  89. * Description: Used to free the integrity portion of a bio. Usually
  90. * called from bio_free().
  91. */
  92. static void bio_integrity_free(struct bio *bio)
  93. {
  94. struct bio_integrity_payload *bip = bio_integrity(bio);
  95. struct bio_set *bs = bio->bi_pool;
  96. if (bip->bip_flags & BIP_BLOCK_INTEGRITY)
  97. kfree(page_address(bip->bip_vec->bv_page) +
  98. bip->bip_vec->bv_offset);
  99. if (bs && bs->bio_integrity_pool) {
  100. bvec_free(bs->bvec_integrity_pool, bip->bip_vec, bip->bip_slab);
  101. mempool_free(bip, bs->bio_integrity_pool);
  102. } else {
  103. kfree(bip);
  104. }
  105. bio->bi_integrity = NULL;
  106. bio->bi_opf &= ~REQ_INTEGRITY;
  107. }
  108. /**
  109. * bio_integrity_add_page - Attach integrity metadata
  110. * @bio: bio to update
  111. * @page: page containing integrity metadata
  112. * @len: number of bytes of integrity metadata in page
  113. * @offset: start offset within page
  114. *
  115. * Description: Attach a page containing integrity metadata to bio.
  116. */
  117. int bio_integrity_add_page(struct bio *bio, struct page *page,
  118. unsigned int len, unsigned int offset)
  119. {
  120. struct bio_integrity_payload *bip = bio_integrity(bio);
  121. struct bio_vec *iv;
  122. if (bip->bip_vcnt >= bip->bip_max_vcnt) {
  123. printk(KERN_ERR "%s: bip_vec full\n", __func__);
  124. return 0;
  125. }
  126. iv = bip->bip_vec + bip->bip_vcnt;
  127. if (bip->bip_vcnt &&
  128. bvec_gap_to_prev(bio->bi_disk->queue,
  129. &bip->bip_vec[bip->bip_vcnt - 1], offset))
  130. return 0;
  131. iv->bv_page = page;
  132. iv->bv_len = len;
  133. iv->bv_offset = offset;
  134. bip->bip_vcnt++;
  135. return len;
  136. }
  137. EXPORT_SYMBOL(bio_integrity_add_page);
  138. /**
  139. * bio_integrity_intervals - Return number of integrity intervals for a bio
  140. * @bi: blk_integrity profile for device
  141. * @sectors: Size of the bio in 512-byte sectors
  142. *
  143. * Description: The block layer calculates everything in 512 byte
  144. * sectors but integrity metadata is done in terms of the data integrity
  145. * interval size of the storage device. Convert the block layer sectors
  146. * to the appropriate number of integrity intervals.
  147. */
  148. static inline unsigned int bio_integrity_intervals(struct blk_integrity *bi,
  149. unsigned int sectors)
  150. {
  151. return sectors >> (bi->interval_exp - 9);
  152. }
  153. static inline unsigned int bio_integrity_bytes(struct blk_integrity *bi,
  154. unsigned int sectors)
  155. {
  156. return bio_integrity_intervals(bi, sectors) * bi->tuple_size;
  157. }
  158. /**
  159. * bio_integrity_process - Process integrity metadata for a bio
  160. * @bio: bio to generate/verify integrity metadata for
  161. * @proc_iter: iterator to process
  162. * @proc_fn: Pointer to the relevant processing function
  163. */
  164. static blk_status_t bio_integrity_process(struct bio *bio,
  165. struct bvec_iter *proc_iter, integrity_processing_fn *proc_fn)
  166. {
  167. struct blk_integrity *bi = blk_get_integrity(bio->bi_disk);
  168. struct blk_integrity_iter iter;
  169. struct bvec_iter bviter;
  170. struct bio_vec bv;
  171. struct bio_integrity_payload *bip = bio_integrity(bio);
  172. blk_status_t ret = BLK_STS_OK;
  173. void *prot_buf = page_address(bip->bip_vec->bv_page) +
  174. bip->bip_vec->bv_offset;
  175. iter.disk_name = bio->bi_disk->disk_name;
  176. iter.interval = 1 << bi->interval_exp;
  177. iter.seed = proc_iter->bi_sector;
  178. iter.prot_buf = prot_buf;
  179. __bio_for_each_segment(bv, bio, bviter, *proc_iter) {
  180. void *kaddr = kmap_atomic(bv.bv_page);
  181. iter.data_buf = kaddr + bv.bv_offset;
  182. iter.data_size = bv.bv_len;
  183. ret = proc_fn(&iter);
  184. if (ret) {
  185. kunmap_atomic(kaddr);
  186. return ret;
  187. }
  188. kunmap_atomic(kaddr);
  189. }
  190. return ret;
  191. }
  192. /**
  193. * bio_integrity_prep - Prepare bio for integrity I/O
  194. * @bio: bio to prepare
  195. *
  196. * Description: Checks if the bio already has an integrity payload attached.
  197. * If it does, the payload has been generated by another kernel subsystem,
  198. * and we just pass it through. Otherwise allocates integrity payload.
  199. * The bio must have data direction, target device and start sector set priot
  200. * to calling. In the WRITE case, integrity metadata will be generated using
  201. * the block device's integrity function. In the READ case, the buffer
  202. * will be prepared for DMA and a suitable end_io handler set up.
  203. */
  204. bool bio_integrity_prep(struct bio *bio)
  205. {
  206. struct bio_integrity_payload *bip;
  207. struct blk_integrity *bi = blk_get_integrity(bio->bi_disk);
  208. struct request_queue *q = bio->bi_disk->queue;
  209. void *buf;
  210. unsigned long start, end;
  211. unsigned int len, nr_pages;
  212. unsigned int bytes, offset, i;
  213. unsigned int intervals;
  214. blk_status_t status;
  215. if (!bi)
  216. return true;
  217. if (bio_op(bio) != REQ_OP_READ && bio_op(bio) != REQ_OP_WRITE)
  218. return true;
  219. if (!bio_sectors(bio))
  220. return true;
  221. /* Already protected? */
  222. if (bio_integrity(bio))
  223. return true;
  224. if (bio_data_dir(bio) == READ) {
  225. if (!bi->profile->verify_fn ||
  226. !(bi->flags & BLK_INTEGRITY_VERIFY))
  227. return true;
  228. } else {
  229. if (!bi->profile->generate_fn ||
  230. !(bi->flags & BLK_INTEGRITY_GENERATE))
  231. return true;
  232. }
  233. intervals = bio_integrity_intervals(bi, bio_sectors(bio));
  234. /* Allocate kernel buffer for protection data */
  235. len = intervals * bi->tuple_size;
  236. buf = kmalloc(len, GFP_NOIO | q->bounce_gfp);
  237. status = BLK_STS_RESOURCE;
  238. if (unlikely(buf == NULL)) {
  239. printk(KERN_ERR "could not allocate integrity buffer\n");
  240. goto err_end_io;
  241. }
  242. end = (((unsigned long) buf) + len + PAGE_SIZE - 1) >> PAGE_SHIFT;
  243. start = ((unsigned long) buf) >> PAGE_SHIFT;
  244. nr_pages = end - start;
  245. /* Allocate bio integrity payload and integrity vectors */
  246. bip = bio_integrity_alloc(bio, GFP_NOIO, nr_pages);
  247. if (IS_ERR(bip)) {
  248. printk(KERN_ERR "could not allocate data integrity bioset\n");
  249. kfree(buf);
  250. status = BLK_STS_RESOURCE;
  251. goto err_end_io;
  252. }
  253. bip->bip_flags |= BIP_BLOCK_INTEGRITY;
  254. bip->bip_iter.bi_size = len;
  255. bip_set_seed(bip, bio->bi_iter.bi_sector);
  256. if (bi->flags & BLK_INTEGRITY_IP_CHECKSUM)
  257. bip->bip_flags |= BIP_IP_CHECKSUM;
  258. /* Map it */
  259. offset = offset_in_page(buf);
  260. for (i = 0 ; i < nr_pages ; i++) {
  261. int ret;
  262. bytes = PAGE_SIZE - offset;
  263. if (len <= 0)
  264. break;
  265. if (bytes > len)
  266. bytes = len;
  267. ret = bio_integrity_add_page(bio, virt_to_page(buf),
  268. bytes, offset);
  269. if (ret == 0) {
  270. printk(KERN_ERR "could not attach integrity payload\n");
  271. status = BLK_STS_RESOURCE;
  272. goto err_end_io;
  273. }
  274. if (ret < bytes)
  275. break;
  276. buf += bytes;
  277. len -= bytes;
  278. offset = 0;
  279. }
  280. /* Auto-generate integrity metadata if this is a write */
  281. if (bio_data_dir(bio) == WRITE) {
  282. bio_integrity_process(bio, &bio->bi_iter,
  283. bi->profile->generate_fn);
  284. }
  285. return true;
  286. err_end_io:
  287. bio->bi_status = status;
  288. bio_endio(bio);
  289. return false;
  290. }
  291. EXPORT_SYMBOL(bio_integrity_prep);
  292. /**
  293. * bio_integrity_verify_fn - Integrity I/O completion worker
  294. * @work: Work struct stored in bio to be verified
  295. *
  296. * Description: This workqueue function is called to complete a READ
  297. * request. The function verifies the transferred integrity metadata
  298. * and then calls the original bio end_io function.
  299. */
  300. static void bio_integrity_verify_fn(struct work_struct *work)
  301. {
  302. struct bio_integrity_payload *bip =
  303. container_of(work, struct bio_integrity_payload, bip_work);
  304. struct bio *bio = bip->bip_bio;
  305. struct blk_integrity *bi = blk_get_integrity(bio->bi_disk);
  306. struct bvec_iter iter = bio->bi_iter;
  307. /*
  308. * At the moment verify is called bio's iterator was advanced
  309. * during split and completion, we need to rewind iterator to
  310. * it's original position.
  311. */
  312. if (bio_rewind_iter(bio, &iter, iter.bi_done)) {
  313. bio->bi_status = bio_integrity_process(bio, &iter,
  314. bi->profile->verify_fn);
  315. } else {
  316. bio->bi_status = BLK_STS_IOERR;
  317. }
  318. bio_integrity_free(bio);
  319. bio_endio(bio);
  320. }
  321. /**
  322. * __bio_integrity_endio - Integrity I/O completion function
  323. * @bio: Protected bio
  324. * @error: Pointer to errno
  325. *
  326. * Description: Completion for integrity I/O
  327. *
  328. * Normally I/O completion is done in interrupt context. However,
  329. * verifying I/O integrity is a time-consuming task which must be run
  330. * in process context. This function postpones completion
  331. * accordingly.
  332. */
  333. bool __bio_integrity_endio(struct bio *bio)
  334. {
  335. struct blk_integrity *bi = blk_get_integrity(bio->bi_disk);
  336. struct bio_integrity_payload *bip = bio_integrity(bio);
  337. if (bio_op(bio) == REQ_OP_READ && !bio->bi_status &&
  338. (bip->bip_flags & BIP_BLOCK_INTEGRITY) && bi->profile->verify_fn) {
  339. INIT_WORK(&bip->bip_work, bio_integrity_verify_fn);
  340. queue_work(kintegrityd_wq, &bip->bip_work);
  341. return false;
  342. }
  343. bio_integrity_free(bio);
  344. return true;
  345. }
  346. /**
  347. * bio_integrity_advance - Advance integrity vector
  348. * @bio: bio whose integrity vector to update
  349. * @bytes_done: number of data bytes that have been completed
  350. *
  351. * Description: This function calculates how many integrity bytes the
  352. * number of completed data bytes correspond to and advances the
  353. * integrity vector accordingly.
  354. */
  355. void bio_integrity_advance(struct bio *bio, unsigned int bytes_done)
  356. {
  357. struct bio_integrity_payload *bip = bio_integrity(bio);
  358. struct blk_integrity *bi = blk_get_integrity(bio->bi_disk);
  359. unsigned bytes = bio_integrity_bytes(bi, bytes_done >> 9);
  360. bip->bip_iter.bi_sector += bytes_done >> 9;
  361. bvec_iter_advance(bip->bip_vec, &bip->bip_iter, bytes);
  362. }
  363. EXPORT_SYMBOL(bio_integrity_advance);
  364. /**
  365. * bio_integrity_trim - Trim integrity vector
  366. * @bio: bio whose integrity vector to update
  367. *
  368. * Description: Used to trim the integrity vector in a cloned bio.
  369. */
  370. void bio_integrity_trim(struct bio *bio)
  371. {
  372. struct bio_integrity_payload *bip = bio_integrity(bio);
  373. struct blk_integrity *bi = blk_get_integrity(bio->bi_disk);
  374. bip->bip_iter.bi_size = bio_integrity_bytes(bi, bio_sectors(bio));
  375. }
  376. EXPORT_SYMBOL(bio_integrity_trim);
  377. /**
  378. * bio_integrity_clone - Callback for cloning bios with integrity metadata
  379. * @bio: New bio
  380. * @bio_src: Original bio
  381. * @gfp_mask: Memory allocation mask
  382. *
  383. * Description: Called to allocate a bip when cloning a bio
  384. */
  385. int bio_integrity_clone(struct bio *bio, struct bio *bio_src,
  386. gfp_t gfp_mask)
  387. {
  388. struct bio_integrity_payload *bip_src = bio_integrity(bio_src);
  389. struct bio_integrity_payload *bip;
  390. BUG_ON(bip_src == NULL);
  391. bip = bio_integrity_alloc(bio, gfp_mask, bip_src->bip_vcnt);
  392. if (IS_ERR(bip))
  393. return PTR_ERR(bip);
  394. memcpy(bip->bip_vec, bip_src->bip_vec,
  395. bip_src->bip_vcnt * sizeof(struct bio_vec));
  396. bip->bip_vcnt = bip_src->bip_vcnt;
  397. bip->bip_iter = bip_src->bip_iter;
  398. return 0;
  399. }
  400. EXPORT_SYMBOL(bio_integrity_clone);
  401. int bioset_integrity_create(struct bio_set *bs, int pool_size)
  402. {
  403. if (bs->bio_integrity_pool)
  404. return 0;
  405. bs->bio_integrity_pool = mempool_create_slab_pool(pool_size, bip_slab);
  406. if (!bs->bio_integrity_pool)
  407. return -1;
  408. bs->bvec_integrity_pool = biovec_create_pool(pool_size);
  409. if (!bs->bvec_integrity_pool) {
  410. mempool_destroy(bs->bio_integrity_pool);
  411. return -1;
  412. }
  413. return 0;
  414. }
  415. EXPORT_SYMBOL(bioset_integrity_create);
  416. void bioset_integrity_free(struct bio_set *bs)
  417. {
  418. if (bs->bio_integrity_pool)
  419. mempool_destroy(bs->bio_integrity_pool);
  420. if (bs->bvec_integrity_pool)
  421. mempool_destroy(bs->bvec_integrity_pool);
  422. }
  423. EXPORT_SYMBOL(bioset_integrity_free);
  424. void __init bio_integrity_init(void)
  425. {
  426. /*
  427. * kintegrityd won't block much but may burn a lot of CPU cycles.
  428. * Make it highpri CPU intensive wq with max concurrency of 1.
  429. */
  430. kintegrityd_wq = alloc_workqueue("kintegrityd", WQ_MEM_RECLAIM |
  431. WQ_HIGHPRI | WQ_CPU_INTENSIVE, 1);
  432. if (!kintegrityd_wq)
  433. panic("Failed to create kintegrityd\n");
  434. bip_slab = kmem_cache_create("bio_integrity_payload",
  435. sizeof(struct bio_integrity_payload) +
  436. sizeof(struct bio_vec) * BIP_INLINE_VECS,
  437. 0, SLAB_HWCACHE_ALIGN|SLAB_PANIC, NULL);
  438. }