summaryrefslogtreecommitdiffstats
path: root/Documentation/block
diff options
context:
space:
mode:
authorMartin K. Petersen <martin.petersen@oracle.com>2014-09-26 19:19:57 -0400
committerJens Axboe <axboe@fb.com>2014-09-27 11:14:50 -0400
commit8492b68bc4025e7bce1d57761bd7c047efda2f81 (patch)
treeef444c4e2a55354e1d7c515e4e5e800f0734168d /Documentation/block
parent180b2f95dd331010a9930a65c8a18d6d81b94dc1 (diff)
block: Remove integrity tagging functions
None of the filesystems appear interested in using the integrity tagging feature. Potentially because very few storage devices actually permit using the application tag space. Remove the tagging functions. Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com> Reviewed-by: Christoph Hellwig <hch@lst.de> Reviewed-by: Sagi Grimberg <sagig@mellanox.com> Signed-off-by: Jens Axboe <axboe@fb.com>
Diffstat (limited to 'Documentation/block')
-rw-r--r--Documentation/block/data-integrity.txt34
1 files changed, 0 insertions, 34 deletions
diff --git a/Documentation/block/data-integrity.txt b/Documentation/block/data-integrity.txt
index 4d4de8b09530..f56ec97f0d14 100644
--- a/Documentation/block/data-integrity.txt
+++ b/Documentation/block/data-integrity.txt
@@ -206,36 +206,6 @@ will require extra work due to the application tag.
206 bio_integrity_enabled() returned 1. 206 bio_integrity_enabled() returned 1.
207 207
208 208
209 int bio_integrity_tag_size(bio);
210
211 If the filesystem wants to use the application tag space it will
212 first have to find out how much storage space is available.
213 Because tag space is generally limited (usually 2 bytes per
214 sector regardless of sector size), the integrity framework
215 supports interleaving the information between the sectors in an
216 I/O.
217
218 Filesystems can call bio_integrity_tag_size(bio) to find out how
219 many bytes of storage are available for that particular bio.
220
221 Another option is bdev_get_tag_size(block_device) which will
222 return the number of available bytes per hardware sector.
223
224
225 int bio_integrity_set_tag(bio, void *tag_buf, len);
226
227 After a successful return from bio_integrity_prep(),
228 bio_integrity_set_tag() can be used to attach an opaque tag
229 buffer to a bio. Obviously this only makes sense if the I/O is
230 a WRITE.
231
232
233 int bio_integrity_get_tag(bio, void *tag_buf, len);
234
235 Similarly, at READ I/O completion time the filesystem can
236 retrieve the tag buffer using bio_integrity_get_tag().
237
238
2395.3 PASSING EXISTING INTEGRITY METADATA 2095.3 PASSING EXISTING INTEGRITY METADATA
240 210
241 Filesystems that either generate their own integrity metadata or 211 Filesystems that either generate their own integrity metadata or
@@ -288,8 +258,6 @@ will require extra work due to the application tag.
288 .name = "STANDARDSBODY-TYPE-VARIANT-CSUM", 258 .name = "STANDARDSBODY-TYPE-VARIANT-CSUM",
289 .generate_fn = my_generate_fn, 259 .generate_fn = my_generate_fn,
290 .verify_fn = my_verify_fn, 260 .verify_fn = my_verify_fn,
291 .get_tag_fn = my_get_tag_fn,
292 .set_tag_fn = my_set_tag_fn,
293 .tuple_size = sizeof(struct my_tuple_size), 261 .tuple_size = sizeof(struct my_tuple_size),
294 .tag_size = <tag bytes per hw sector>, 262 .tag_size = <tag bytes per hw sector>,
295 }; 263 };
@@ -311,7 +279,5 @@ will require extra work due to the application tag.
311 are available per hardware sector. For DIF this is either 2 or 279 are available per hardware sector. For DIF this is either 2 or
312 0 depending on the value of the Control Mode Page ATO bit. 280 0 depending on the value of the Control Mode Page ATO bit.
313 281
314 See 6.2 for a description of get_tag_fn and set_tag_fn.
315
316---------------------------------------------------------------------- 282----------------------------------------------------------------------
3172007-12-24 Martin K. Petersen <martin.petersen@oracle.com> 2832007-12-24 Martin K. Petersen <martin.petersen@oracle.com>