1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * t10_pi.c - Functions for generating and verifying T10 Protection
4*4882a593Smuzhiyun * Information.
5*4882a593Smuzhiyun */
6*4882a593Smuzhiyun
7*4882a593Smuzhiyun #include <linux/t10-pi.h>
8*4882a593Smuzhiyun #include <linux/blkdev.h>
9*4882a593Smuzhiyun #include <linux/crc-t10dif.h>
10*4882a593Smuzhiyun #include <linux/module.h>
11*4882a593Smuzhiyun #include <net/checksum.h>
12*4882a593Smuzhiyun
13*4882a593Smuzhiyun typedef __be16 (csum_fn) (void *, unsigned int);
14*4882a593Smuzhiyun
t10_pi_crc_fn(void * data,unsigned int len)15*4882a593Smuzhiyun static __be16 t10_pi_crc_fn(void *data, unsigned int len)
16*4882a593Smuzhiyun {
17*4882a593Smuzhiyun return cpu_to_be16(crc_t10dif(data, len));
18*4882a593Smuzhiyun }
19*4882a593Smuzhiyun
t10_pi_ip_fn(void * data,unsigned int len)20*4882a593Smuzhiyun static __be16 t10_pi_ip_fn(void *data, unsigned int len)
21*4882a593Smuzhiyun {
22*4882a593Smuzhiyun return (__force __be16)ip_compute_csum(data, len);
23*4882a593Smuzhiyun }
24*4882a593Smuzhiyun
25*4882a593Smuzhiyun /*
26*4882a593Smuzhiyun * Type 1 and Type 2 protection use the same format: 16 bit guard tag,
27*4882a593Smuzhiyun * 16 bit app tag, 32 bit reference tag. Type 3 does not define the ref
28*4882a593Smuzhiyun * tag.
29*4882a593Smuzhiyun */
t10_pi_generate(struct blk_integrity_iter * iter,csum_fn * fn,enum t10_dif_type type)30*4882a593Smuzhiyun static blk_status_t t10_pi_generate(struct blk_integrity_iter *iter,
31*4882a593Smuzhiyun csum_fn *fn, enum t10_dif_type type)
32*4882a593Smuzhiyun {
33*4882a593Smuzhiyun unsigned int i;
34*4882a593Smuzhiyun
35*4882a593Smuzhiyun for (i = 0 ; i < iter->data_size ; i += iter->interval) {
36*4882a593Smuzhiyun struct t10_pi_tuple *pi = iter->prot_buf;
37*4882a593Smuzhiyun
38*4882a593Smuzhiyun pi->guard_tag = fn(iter->data_buf, iter->interval);
39*4882a593Smuzhiyun pi->app_tag = 0;
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun if (type == T10_PI_TYPE1_PROTECTION)
42*4882a593Smuzhiyun pi->ref_tag = cpu_to_be32(lower_32_bits(iter->seed));
43*4882a593Smuzhiyun else
44*4882a593Smuzhiyun pi->ref_tag = 0;
45*4882a593Smuzhiyun
46*4882a593Smuzhiyun iter->data_buf += iter->interval;
47*4882a593Smuzhiyun iter->prot_buf += sizeof(struct t10_pi_tuple);
48*4882a593Smuzhiyun iter->seed++;
49*4882a593Smuzhiyun }
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun return BLK_STS_OK;
52*4882a593Smuzhiyun }
53*4882a593Smuzhiyun
t10_pi_verify(struct blk_integrity_iter * iter,csum_fn * fn,enum t10_dif_type type)54*4882a593Smuzhiyun static blk_status_t t10_pi_verify(struct blk_integrity_iter *iter,
55*4882a593Smuzhiyun csum_fn *fn, enum t10_dif_type type)
56*4882a593Smuzhiyun {
57*4882a593Smuzhiyun unsigned int i;
58*4882a593Smuzhiyun
59*4882a593Smuzhiyun BUG_ON(type == T10_PI_TYPE0_PROTECTION);
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun for (i = 0 ; i < iter->data_size ; i += iter->interval) {
62*4882a593Smuzhiyun struct t10_pi_tuple *pi = iter->prot_buf;
63*4882a593Smuzhiyun __be16 csum;
64*4882a593Smuzhiyun
65*4882a593Smuzhiyun if (type == T10_PI_TYPE1_PROTECTION ||
66*4882a593Smuzhiyun type == T10_PI_TYPE2_PROTECTION) {
67*4882a593Smuzhiyun if (pi->app_tag == T10_PI_APP_ESCAPE)
68*4882a593Smuzhiyun goto next;
69*4882a593Smuzhiyun
70*4882a593Smuzhiyun if (be32_to_cpu(pi->ref_tag) !=
71*4882a593Smuzhiyun lower_32_bits(iter->seed)) {
72*4882a593Smuzhiyun pr_err("%s: ref tag error at location %llu " \
73*4882a593Smuzhiyun "(rcvd %u)\n", iter->disk_name,
74*4882a593Smuzhiyun (unsigned long long)
75*4882a593Smuzhiyun iter->seed, be32_to_cpu(pi->ref_tag));
76*4882a593Smuzhiyun return BLK_STS_PROTECTION;
77*4882a593Smuzhiyun }
78*4882a593Smuzhiyun } else if (type == T10_PI_TYPE3_PROTECTION) {
79*4882a593Smuzhiyun if (pi->app_tag == T10_PI_APP_ESCAPE &&
80*4882a593Smuzhiyun pi->ref_tag == T10_PI_REF_ESCAPE)
81*4882a593Smuzhiyun goto next;
82*4882a593Smuzhiyun }
83*4882a593Smuzhiyun
84*4882a593Smuzhiyun csum = fn(iter->data_buf, iter->interval);
85*4882a593Smuzhiyun
86*4882a593Smuzhiyun if (pi->guard_tag != csum) {
87*4882a593Smuzhiyun pr_err("%s: guard tag error at sector %llu " \
88*4882a593Smuzhiyun "(rcvd %04x, want %04x)\n", iter->disk_name,
89*4882a593Smuzhiyun (unsigned long long)iter->seed,
90*4882a593Smuzhiyun be16_to_cpu(pi->guard_tag), be16_to_cpu(csum));
91*4882a593Smuzhiyun return BLK_STS_PROTECTION;
92*4882a593Smuzhiyun }
93*4882a593Smuzhiyun
94*4882a593Smuzhiyun next:
95*4882a593Smuzhiyun iter->data_buf += iter->interval;
96*4882a593Smuzhiyun iter->prot_buf += sizeof(struct t10_pi_tuple);
97*4882a593Smuzhiyun iter->seed++;
98*4882a593Smuzhiyun }
99*4882a593Smuzhiyun
100*4882a593Smuzhiyun return BLK_STS_OK;
101*4882a593Smuzhiyun }
102*4882a593Smuzhiyun
t10_pi_type1_generate_crc(struct blk_integrity_iter * iter)103*4882a593Smuzhiyun static blk_status_t t10_pi_type1_generate_crc(struct blk_integrity_iter *iter)
104*4882a593Smuzhiyun {
105*4882a593Smuzhiyun return t10_pi_generate(iter, t10_pi_crc_fn, T10_PI_TYPE1_PROTECTION);
106*4882a593Smuzhiyun }
107*4882a593Smuzhiyun
t10_pi_type1_generate_ip(struct blk_integrity_iter * iter)108*4882a593Smuzhiyun static blk_status_t t10_pi_type1_generate_ip(struct blk_integrity_iter *iter)
109*4882a593Smuzhiyun {
110*4882a593Smuzhiyun return t10_pi_generate(iter, t10_pi_ip_fn, T10_PI_TYPE1_PROTECTION);
111*4882a593Smuzhiyun }
112*4882a593Smuzhiyun
t10_pi_type1_verify_crc(struct blk_integrity_iter * iter)113*4882a593Smuzhiyun static blk_status_t t10_pi_type1_verify_crc(struct blk_integrity_iter *iter)
114*4882a593Smuzhiyun {
115*4882a593Smuzhiyun return t10_pi_verify(iter, t10_pi_crc_fn, T10_PI_TYPE1_PROTECTION);
116*4882a593Smuzhiyun }
117*4882a593Smuzhiyun
t10_pi_type1_verify_ip(struct blk_integrity_iter * iter)118*4882a593Smuzhiyun static blk_status_t t10_pi_type1_verify_ip(struct blk_integrity_iter *iter)
119*4882a593Smuzhiyun {
120*4882a593Smuzhiyun return t10_pi_verify(iter, t10_pi_ip_fn, T10_PI_TYPE1_PROTECTION);
121*4882a593Smuzhiyun }
122*4882a593Smuzhiyun
123*4882a593Smuzhiyun /**
124*4882a593Smuzhiyun * t10_pi_type1_prepare - prepare PI prior submitting request to device
125*4882a593Smuzhiyun * @rq: request with PI that should be prepared
126*4882a593Smuzhiyun *
127*4882a593Smuzhiyun * For Type 1/Type 2, the virtual start sector is the one that was
128*4882a593Smuzhiyun * originally submitted by the block layer for the ref_tag usage. Due to
129*4882a593Smuzhiyun * partitioning, MD/DM cloning, etc. the actual physical start sector is
130*4882a593Smuzhiyun * likely to be different. Remap protection information to match the
131*4882a593Smuzhiyun * physical LBA.
132*4882a593Smuzhiyun */
t10_pi_type1_prepare(struct request * rq)133*4882a593Smuzhiyun static void t10_pi_type1_prepare(struct request *rq)
134*4882a593Smuzhiyun {
135*4882a593Smuzhiyun const int tuple_sz = rq->q->integrity.tuple_size;
136*4882a593Smuzhiyun u32 ref_tag = t10_pi_ref_tag(rq);
137*4882a593Smuzhiyun struct bio *bio;
138*4882a593Smuzhiyun
139*4882a593Smuzhiyun __rq_for_each_bio(bio, rq) {
140*4882a593Smuzhiyun struct bio_integrity_payload *bip = bio_integrity(bio);
141*4882a593Smuzhiyun u32 virt = bip_get_seed(bip) & 0xffffffff;
142*4882a593Smuzhiyun struct bio_vec iv;
143*4882a593Smuzhiyun struct bvec_iter iter;
144*4882a593Smuzhiyun
145*4882a593Smuzhiyun /* Already remapped? */
146*4882a593Smuzhiyun if (bip->bip_flags & BIP_MAPPED_INTEGRITY)
147*4882a593Smuzhiyun break;
148*4882a593Smuzhiyun
149*4882a593Smuzhiyun bip_for_each_vec(iv, bip, iter) {
150*4882a593Smuzhiyun void *p, *pmap;
151*4882a593Smuzhiyun unsigned int j;
152*4882a593Smuzhiyun
153*4882a593Smuzhiyun pmap = kmap_atomic(iv.bv_page);
154*4882a593Smuzhiyun p = pmap + iv.bv_offset;
155*4882a593Smuzhiyun for (j = 0; j < iv.bv_len; j += tuple_sz) {
156*4882a593Smuzhiyun struct t10_pi_tuple *pi = p;
157*4882a593Smuzhiyun
158*4882a593Smuzhiyun if (be32_to_cpu(pi->ref_tag) == virt)
159*4882a593Smuzhiyun pi->ref_tag = cpu_to_be32(ref_tag);
160*4882a593Smuzhiyun virt++;
161*4882a593Smuzhiyun ref_tag++;
162*4882a593Smuzhiyun p += tuple_sz;
163*4882a593Smuzhiyun }
164*4882a593Smuzhiyun
165*4882a593Smuzhiyun kunmap_atomic(pmap);
166*4882a593Smuzhiyun }
167*4882a593Smuzhiyun
168*4882a593Smuzhiyun bip->bip_flags |= BIP_MAPPED_INTEGRITY;
169*4882a593Smuzhiyun }
170*4882a593Smuzhiyun }
171*4882a593Smuzhiyun
172*4882a593Smuzhiyun /**
173*4882a593Smuzhiyun * t10_pi_type1_complete - prepare PI prior returning request to the blk layer
174*4882a593Smuzhiyun * @rq: request with PI that should be prepared
175*4882a593Smuzhiyun * @nr_bytes: total bytes to prepare
176*4882a593Smuzhiyun *
177*4882a593Smuzhiyun * For Type 1/Type 2, the virtual start sector is the one that was
178*4882a593Smuzhiyun * originally submitted by the block layer for the ref_tag usage. Due to
179*4882a593Smuzhiyun * partitioning, MD/DM cloning, etc. the actual physical start sector is
180*4882a593Smuzhiyun * likely to be different. Since the physical start sector was submitted
181*4882a593Smuzhiyun * to the device, we should remap it back to virtual values expected by the
182*4882a593Smuzhiyun * block layer.
183*4882a593Smuzhiyun */
t10_pi_type1_complete(struct request * rq,unsigned int nr_bytes)184*4882a593Smuzhiyun static void t10_pi_type1_complete(struct request *rq, unsigned int nr_bytes)
185*4882a593Smuzhiyun {
186*4882a593Smuzhiyun unsigned intervals = nr_bytes >> rq->q->integrity.interval_exp;
187*4882a593Smuzhiyun const int tuple_sz = rq->q->integrity.tuple_size;
188*4882a593Smuzhiyun u32 ref_tag = t10_pi_ref_tag(rq);
189*4882a593Smuzhiyun struct bio *bio;
190*4882a593Smuzhiyun
191*4882a593Smuzhiyun __rq_for_each_bio(bio, rq) {
192*4882a593Smuzhiyun struct bio_integrity_payload *bip = bio_integrity(bio);
193*4882a593Smuzhiyun u32 virt = bip_get_seed(bip) & 0xffffffff;
194*4882a593Smuzhiyun struct bio_vec iv;
195*4882a593Smuzhiyun struct bvec_iter iter;
196*4882a593Smuzhiyun
197*4882a593Smuzhiyun bip_for_each_vec(iv, bip, iter) {
198*4882a593Smuzhiyun void *p, *pmap;
199*4882a593Smuzhiyun unsigned int j;
200*4882a593Smuzhiyun
201*4882a593Smuzhiyun pmap = kmap_atomic(iv.bv_page);
202*4882a593Smuzhiyun p = pmap + iv.bv_offset;
203*4882a593Smuzhiyun for (j = 0; j < iv.bv_len && intervals; j += tuple_sz) {
204*4882a593Smuzhiyun struct t10_pi_tuple *pi = p;
205*4882a593Smuzhiyun
206*4882a593Smuzhiyun if (be32_to_cpu(pi->ref_tag) == ref_tag)
207*4882a593Smuzhiyun pi->ref_tag = cpu_to_be32(virt);
208*4882a593Smuzhiyun virt++;
209*4882a593Smuzhiyun ref_tag++;
210*4882a593Smuzhiyun intervals--;
211*4882a593Smuzhiyun p += tuple_sz;
212*4882a593Smuzhiyun }
213*4882a593Smuzhiyun
214*4882a593Smuzhiyun kunmap_atomic(pmap);
215*4882a593Smuzhiyun }
216*4882a593Smuzhiyun }
217*4882a593Smuzhiyun }
218*4882a593Smuzhiyun
t10_pi_type3_generate_crc(struct blk_integrity_iter * iter)219*4882a593Smuzhiyun static blk_status_t t10_pi_type3_generate_crc(struct blk_integrity_iter *iter)
220*4882a593Smuzhiyun {
221*4882a593Smuzhiyun return t10_pi_generate(iter, t10_pi_crc_fn, T10_PI_TYPE3_PROTECTION);
222*4882a593Smuzhiyun }
223*4882a593Smuzhiyun
t10_pi_type3_generate_ip(struct blk_integrity_iter * iter)224*4882a593Smuzhiyun static blk_status_t t10_pi_type3_generate_ip(struct blk_integrity_iter *iter)
225*4882a593Smuzhiyun {
226*4882a593Smuzhiyun return t10_pi_generate(iter, t10_pi_ip_fn, T10_PI_TYPE3_PROTECTION);
227*4882a593Smuzhiyun }
228*4882a593Smuzhiyun
t10_pi_type3_verify_crc(struct blk_integrity_iter * iter)229*4882a593Smuzhiyun static blk_status_t t10_pi_type3_verify_crc(struct blk_integrity_iter *iter)
230*4882a593Smuzhiyun {
231*4882a593Smuzhiyun return t10_pi_verify(iter, t10_pi_crc_fn, T10_PI_TYPE3_PROTECTION);
232*4882a593Smuzhiyun }
233*4882a593Smuzhiyun
t10_pi_type3_verify_ip(struct blk_integrity_iter * iter)234*4882a593Smuzhiyun static blk_status_t t10_pi_type3_verify_ip(struct blk_integrity_iter *iter)
235*4882a593Smuzhiyun {
236*4882a593Smuzhiyun return t10_pi_verify(iter, t10_pi_ip_fn, T10_PI_TYPE3_PROTECTION);
237*4882a593Smuzhiyun }
238*4882a593Smuzhiyun
239*4882a593Smuzhiyun /* Type 3 does not have a reference tag so no remapping is required. */
t10_pi_type3_prepare(struct request * rq)240*4882a593Smuzhiyun static void t10_pi_type3_prepare(struct request *rq)
241*4882a593Smuzhiyun {
242*4882a593Smuzhiyun }
243*4882a593Smuzhiyun
244*4882a593Smuzhiyun /* Type 3 does not have a reference tag so no remapping is required. */
t10_pi_type3_complete(struct request * rq,unsigned int nr_bytes)245*4882a593Smuzhiyun static void t10_pi_type3_complete(struct request *rq, unsigned int nr_bytes)
246*4882a593Smuzhiyun {
247*4882a593Smuzhiyun }
248*4882a593Smuzhiyun
249*4882a593Smuzhiyun const struct blk_integrity_profile t10_pi_type1_crc = {
250*4882a593Smuzhiyun .name = "T10-DIF-TYPE1-CRC",
251*4882a593Smuzhiyun .generate_fn = t10_pi_type1_generate_crc,
252*4882a593Smuzhiyun .verify_fn = t10_pi_type1_verify_crc,
253*4882a593Smuzhiyun .prepare_fn = t10_pi_type1_prepare,
254*4882a593Smuzhiyun .complete_fn = t10_pi_type1_complete,
255*4882a593Smuzhiyun };
256*4882a593Smuzhiyun EXPORT_SYMBOL(t10_pi_type1_crc);
257*4882a593Smuzhiyun
258*4882a593Smuzhiyun const struct blk_integrity_profile t10_pi_type1_ip = {
259*4882a593Smuzhiyun .name = "T10-DIF-TYPE1-IP",
260*4882a593Smuzhiyun .generate_fn = t10_pi_type1_generate_ip,
261*4882a593Smuzhiyun .verify_fn = t10_pi_type1_verify_ip,
262*4882a593Smuzhiyun .prepare_fn = t10_pi_type1_prepare,
263*4882a593Smuzhiyun .complete_fn = t10_pi_type1_complete,
264*4882a593Smuzhiyun };
265*4882a593Smuzhiyun EXPORT_SYMBOL(t10_pi_type1_ip);
266*4882a593Smuzhiyun
267*4882a593Smuzhiyun const struct blk_integrity_profile t10_pi_type3_crc = {
268*4882a593Smuzhiyun .name = "T10-DIF-TYPE3-CRC",
269*4882a593Smuzhiyun .generate_fn = t10_pi_type3_generate_crc,
270*4882a593Smuzhiyun .verify_fn = t10_pi_type3_verify_crc,
271*4882a593Smuzhiyun .prepare_fn = t10_pi_type3_prepare,
272*4882a593Smuzhiyun .complete_fn = t10_pi_type3_complete,
273*4882a593Smuzhiyun };
274*4882a593Smuzhiyun EXPORT_SYMBOL(t10_pi_type3_crc);
275*4882a593Smuzhiyun
276*4882a593Smuzhiyun const struct blk_integrity_profile t10_pi_type3_ip = {
277*4882a593Smuzhiyun .name = "T10-DIF-TYPE3-IP",
278*4882a593Smuzhiyun .generate_fn = t10_pi_type3_generate_ip,
279*4882a593Smuzhiyun .verify_fn = t10_pi_type3_verify_ip,
280*4882a593Smuzhiyun .prepare_fn = t10_pi_type3_prepare,
281*4882a593Smuzhiyun .complete_fn = t10_pi_type3_complete,
282*4882a593Smuzhiyun };
283*4882a593Smuzhiyun EXPORT_SYMBOL(t10_pi_type3_ip);
284*4882a593Smuzhiyun
285*4882a593Smuzhiyun MODULE_LICENSE("GPL");
286