GNU Linux-libre 6.9.2-gnu
[releases.git] / include / rdma / signature.h
1 /* SPDX-License-Identifier: (GPL-2.0 OR Linux-OpenIB) */
2 /*
3  * Copyright (c) 2017-2018 Mellanox Technologies. All rights reserved.
4  */
5
6 #ifndef _RDMA_SIGNATURE_H_
7 #define _RDMA_SIGNATURE_H_
8
9 #include <linux/types.h>
10
11 enum ib_signature_prot_cap {
12         IB_PROT_T10DIF_TYPE_1 = 1,
13         IB_PROT_T10DIF_TYPE_2 = 1 << 1,
14         IB_PROT_T10DIF_TYPE_3 = 1 << 2,
15 };
16
17 enum ib_signature_guard_cap {
18         IB_GUARD_T10DIF_CRC     = 1,
19         IB_GUARD_T10DIF_CSUM    = 1 << 1,
20 };
21
22 /**
23  * enum ib_signature_type - Signature types
24  * @IB_SIG_TYPE_NONE: Unprotected.
25  * @IB_SIG_TYPE_T10_DIF: Type T10-DIF
26  */
27 enum ib_signature_type {
28         IB_SIG_TYPE_NONE,
29         IB_SIG_TYPE_T10_DIF,
30 };
31
32 /**
33  * enum ib_t10_dif_bg_type - Signature T10-DIF block-guard types
34  * @IB_T10DIF_CRC: Corresponds to T10-PI mandated CRC checksum rules.
35  * @IB_T10DIF_CSUM: Corresponds to IP checksum rules.
36  */
37 enum ib_t10_dif_bg_type {
38         IB_T10DIF_CRC,
39         IB_T10DIF_CSUM,
40 };
41
42 /**
43  * struct ib_t10_dif_domain - Parameters specific for T10-DIF
44  *     domain.
45  * @bg_type: T10-DIF block guard type (CRC|CSUM)
46  * @pi_interval: protection information interval.
47  * @bg: seed of guard computation.
48  * @app_tag: application tag of guard block
49  * @ref_tag: initial guard block reference tag.
50  * @ref_remap: Indicate wethear the reftag increments each block
51  * @app_escape: Indicate to skip block check if apptag=0xffff
52  * @ref_escape: Indicate to skip block check if reftag=0xffffffff
53  * @apptag_check_mask: check bitmask of application tag.
54  */
55 struct ib_t10_dif_domain {
56         enum ib_t10_dif_bg_type bg_type;
57         u16                     pi_interval;
58         u16                     bg;
59         u16                     app_tag;
60         u32                     ref_tag;
61         bool                    ref_remap;
62         bool                    app_escape;
63         bool                    ref_escape;
64         u16                     apptag_check_mask;
65 };
66
67 /**
68  * struct ib_sig_domain - Parameters for signature domain
69  * @sig_type: specific signauture type
70  * @sig: union of all signature domain attributes that may
71  *     be used to set domain layout.
72  */
73 struct ib_sig_domain {
74         enum ib_signature_type sig_type;
75         union {
76                 struct ib_t10_dif_domain dif;
77         } sig;
78 };
79
80 /**
81  * struct ib_sig_attrs - Parameters for signature handover operation
82  * @check_mask: bitmask for signature byte check (8 bytes)
83  * @mem: memory domain layout descriptor.
84  * @wire: wire domain layout descriptor.
85  * @meta_length: metadata length
86  */
87 struct ib_sig_attrs {
88         u8                      check_mask;
89         struct ib_sig_domain    mem;
90         struct ib_sig_domain    wire;
91         int                     meta_length;
92 };
93
94 enum ib_sig_err_type {
95         IB_SIG_BAD_GUARD,
96         IB_SIG_BAD_REFTAG,
97         IB_SIG_BAD_APPTAG,
98 };
99
100 /*
101  * Signature check masks (8 bytes in total) according to the T10-PI standard:
102  *  -------- -------- ------------
103  * | GUARD  | APPTAG |   REFTAG   |
104  * |  2B    |  2B    |    4B      |
105  *  -------- -------- ------------
106  */
107 enum {
108         IB_SIG_CHECK_GUARD = 0xc0,
109         IB_SIG_CHECK_APPTAG = 0x30,
110         IB_SIG_CHECK_REFTAG = 0x0f,
111 };
112
113 /*
114  * struct ib_sig_err - signature error descriptor
115  */
116 struct ib_sig_err {
117         enum ib_sig_err_type    err_type;
118         u32                     expected;
119         u32                     actual;
120         u64                     sig_err_offset;
121         u32                     key;
122 };
123
124 #endif /* _RDMA_SIGNATURE_H_ */