1 /* SPDX-License-Identifier: GPL-2.0 */ 1 /* SPDX-License-Identifier: GPL-2.0 */
2 /* 2 /*
3 * NVMe over Fabrics TCP protocol header. 3 * NVMe over Fabrics TCP protocol header.
4 * Copyright (c) 2018 Lightbits Labs. All righ 4 * Copyright (c) 2018 Lightbits Labs. All rights reserved.
5 */ 5 */
6 6
7 #ifndef _LINUX_NVME_TCP_H 7 #ifndef _LINUX_NVME_TCP_H
8 #define _LINUX_NVME_TCP_H 8 #define _LINUX_NVME_TCP_H
9 9
10 #include <linux/nvme.h> 10 #include <linux/nvme.h>
11 11
12 #define NVME_TCP_DISC_PORT 8009 12 #define NVME_TCP_DISC_PORT 8009
13 #define NVME_TCP_ADMIN_CCSZ SZ_8K 13 #define NVME_TCP_ADMIN_CCSZ SZ_8K
14 #define NVME_TCP_DIGEST_LENGTH 4 14 #define NVME_TCP_DIGEST_LENGTH 4
15 #define NVME_TCP_MIN_MAXH2CDATA 4096 15 #define NVME_TCP_MIN_MAXH2CDATA 4096
16 16
17 enum nvme_tcp_pfv { 17 enum nvme_tcp_pfv {
18 NVME_TCP_PFV_1_0 = 0x0, 18 NVME_TCP_PFV_1_0 = 0x0,
19 }; 19 };
20 20
21 enum nvme_tcp_tls_cipher { 21 enum nvme_tcp_tls_cipher {
22 NVME_TCP_TLS_CIPHER_INVALID = 0, 22 NVME_TCP_TLS_CIPHER_INVALID = 0,
23 NVME_TCP_TLS_CIPHER_SHA256 = 1, 23 NVME_TCP_TLS_CIPHER_SHA256 = 1,
24 NVME_TCP_TLS_CIPHER_SHA384 = 2, 24 NVME_TCP_TLS_CIPHER_SHA384 = 2,
25 }; 25 };
26 26
27 enum nvme_tcp_fatal_error_status { 27 enum nvme_tcp_fatal_error_status {
28 NVME_TCP_FES_INVALID_PDU_HDR 28 NVME_TCP_FES_INVALID_PDU_HDR = 0x01,
29 NVME_TCP_FES_PDU_SEQ_ERR 29 NVME_TCP_FES_PDU_SEQ_ERR = 0x02,
30 NVME_TCP_FES_HDR_DIGEST_ERR 30 NVME_TCP_FES_HDR_DIGEST_ERR = 0x03,
31 NVME_TCP_FES_DATA_OUT_OF_RANGE 31 NVME_TCP_FES_DATA_OUT_OF_RANGE = 0x04,
32 NVME_TCP_FES_R2T_LIMIT_EXCEEDED 32 NVME_TCP_FES_R2T_LIMIT_EXCEEDED = 0x05,
33 NVME_TCP_FES_DATA_LIMIT_EXCEEDED 33 NVME_TCP_FES_DATA_LIMIT_EXCEEDED = 0x05,
34 NVME_TCP_FES_UNSUPPORTED_PARAM 34 NVME_TCP_FES_UNSUPPORTED_PARAM = 0x06,
35 }; 35 };
36 36
37 enum nvme_tcp_digest_option { 37 enum nvme_tcp_digest_option {
38 NVME_TCP_HDR_DIGEST_ENABLE = (1 < 38 NVME_TCP_HDR_DIGEST_ENABLE = (1 << 0),
39 NVME_TCP_DATA_DIGEST_ENABLE = (1 < 39 NVME_TCP_DATA_DIGEST_ENABLE = (1 << 1),
40 }; 40 };
41 41
42 enum nvme_tcp_pdu_type { 42 enum nvme_tcp_pdu_type {
43 nvme_tcp_icreq = 0x0, 43 nvme_tcp_icreq = 0x0,
44 nvme_tcp_icresp = 0x1, 44 nvme_tcp_icresp = 0x1,
45 nvme_tcp_h2c_term = 0x2, 45 nvme_tcp_h2c_term = 0x2,
46 nvme_tcp_c2h_term = 0x3, 46 nvme_tcp_c2h_term = 0x3,
47 nvme_tcp_cmd = 0x4, 47 nvme_tcp_cmd = 0x4,
48 nvme_tcp_rsp = 0x5, 48 nvme_tcp_rsp = 0x5,
49 nvme_tcp_h2c_data = 0x6, 49 nvme_tcp_h2c_data = 0x6,
50 nvme_tcp_c2h_data = 0x7, 50 nvme_tcp_c2h_data = 0x7,
51 nvme_tcp_r2t = 0x9, 51 nvme_tcp_r2t = 0x9,
52 }; 52 };
53 53
54 enum nvme_tcp_pdu_flags { 54 enum nvme_tcp_pdu_flags {
55 NVME_TCP_F_HDGST = (1 < 55 NVME_TCP_F_HDGST = (1 << 0),
56 NVME_TCP_F_DDGST = (1 < 56 NVME_TCP_F_DDGST = (1 << 1),
57 NVME_TCP_F_DATA_LAST = (1 < 57 NVME_TCP_F_DATA_LAST = (1 << 2),
58 NVME_TCP_F_DATA_SUCCESS = (1 < 58 NVME_TCP_F_DATA_SUCCESS = (1 << 3),
59 }; 59 };
60 60
61 /** 61 /**
62 * struct nvme_tcp_hdr - nvme tcp pdu common h 62 * struct nvme_tcp_hdr - nvme tcp pdu common header
63 * 63 *
64 * @type: pdu type 64 * @type: pdu type
65 * @flags: pdu specific flags 65 * @flags: pdu specific flags
66 * @hlen: pdu header length 66 * @hlen: pdu header length
67 * @pdo: pdu data offset 67 * @pdo: pdu data offset
68 * @plen: pdu wire byte length 68 * @plen: pdu wire byte length
69 */ 69 */
70 struct nvme_tcp_hdr { 70 struct nvme_tcp_hdr {
71 __u8 type; 71 __u8 type;
72 __u8 flags; 72 __u8 flags;
73 __u8 hlen; 73 __u8 hlen;
74 __u8 pdo; 74 __u8 pdo;
75 __le32 plen; 75 __le32 plen;
76 }; 76 };
77 77
78 /** 78 /**
79 * struct nvme_tcp_icreq_pdu - nvme tcp initia 79 * struct nvme_tcp_icreq_pdu - nvme tcp initialize connection request pdu
80 * 80 *
81 * @hdr: pdu generic header 81 * @hdr: pdu generic header
82 * @pfv: pdu version format 82 * @pfv: pdu version format
83 * @hpda: host pdu data alignment (dw 83 * @hpda: host pdu data alignment (dwords, 0's based)
84 * @digest: digest types enabled 84 * @digest: digest types enabled
85 * @maxr2t: maximum r2ts per request su 85 * @maxr2t: maximum r2ts per request supported
86 */ 86 */
87 struct nvme_tcp_icreq_pdu { 87 struct nvme_tcp_icreq_pdu {
88 struct nvme_tcp_hdr hdr; 88 struct nvme_tcp_hdr hdr;
89 __le16 pfv; 89 __le16 pfv;
90 __u8 hpda; 90 __u8 hpda;
91 __u8 digest; 91 __u8 digest;
92 __le32 maxr2t; 92 __le32 maxr2t;
93 __u8 rsvd2[112]; 93 __u8 rsvd2[112];
94 }; 94 };
95 95
96 /** 96 /**
97 * struct nvme_tcp_icresp_pdu - nvme tcp initi 97 * struct nvme_tcp_icresp_pdu - nvme tcp initialize connection response pdu
98 * 98 *
99 * @hdr: pdu common header 99 * @hdr: pdu common header
100 * @pfv: pdu version format 100 * @pfv: pdu version format
101 * @cpda: controller pdu data alignme 101 * @cpda: controller pdu data alignment (dowrds, 0's based)
102 * @digest: digest types enabled 102 * @digest: digest types enabled
103 * @maxdata: maximum data capsules per r 103 * @maxdata: maximum data capsules per r2t supported
104 */ 104 */
105 struct nvme_tcp_icresp_pdu { 105 struct nvme_tcp_icresp_pdu {
106 struct nvme_tcp_hdr hdr; 106 struct nvme_tcp_hdr hdr;
107 __le16 pfv; 107 __le16 pfv;
108 __u8 cpda; 108 __u8 cpda;
109 __u8 digest; 109 __u8 digest;
110 __le32 maxdata; 110 __le32 maxdata;
111 __u8 rsvd[112]; 111 __u8 rsvd[112];
112 }; 112 };
113 113
114 /** 114 /**
115 * struct nvme_tcp_term_pdu - nvme tcp termina 115 * struct nvme_tcp_term_pdu - nvme tcp terminate connection pdu
116 * 116 *
117 * @hdr: pdu common header 117 * @hdr: pdu common header
118 * @fes: fatal error status 118 * @fes: fatal error status
119 * @fei: fatal error information 119 * @fei: fatal error information
120 */ 120 */
121 struct nvme_tcp_term_pdu { 121 struct nvme_tcp_term_pdu {
122 struct nvme_tcp_hdr hdr; 122 struct nvme_tcp_hdr hdr;
123 __le16 fes; 123 __le16 fes;
124 __le16 feil; 124 __le16 feil;
125 __le16 feiu; 125 __le16 feiu;
126 __u8 rsvd[10]; 126 __u8 rsvd[10];
127 }; 127 };
128 128
129 /** 129 /**
130 * struct nvme_tcp_cmd_pdu - nvme tcp command 130 * struct nvme_tcp_cmd_pdu - nvme tcp command capsule pdu
131 * 131 *
132 * @hdr: pdu common header 132 * @hdr: pdu common header
133 * @cmd: nvme command 133 * @cmd: nvme command
134 */ 134 */
135 struct nvme_tcp_cmd_pdu { 135 struct nvme_tcp_cmd_pdu {
136 struct nvme_tcp_hdr hdr; 136 struct nvme_tcp_hdr hdr;
137 struct nvme_command cmd; 137 struct nvme_command cmd;
138 }; 138 };
139 139
140 /** 140 /**
141 * struct nvme_tcp_rsp_pdu - nvme tcp response 141 * struct nvme_tcp_rsp_pdu - nvme tcp response capsule pdu
142 * 142 *
143 * @hdr: pdu common header 143 * @hdr: pdu common header
144 * @hdr: nvme-tcp generic header 144 * @hdr: nvme-tcp generic header
145 * @cqe: nvme completion queue entry 145 * @cqe: nvme completion queue entry
146 */ 146 */
147 struct nvme_tcp_rsp_pdu { 147 struct nvme_tcp_rsp_pdu {
148 struct nvme_tcp_hdr hdr; 148 struct nvme_tcp_hdr hdr;
149 struct nvme_completion cqe; 149 struct nvme_completion cqe;
150 }; 150 };
151 151
152 /** 152 /**
153 * struct nvme_tcp_r2t_pdu - nvme tcp ready-to 153 * struct nvme_tcp_r2t_pdu - nvme tcp ready-to-transfer pdu
154 * 154 *
155 * @hdr: pdu common header 155 * @hdr: pdu common header
156 * @command_id: nvme command identifier whi 156 * @command_id: nvme command identifier which this relates to
157 * @ttag: transfer tag (controller ge 157 * @ttag: transfer tag (controller generated)
158 * @r2t_offset: offset from the start of th 158 * @r2t_offset: offset from the start of the command data
159 * @r2t_length: length the host is allowed 159 * @r2t_length: length the host is allowed to send
160 */ 160 */
161 struct nvme_tcp_r2t_pdu { 161 struct nvme_tcp_r2t_pdu {
162 struct nvme_tcp_hdr hdr; 162 struct nvme_tcp_hdr hdr;
163 __u16 command_id; 163 __u16 command_id;
164 __u16 ttag; 164 __u16 ttag;
165 __le32 r2t_offset; 165 __le32 r2t_offset;
166 __le32 r2t_length; 166 __le32 r2t_length;
167 __u8 rsvd[4]; 167 __u8 rsvd[4];
168 }; 168 };
169 169
170 /** 170 /**
171 * struct nvme_tcp_data_pdu - nvme tcp data pd 171 * struct nvme_tcp_data_pdu - nvme tcp data pdu
172 * 172 *
173 * @hdr: pdu common header 173 * @hdr: pdu common header
174 * @command_id: nvme command identifier whi 174 * @command_id: nvme command identifier which this relates to
175 * @ttag: transfer tag (controller ge 175 * @ttag: transfer tag (controller generated)
176 * @data_offset: offset from the start of th 176 * @data_offset: offset from the start of the command data
177 * @data_length: length of the data stream 177 * @data_length: length of the data stream
178 */ 178 */
179 struct nvme_tcp_data_pdu { 179 struct nvme_tcp_data_pdu {
180 struct nvme_tcp_hdr hdr; 180 struct nvme_tcp_hdr hdr;
181 __u16 command_id; 181 __u16 command_id;
182 __u16 ttag; 182 __u16 ttag;
183 __le32 data_offset; 183 __le32 data_offset;
184 __le32 data_length; 184 __le32 data_length;
185 __u8 rsvd[4]; 185 __u8 rsvd[4];
186 }; 186 };
187 187
188 union nvme_tcp_pdu { 188 union nvme_tcp_pdu {
189 struct nvme_tcp_icreq_pdu icreq; 189 struct nvme_tcp_icreq_pdu icreq;
190 struct nvme_tcp_icresp_pdu icresp 190 struct nvme_tcp_icresp_pdu icresp;
191 struct nvme_tcp_cmd_pdu cmd; 191 struct nvme_tcp_cmd_pdu cmd;
192 struct nvme_tcp_rsp_pdu rsp; 192 struct nvme_tcp_rsp_pdu rsp;
193 struct nvme_tcp_r2t_pdu r2t; 193 struct nvme_tcp_r2t_pdu r2t;
194 struct nvme_tcp_data_pdu data; 194 struct nvme_tcp_data_pdu data;
195 }; 195 };
196 196
197 #endif /* _LINUX_NVME_TCP_H */ 197 #endif /* _LINUX_NVME_TCP_H */
198 198
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.