1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
2 /*
3 * FC Transport BSG Interface
4 *
5 * Copyright (C) 2008 James Smart, Emulex Corporation
6 */
7
8 #ifndef SCSI_BSG_FC_H
9 #define SCSI_BSG_FC_H
10
11 #include <linux/types.h>
12
13 /*
14 * This file intended to be included by both kernel and user space
15 */
16
17 /*
18 * FC Transport SGIO v4 BSG Message Support
19 */
20
21 /* Default BSG request timeout (in seconds) */
22 #define FC_DEFAULT_BSG_TIMEOUT (10 * HZ)
23
24
25 /*
26 * Request Message Codes supported by the FC Transport
27 */
28
29 /* define the class masks for the message codes */
30 #define FC_BSG_CLS_MASK 0xF0000000 /* find object class */
31 #define FC_BSG_HST_MASK 0x80000000 /* fc host class */
32 #define FC_BSG_RPT_MASK 0x40000000 /* fc rport class */
33
34 /* fc_host Message Codes */
35 #define FC_BSG_HST_ADD_RPORT (FC_BSG_HST_MASK | 0x00000001)
36 #define FC_BSG_HST_DEL_RPORT (FC_BSG_HST_MASK | 0x00000002)
37 #define FC_BSG_HST_ELS_NOLOGIN (FC_BSG_HST_MASK | 0x00000003)
38 #define FC_BSG_HST_CT (FC_BSG_HST_MASK | 0x00000004)
39 #define FC_BSG_HST_VENDOR (FC_BSG_HST_MASK | 0x000000FF)
40
41 /* fc_rport Message Codes */
42 #define FC_BSG_RPT_ELS (FC_BSG_RPT_MASK | 0x00000001)
43 #define FC_BSG_RPT_CT (FC_BSG_RPT_MASK | 0x00000002)
44
45
46
47 /*
48 * FC Address Identifiers in Message Structures :
49 *
50 * Whenever a command payload contains a FC Address Identifier
51 * (aka port_id), the value is effectively in big-endian
52 * order, thus the array elements are decoded as follows:
53 * element [0] is bits 23:16 of the FC Address Identifier
54 * element [1] is bits 15:8 of the FC Address Identifier
55 * element [2] is bits 7:0 of the FC Address Identifier
56 */
57
58
59 /*
60 * FC Host Messages
61 */
62
63 /* FC_BSG_HST_ADDR_PORT : */
64
65 /* Request:
66 * This message requests the FC host to login to the remote port
67 * at the specified N_Port_Id. The remote port is to be enumerated
68 * with the transport upon completion of the login.
69 */
70 struct fc_bsg_host_add_rport {
71 __u8 reserved;
72
73 /* FC Address Identier of the remote port to login to */
74 __u8 port_id[3];
75 };
76
77 /* Response:
78 * There is no additional response data - fc_bsg_reply->result is sufficient
79 */
80
81
82 /* FC_BSG_HST_DEL_RPORT : */
83
84 /* Request:
85 * This message requests the FC host to remove an enumerated
86 * remote port and to terminate the login to it.
87 *
88 * Note: The driver is free to reject this request if it desires to
89 * remain logged in with the remote port.
90 */
91 struct fc_bsg_host_del_rport {
92 __u8 reserved;
93
94 /* FC Address Identier of the remote port to logout of */
95 __u8 port_id[3];
96 };
97
98 /* Response:
99 * There is no additional response data - fc_bsg_reply->result is sufficient
100 */
101
102
103 /* FC_BSG_HST_ELS_NOLOGIN : */
104
105 /* Request:
106 * This message requests the FC_Host to send an ELS to a specific
107 * N_Port_ID. The host does not need to log into the remote port,
108 * nor does it need to enumerate the rport for further traffic
109 * (although, the FC host is free to do so if it desires).
110 */
111 struct fc_bsg_host_els {
112 /*
113 * ELS Command Code being sent (must be the same as byte 0
114 * of the payload)
115 */
116 __u8 command_code;
117
118 /* FC Address Identier of the remote port to send the ELS to */
119 __u8 port_id[3];
120 };
121
122 /* Response:
123 */
124 /* fc_bsg_ctels_reply->status values */
125 #define FC_CTELS_STATUS_OK 0x00000000
126 #define FC_CTELS_STATUS_REJECT 0x00000001
127 #define FC_CTELS_STATUS_P_RJT 0x00000002
128 #define FC_CTELS_STATUS_F_RJT 0x00000003
129 #define FC_CTELS_STATUS_P_BSY 0x00000004
130 #define FC_CTELS_STATUS_F_BSY 0x00000006
131 struct fc_bsg_ctels_reply {
132 /*
133 * Note: An ELS LS_RJT may be reported in 2 ways:
134 * a) A status of FC_CTELS_STATUS_OK is returned. The caller
135 * is to look into the ELS receive payload to determine
136 * LS_ACC or LS_RJT (by contents of word 0). The reject
137 * data will be in word 1.
138 * b) A status of FC_CTELS_STATUS_REJECT is returned, The
139 * rjt_data field will contain valid data.
140 *
141 * Note: ELS LS_ACC is determined by an FC_CTELS_STATUS_OK, and
142 * the receive payload word 0 indicates LS_ACC
143 * (e.g. value is 0x02xxxxxx).
144 *
145 * Note: Similarly, a CT Reject may be reported in 2 ways:
146 * a) A status of FC_CTELS_STATUS_OK is returned. The caller
147 * is to look into the CT receive payload to determine
148 * Accept or Reject (by contents of word 2). The reject
149 * data will be in word 3.
150 * b) A status of FC_CTELS_STATUS_REJECT is returned, The
151 * rjt_data field will contain valid data.
152 *
153 * Note: x_RJT/BSY status will indicae that the rjt_data field
154 * is valid and contains the reason/explanation values.
155 */
156 __u32 status; /* See FC_CTELS_STATUS_xxx */
157
158 /* valid if status is not FC_CTELS_STATUS_OK */
159 struct {
160 __u8 action; /* fragment_id for CT REJECT */
161 __u8 reason_code;
162 __u8 reason_explanation;
163 __u8 vendor_unique;
164 } rjt_data;
165 };
166
167
168 /* FC_BSG_HST_CT : */
169
170 /* Request:
171 * This message requests that a CT Request be performed with the
172 * indicated N_Port_ID. The driver is responsible for logging in with
173 * the fabric and/or N_Port_ID, etc as per FC rules. This request does
174 * not mandate that the driver must enumerate the destination in the
175 * transport. The driver is allowed to decide whether to enumerate it,
176 * and whether to tear it down after the request.
177 */
178 struct fc_bsg_host_ct {
179 __u8 reserved;
180
181 /* FC Address Identier of the remote port to send the ELS to */
182 __u8 port_id[3];
183
184 /*
185 * We need words 0-2 of the generic preamble for the LLD's
186 */
187 __u32 preamble_word0; /* revision & IN_ID */
188 __u32 preamble_word1; /* GS_Type, GS_SubType, Options, Rsvd */
189 __u32 preamble_word2; /* Cmd Code, Max Size */
190
191 };
192 /* Response:
193 *
194 * The reply structure is an fc_bsg_ctels_reply structure
195 */
196
197
198 /* FC_BSG_HST_VENDOR : */
199
200 /* Request:
201 * Note: When specifying vendor_id, be sure to read the Vendor Type and ID
202 * formatting requirements specified in scsi_netlink.h
203 */
204 struct fc_bsg_host_vendor {
205 /*
206 * Identifies the vendor that the message is formatted for. This
207 * should be the recipient of the message.
208 */
209 __u64 vendor_id;
210
211 /* start of vendor command area */
212 __u32 vendor_cmd[0];
213 };
214
215 /* Response:
216 */
217 struct fc_bsg_host_vendor_reply {
218 /* start of vendor response area */
219 __u32 vendor_rsp[0];
220 };
221
222
223
224 /*
225 * FC Remote Port Messages
226 */
227
228 /* FC_BSG_RPT_ELS : */
229
230 /* Request:
231 * This message requests that an ELS be performed with the rport.
232 */
233 struct fc_bsg_rport_els {
234 /*
235 * ELS Command Code being sent (must be the same as
236 * byte 0 of the payload)
237 */
238 __u8 els_code;
239 };
240
241 /* Response:
242 *
243 * The reply structure is an fc_bsg_ctels_reply structure
244 */
245
246
247 /* FC_BSG_RPT_CT : */
248
249 /* Request:
250 * This message requests that a CT Request be performed with the rport.
251 */
252 struct fc_bsg_rport_ct {
253 /*
254 * We need words 0-2 of the generic preamble for the LLD's
255 */
256 __u32 preamble_word0; /* revision & IN_ID */
257 __u32 preamble_word1; /* GS_Type, GS_SubType, Options, Rsvd */
258 __u32 preamble_word2; /* Cmd Code, Max Size */
259 };
260 /* Response:
261 *
262 * The reply structure is an fc_bsg_ctels_reply structure
263 */
264
265
266
267
268 /* request (CDB) structure of the sg_io_v4 */
269 struct fc_bsg_request {
270 __u32 msgcode;
271 union {
272 struct fc_bsg_host_add_rport h_addrport;
273 struct fc_bsg_host_del_rport h_delrport;
274 struct fc_bsg_host_els h_els;
275 struct fc_bsg_host_ct h_ct;
276 struct fc_bsg_host_vendor h_vendor;
277
278 struct fc_bsg_rport_els r_els;
279 struct fc_bsg_rport_ct r_ct;
280 } rqst_data;
281 } __attribute__((packed));
282
283
284 /* response (request sense data) structure of the sg_io_v4 */
285 struct fc_bsg_reply {
286 /*
287 * The completion result. Result exists in two forms:
288 * if negative, it is an -Exxx system errno value. There will
289 * be no further reply information supplied.
290 * else, it's the 4-byte scsi error result, with driver, host,
291 * msg and status fields. The per-msgcode reply structure
292 * will contain valid data.
293 */
294 __u32 result;
295
296 /* If there was reply_payload, how much was recevied ? */
297 __u32 reply_payload_rcv_len;
298
299 union {
300 struct fc_bsg_host_vendor_reply vendor_reply;
301
302 struct fc_bsg_ctels_reply ctels_reply;
303 } reply_data;
304 };
305
306
307 #endif /* SCSI_BSG_FC_H */
308