]>
Commit | Line | Data |
---|---|---|
07bfcd09 CH |
1 | /* |
2 | * NVMe over Fabrics common host code. | |
3 | * Copyright (c) 2015-2016 HGST, a Western Digital Company. | |
4 | * | |
5 | * This program is free software; you can redistribute it and/or modify it | |
6 | * under the terms and conditions of the GNU General Public License, | |
7 | * version 2, as published by the Free Software Foundation. | |
8 | * | |
9 | * This program is distributed in the hope it will be useful, but WITHOUT | |
10 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
11 | * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
12 | * more details. | |
13 | */ | |
14 | #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt | |
15 | #include <linux/init.h> | |
16 | #include <linux/miscdevice.h> | |
17 | #include <linux/module.h> | |
18 | #include <linux/mutex.h> | |
19 | #include <linux/parser.h> | |
20 | #include <linux/seq_file.h> | |
21 | #include "nvme.h" | |
22 | #include "fabrics.h" | |
23 | ||
24 | static LIST_HEAD(nvmf_transports); | |
489beb91 | 25 | static DECLARE_RWSEM(nvmf_transports_rwsem); |
07bfcd09 CH |
26 | |
27 | static LIST_HEAD(nvmf_hosts); | |
28 | static DEFINE_MUTEX(nvmf_hosts_mutex); | |
29 | ||
30 | static struct nvmf_host *nvmf_default_host; | |
31 | ||
32 | static struct nvmf_host *__nvmf_host_find(const char *hostnqn) | |
33 | { | |
34 | struct nvmf_host *host; | |
35 | ||
36 | list_for_each_entry(host, &nvmf_hosts, list) { | |
37 | if (!strcmp(host->nqn, hostnqn)) | |
38 | return host; | |
39 | } | |
40 | ||
41 | return NULL; | |
42 | } | |
43 | ||
44 | static struct nvmf_host *nvmf_host_add(const char *hostnqn) | |
45 | { | |
46 | struct nvmf_host *host; | |
47 | ||
48 | mutex_lock(&nvmf_hosts_mutex); | |
49 | host = __nvmf_host_find(hostnqn); | |
98096d8a CH |
50 | if (host) { |
51 | kref_get(&host->ref); | |
07bfcd09 | 52 | goto out_unlock; |
98096d8a | 53 | } |
07bfcd09 CH |
54 | |
55 | host = kmalloc(sizeof(*host), GFP_KERNEL); | |
56 | if (!host) | |
57 | goto out_unlock; | |
58 | ||
59 | kref_init(&host->ref); | |
60 | memcpy(host->nqn, hostnqn, NVMF_NQN_SIZE); | |
07bfcd09 CH |
61 | |
62 | list_add_tail(&host->list, &nvmf_hosts); | |
63 | out_unlock: | |
64 | mutex_unlock(&nvmf_hosts_mutex); | |
65 | return host; | |
66 | } | |
67 | ||
68 | static struct nvmf_host *nvmf_host_default(void) | |
69 | { | |
70 | struct nvmf_host *host; | |
71 | ||
72 | host = kmalloc(sizeof(*host), GFP_KERNEL); | |
73 | if (!host) | |
74 | return NULL; | |
75 | ||
76 | kref_init(&host->ref); | |
07bfcd09 | 77 | snprintf(host->nqn, NVMF_NQN_SIZE, |
40a5fce4 | 78 | "nqn.2014-08.org.nvmexpress:uuid:%pUb", &host->id); |
07bfcd09 CH |
79 | |
80 | mutex_lock(&nvmf_hosts_mutex); | |
81 | list_add_tail(&host->list, &nvmf_hosts); | |
82 | mutex_unlock(&nvmf_hosts_mutex); | |
83 | ||
84 | return host; | |
85 | } | |
86 | ||
87 | static void nvmf_host_destroy(struct kref *ref) | |
88 | { | |
89 | struct nvmf_host *host = container_of(ref, struct nvmf_host, ref); | |
90 | ||
e76debd9 ML |
91 | mutex_lock(&nvmf_hosts_mutex); |
92 | list_del(&host->list); | |
93 | mutex_unlock(&nvmf_hosts_mutex); | |
94 | ||
07bfcd09 CH |
95 | kfree(host); |
96 | } | |
97 | ||
98 | static void nvmf_host_put(struct nvmf_host *host) | |
99 | { | |
100 | if (host) | |
101 | kref_put(&host->ref, nvmf_host_destroy); | |
102 | } | |
103 | ||
104 | /** | |
105 | * nvmf_get_address() - Get address/port | |
106 | * @ctrl: Host NVMe controller instance which we got the address | |
107 | * @buf: OUTPUT parameter that will contain the address/port | |
108 | * @size: buffer size | |
109 | */ | |
110 | int nvmf_get_address(struct nvme_ctrl *ctrl, char *buf, int size) | |
111 | { | |
0fe51ff2 JS |
112 | int len = 0; |
113 | ||
114 | if (ctrl->opts->mask & NVMF_OPT_TRADDR) | |
115 | len += snprintf(buf, size, "traddr=%s", ctrl->opts->traddr); | |
116 | if (ctrl->opts->mask & NVMF_OPT_TRSVCID) | |
117 | len += snprintf(buf + len, size - len, "%strsvcid=%s", | |
118 | (len) ? "," : "", ctrl->opts->trsvcid); | |
478bcb93 JS |
119 | if (ctrl->opts->mask & NVMF_OPT_HOST_TRADDR) |
120 | len += snprintf(buf + len, size - len, "%shost_traddr=%s", | |
121 | (len) ? "," : "", ctrl->opts->host_traddr); | |
0fe51ff2 JS |
122 | len += snprintf(buf + len, size - len, "\n"); |
123 | ||
124 | return len; | |
07bfcd09 CH |
125 | } |
126 | EXPORT_SYMBOL_GPL(nvmf_get_address); | |
127 | ||
07bfcd09 CH |
128 | /** |
129 | * nvmf_reg_read32() - NVMe Fabrics "Property Get" API function. | |
130 | * @ctrl: Host NVMe controller instance maintaining the admin | |
131 | * queue used to submit the property read command to | |
132 | * the allocated NVMe controller resource on the target system. | |
133 | * @off: Starting offset value of the targeted property | |
134 | * register (see the fabrics section of the NVMe standard). | |
135 | * @val: OUTPUT parameter that will contain the value of | |
136 | * the property after a successful read. | |
137 | * | |
138 | * Used by the host system to retrieve a 32-bit capsule property value | |
139 | * from an NVMe controller on the target system. | |
140 | * | |
141 | * ("Capsule property" is an "PCIe register concept" applied to the | |
142 | * NVMe fabrics space.) | |
143 | * | |
144 | * Return: | |
145 | * 0: successful read | |
146 | * > 0: NVMe error status code | |
147 | * < 0: Linux errno error code | |
148 | */ | |
149 | int nvmf_reg_read32(struct nvme_ctrl *ctrl, u32 off, u32 *val) | |
150 | { | |
151 | struct nvme_command cmd; | |
d49187e9 | 152 | union nvme_result res; |
07bfcd09 CH |
153 | int ret; |
154 | ||
155 | memset(&cmd, 0, sizeof(cmd)); | |
156 | cmd.prop_get.opcode = nvme_fabrics_command; | |
157 | cmd.prop_get.fctype = nvme_fabrics_type_property_get; | |
158 | cmd.prop_get.offset = cpu_to_le32(off); | |
159 | ||
d49187e9 | 160 | ret = __nvme_submit_sync_cmd(ctrl->admin_q, &cmd, &res, NULL, 0, 0, |
07bfcd09 CH |
161 | NVME_QID_ANY, 0, 0); |
162 | ||
163 | if (ret >= 0) | |
d49187e9 | 164 | *val = le64_to_cpu(res.u64); |
07bfcd09 CH |
165 | if (unlikely(ret != 0)) |
166 | dev_err(ctrl->device, | |
167 | "Property Get error: %d, offset %#x\n", | |
168 | ret > 0 ? ret & ~NVME_SC_DNR : ret, off); | |
169 | ||
170 | return ret; | |
171 | } | |
172 | EXPORT_SYMBOL_GPL(nvmf_reg_read32); | |
173 | ||
174 | /** | |
175 | * nvmf_reg_read64() - NVMe Fabrics "Property Get" API function. | |
176 | * @ctrl: Host NVMe controller instance maintaining the admin | |
177 | * queue used to submit the property read command to | |
178 | * the allocated controller resource on the target system. | |
179 | * @off: Starting offset value of the targeted property | |
180 | * register (see the fabrics section of the NVMe standard). | |
181 | * @val: OUTPUT parameter that will contain the value of | |
182 | * the property after a successful read. | |
183 | * | |
184 | * Used by the host system to retrieve a 64-bit capsule property value | |
185 | * from an NVMe controller on the target system. | |
186 | * | |
187 | * ("Capsule property" is an "PCIe register concept" applied to the | |
188 | * NVMe fabrics space.) | |
189 | * | |
190 | * Return: | |
191 | * 0: successful read | |
192 | * > 0: NVMe error status code | |
193 | * < 0: Linux errno error code | |
194 | */ | |
195 | int nvmf_reg_read64(struct nvme_ctrl *ctrl, u32 off, u64 *val) | |
196 | { | |
197 | struct nvme_command cmd; | |
d49187e9 | 198 | union nvme_result res; |
07bfcd09 CH |
199 | int ret; |
200 | ||
201 | memset(&cmd, 0, sizeof(cmd)); | |
202 | cmd.prop_get.opcode = nvme_fabrics_command; | |
203 | cmd.prop_get.fctype = nvme_fabrics_type_property_get; | |
204 | cmd.prop_get.attrib = 1; | |
205 | cmd.prop_get.offset = cpu_to_le32(off); | |
206 | ||
d49187e9 | 207 | ret = __nvme_submit_sync_cmd(ctrl->admin_q, &cmd, &res, NULL, 0, 0, |
07bfcd09 CH |
208 | NVME_QID_ANY, 0, 0); |
209 | ||
210 | if (ret >= 0) | |
d49187e9 | 211 | *val = le64_to_cpu(res.u64); |
07bfcd09 CH |
212 | if (unlikely(ret != 0)) |
213 | dev_err(ctrl->device, | |
214 | "Property Get error: %d, offset %#x\n", | |
215 | ret > 0 ? ret & ~NVME_SC_DNR : ret, off); | |
216 | return ret; | |
217 | } | |
218 | EXPORT_SYMBOL_GPL(nvmf_reg_read64); | |
219 | ||
220 | /** | |
221 | * nvmf_reg_write32() - NVMe Fabrics "Property Write" API function. | |
222 | * @ctrl: Host NVMe controller instance maintaining the admin | |
223 | * queue used to submit the property read command to | |
224 | * the allocated NVMe controller resource on the target system. | |
225 | * @off: Starting offset value of the targeted property | |
226 | * register (see the fabrics section of the NVMe standard). | |
227 | * @val: Input parameter that contains the value to be | |
228 | * written to the property. | |
229 | * | |
230 | * Used by the NVMe host system to write a 32-bit capsule property value | |
231 | * to an NVMe controller on the target system. | |
232 | * | |
233 | * ("Capsule property" is an "PCIe register concept" applied to the | |
234 | * NVMe fabrics space.) | |
235 | * | |
236 | * Return: | |
237 | * 0: successful write | |
238 | * > 0: NVMe error status code | |
239 | * < 0: Linux errno error code | |
240 | */ | |
241 | int nvmf_reg_write32(struct nvme_ctrl *ctrl, u32 off, u32 val) | |
242 | { | |
243 | struct nvme_command cmd; | |
244 | int ret; | |
245 | ||
246 | memset(&cmd, 0, sizeof(cmd)); | |
247 | cmd.prop_set.opcode = nvme_fabrics_command; | |
248 | cmd.prop_set.fctype = nvme_fabrics_type_property_set; | |
249 | cmd.prop_set.attrib = 0; | |
250 | cmd.prop_set.offset = cpu_to_le32(off); | |
251 | cmd.prop_set.value = cpu_to_le64(val); | |
252 | ||
253 | ret = __nvme_submit_sync_cmd(ctrl->admin_q, &cmd, NULL, NULL, 0, 0, | |
254 | NVME_QID_ANY, 0, 0); | |
255 | if (unlikely(ret)) | |
256 | dev_err(ctrl->device, | |
257 | "Property Set error: %d, offset %#x\n", | |
258 | ret > 0 ? ret & ~NVME_SC_DNR : ret, off); | |
259 | return ret; | |
260 | } | |
261 | EXPORT_SYMBOL_GPL(nvmf_reg_write32); | |
262 | ||
263 | /** | |
264 | * nvmf_log_connect_error() - Error-parsing-diagnostic print | |
265 | * out function for connect() errors. | |
266 | * | |
267 | * @ctrl: the specific /dev/nvmeX device that had the error. | |
268 | * | |
269 | * @errval: Error code to be decoded in a more human-friendly | |
270 | * printout. | |
271 | * | |
272 | * @offset: For use with the NVMe error code NVME_SC_CONNECT_INVALID_PARAM. | |
273 | * | |
274 | * @cmd: This is the SQE portion of a submission capsule. | |
275 | * | |
276 | * @data: This is the "Data" portion of a submission capsule. | |
277 | */ | |
278 | static void nvmf_log_connect_error(struct nvme_ctrl *ctrl, | |
279 | int errval, int offset, struct nvme_command *cmd, | |
280 | struct nvmf_connect_data *data) | |
281 | { | |
282 | int err_sctype = errval & (~NVME_SC_DNR); | |
283 | ||
284 | switch (err_sctype) { | |
285 | ||
286 | case (NVME_SC_CONNECT_INVALID_PARAM): | |
287 | if (offset >> 16) { | |
288 | char *inv_data = "Connect Invalid Data Parameter"; | |
289 | ||
290 | switch (offset & 0xffff) { | |
291 | case (offsetof(struct nvmf_connect_data, cntlid)): | |
292 | dev_err(ctrl->device, | |
293 | "%s, cntlid: %d\n", | |
294 | inv_data, data->cntlid); | |
295 | break; | |
296 | case (offsetof(struct nvmf_connect_data, hostnqn)): | |
297 | dev_err(ctrl->device, | |
298 | "%s, hostnqn \"%s\"\n", | |
299 | inv_data, data->hostnqn); | |
300 | break; | |
301 | case (offsetof(struct nvmf_connect_data, subsysnqn)): | |
302 | dev_err(ctrl->device, | |
303 | "%s, subsysnqn \"%s\"\n", | |
304 | inv_data, data->subsysnqn); | |
305 | break; | |
306 | default: | |
307 | dev_err(ctrl->device, | |
308 | "%s, starting byte offset: %d\n", | |
309 | inv_data, offset & 0xffff); | |
310 | break; | |
311 | } | |
312 | } else { | |
313 | char *inv_sqe = "Connect Invalid SQE Parameter"; | |
314 | ||
315 | switch (offset) { | |
316 | case (offsetof(struct nvmf_connect_command, qid)): | |
317 | dev_err(ctrl->device, | |
318 | "%s, qid %d\n", | |
319 | inv_sqe, cmd->connect.qid); | |
320 | break; | |
321 | default: | |
322 | dev_err(ctrl->device, | |
323 | "%s, starting byte offset: %d\n", | |
324 | inv_sqe, offset); | |
325 | } | |
326 | } | |
327 | break; | |
97ddc36e GJ |
328 | |
329 | case NVME_SC_CONNECT_INVALID_HOST: | |
330 | dev_err(ctrl->device, | |
331 | "Connect for subsystem %s is not allowed, hostnqn: %s\n", | |
332 | data->subsysnqn, data->hostnqn); | |
333 | break; | |
334 | ||
335 | case NVME_SC_CONNECT_CTRL_BUSY: | |
336 | dev_err(ctrl->device, | |
337 | "Connect command failed: controller is busy or not available\n"); | |
338 | break; | |
339 | ||
340 | case NVME_SC_CONNECT_FORMAT: | |
341 | dev_err(ctrl->device, | |
342 | "Connect incompatible format: %d", | |
343 | cmd->connect.recfmt); | |
344 | break; | |
345 | ||
07bfcd09 CH |
346 | default: |
347 | dev_err(ctrl->device, | |
348 | "Connect command failed, error wo/DNR bit: %d\n", | |
349 | err_sctype); | |
350 | break; | |
351 | } /* switch (err_sctype) */ | |
352 | } | |
353 | ||
354 | /** | |
355 | * nvmf_connect_admin_queue() - NVMe Fabrics Admin Queue "Connect" | |
356 | * API function. | |
357 | * @ctrl: Host nvme controller instance used to request | |
358 | * a new NVMe controller allocation on the target | |
359 | * system and establish an NVMe Admin connection to | |
360 | * that controller. | |
361 | * | |
362 | * This function enables an NVMe host device to request a new allocation of | |
363 | * an NVMe controller resource on a target system as well establish a | |
364 | * fabrics-protocol connection of the NVMe Admin queue between the | |
365 | * host system device and the allocated NVMe controller on the | |
366 | * target system via a NVMe Fabrics "Connect" command. | |
367 | * | |
368 | * Return: | |
369 | * 0: success | |
370 | * > 0: NVMe error status code | |
371 | * < 0: Linux errno error code | |
372 | * | |
373 | */ | |
374 | int nvmf_connect_admin_queue(struct nvme_ctrl *ctrl) | |
375 | { | |
376 | struct nvme_command cmd; | |
d49187e9 | 377 | union nvme_result res; |
07bfcd09 CH |
378 | struct nvmf_connect_data *data; |
379 | int ret; | |
380 | ||
381 | memset(&cmd, 0, sizeof(cmd)); | |
382 | cmd.connect.opcode = nvme_fabrics_command; | |
383 | cmd.connect.fctype = nvme_fabrics_type_connect; | |
384 | cmd.connect.qid = 0; | |
7aa1f427 | 385 | cmd.connect.sqsize = cpu_to_le16(NVME_AQ_DEPTH - 1); |
f994d9dc | 386 | |
038bd4cb SG |
387 | /* |
388 | * Set keep-alive timeout in seconds granularity (ms * 1000) | |
389 | * and add a grace period for controller kato enforcement | |
390 | */ | |
391 | cmd.connect.kato = ctrl->opts->discovery_nqn ? 0 : | |
392 | cpu_to_le32((ctrl->kato + NVME_KATO_GRACE) * 1000); | |
07bfcd09 CH |
393 | |
394 | data = kzalloc(sizeof(*data), GFP_KERNEL); | |
395 | if (!data) | |
396 | return -ENOMEM; | |
397 | ||
8e412263 | 398 | uuid_copy(&data->hostid, &ctrl->opts->host->id); |
07bfcd09 CH |
399 | data->cntlid = cpu_to_le16(0xffff); |
400 | strncpy(data->subsysnqn, ctrl->opts->subsysnqn, NVMF_NQN_SIZE); | |
401 | strncpy(data->hostnqn, ctrl->opts->host->nqn, NVMF_NQN_SIZE); | |
402 | ||
d49187e9 | 403 | ret = __nvme_submit_sync_cmd(ctrl->admin_q, &cmd, &res, |
07bfcd09 CH |
404 | data, sizeof(*data), 0, NVME_QID_ANY, 1, |
405 | BLK_MQ_REQ_RESERVED | BLK_MQ_REQ_NOWAIT); | |
406 | if (ret) { | |
d49187e9 | 407 | nvmf_log_connect_error(ctrl, ret, le32_to_cpu(res.u32), |
07bfcd09 CH |
408 | &cmd, data); |
409 | goto out_free_data; | |
410 | } | |
411 | ||
d49187e9 | 412 | ctrl->cntlid = le16_to_cpu(res.u16); |
07bfcd09 CH |
413 | |
414 | out_free_data: | |
415 | kfree(data); | |
416 | return ret; | |
417 | } | |
418 | EXPORT_SYMBOL_GPL(nvmf_connect_admin_queue); | |
419 | ||
420 | /** | |
421 | * nvmf_connect_io_queue() - NVMe Fabrics I/O Queue "Connect" | |
422 | * API function. | |
423 | * @ctrl: Host nvme controller instance used to establish an | |
424 | * NVMe I/O queue connection to the already allocated NVMe | |
425 | * controller on the target system. | |
426 | * @qid: NVMe I/O queue number for the new I/O connection between | |
427 | * host and target (note qid == 0 is illegal as this is | |
428 | * the Admin queue, per NVMe standard). | |
429 | * | |
430 | * This function issues a fabrics-protocol connection | |
431 | * of a NVMe I/O queue (via NVMe Fabrics "Connect" command) | |
432 | * between the host system device and the allocated NVMe controller | |
433 | * on the target system. | |
434 | * | |
435 | * Return: | |
436 | * 0: success | |
437 | * > 0: NVMe error status code | |
438 | * < 0: Linux errno error code | |
439 | */ | |
440 | int nvmf_connect_io_queue(struct nvme_ctrl *ctrl, u16 qid) | |
441 | { | |
442 | struct nvme_command cmd; | |
443 | struct nvmf_connect_data *data; | |
d49187e9 | 444 | union nvme_result res; |
07bfcd09 CH |
445 | int ret; |
446 | ||
447 | memset(&cmd, 0, sizeof(cmd)); | |
448 | cmd.connect.opcode = nvme_fabrics_command; | |
449 | cmd.connect.fctype = nvme_fabrics_type_connect; | |
450 | cmd.connect.qid = cpu_to_le16(qid); | |
451 | cmd.connect.sqsize = cpu_to_le16(ctrl->sqsize); | |
452 | ||
453 | data = kzalloc(sizeof(*data), GFP_KERNEL); | |
454 | if (!data) | |
455 | return -ENOMEM; | |
456 | ||
8e412263 | 457 | uuid_copy(&data->hostid, &ctrl->opts->host->id); |
07bfcd09 CH |
458 | data->cntlid = cpu_to_le16(ctrl->cntlid); |
459 | strncpy(data->subsysnqn, ctrl->opts->subsysnqn, NVMF_NQN_SIZE); | |
460 | strncpy(data->hostnqn, ctrl->opts->host->nqn, NVMF_NQN_SIZE); | |
461 | ||
d49187e9 | 462 | ret = __nvme_submit_sync_cmd(ctrl->connect_q, &cmd, &res, |
07bfcd09 CH |
463 | data, sizeof(*data), 0, qid, 1, |
464 | BLK_MQ_REQ_RESERVED | BLK_MQ_REQ_NOWAIT); | |
465 | if (ret) { | |
d49187e9 | 466 | nvmf_log_connect_error(ctrl, ret, le32_to_cpu(res.u32), |
07bfcd09 CH |
467 | &cmd, data); |
468 | } | |
469 | kfree(data); | |
470 | return ret; | |
471 | } | |
472 | EXPORT_SYMBOL_GPL(nvmf_connect_io_queue); | |
473 | ||
42a45274 SG |
474 | bool nvmf_should_reconnect(struct nvme_ctrl *ctrl) |
475 | { | |
476 | if (ctrl->opts->max_reconnects != -1 && | |
fdf9dfa8 | 477 | ctrl->nr_reconnects < ctrl->opts->max_reconnects) |
42a45274 SG |
478 | return true; |
479 | ||
480 | return false; | |
481 | } | |
482 | EXPORT_SYMBOL_GPL(nvmf_should_reconnect); | |
483 | ||
07bfcd09 CH |
484 | /** |
485 | * nvmf_register_transport() - NVMe Fabrics Library registration function. | |
486 | * @ops: Transport ops instance to be registered to the | |
487 | * common fabrics library. | |
488 | * | |
489 | * API function that registers the type of specific transport fabric | |
490 | * being implemented to the common NVMe fabrics library. Part of | |
491 | * the overall init sequence of starting up a fabrics driver. | |
492 | */ | |
e5a39dd8 | 493 | int nvmf_register_transport(struct nvmf_transport_ops *ops) |
07bfcd09 | 494 | { |
e5a39dd8 JT |
495 | if (!ops->create_ctrl) |
496 | return -EINVAL; | |
497 | ||
489beb91 | 498 | down_write(&nvmf_transports_rwsem); |
07bfcd09 | 499 | list_add_tail(&ops->entry, &nvmf_transports); |
489beb91 | 500 | up_write(&nvmf_transports_rwsem); |
e5a39dd8 JT |
501 | |
502 | return 0; | |
07bfcd09 CH |
503 | } |
504 | EXPORT_SYMBOL_GPL(nvmf_register_transport); | |
505 | ||
506 | /** | |
507 | * nvmf_unregister_transport() - NVMe Fabrics Library unregistration function. | |
508 | * @ops: Transport ops instance to be unregistered from the | |
509 | * common fabrics library. | |
510 | * | |
511 | * Fabrics API function that unregisters the type of specific transport | |
512 | * fabric being implemented from the common NVMe fabrics library. | |
513 | * Part of the overall exit sequence of unloading the implemented driver. | |
514 | */ | |
515 | void nvmf_unregister_transport(struct nvmf_transport_ops *ops) | |
516 | { | |
489beb91 | 517 | down_write(&nvmf_transports_rwsem); |
07bfcd09 | 518 | list_del(&ops->entry); |
489beb91 | 519 | up_write(&nvmf_transports_rwsem); |
07bfcd09 CH |
520 | } |
521 | EXPORT_SYMBOL_GPL(nvmf_unregister_transport); | |
522 | ||
523 | static struct nvmf_transport_ops *nvmf_lookup_transport( | |
524 | struct nvmf_ctrl_options *opts) | |
525 | { | |
526 | struct nvmf_transport_ops *ops; | |
527 | ||
489beb91 | 528 | lockdep_assert_held(&nvmf_transports_rwsem); |
07bfcd09 CH |
529 | |
530 | list_for_each_entry(ops, &nvmf_transports, entry) { | |
531 | if (strcmp(ops->name, opts->transport) == 0) | |
532 | return ops; | |
533 | } | |
534 | ||
535 | return NULL; | |
536 | } | |
537 | ||
538 | static const match_table_t opt_tokens = { | |
539 | { NVMF_OPT_TRANSPORT, "transport=%s" }, | |
540 | { NVMF_OPT_TRADDR, "traddr=%s" }, | |
541 | { NVMF_OPT_TRSVCID, "trsvcid=%s" }, | |
542 | { NVMF_OPT_NQN, "nqn=%s" }, | |
543 | { NVMF_OPT_QUEUE_SIZE, "queue_size=%d" }, | |
544 | { NVMF_OPT_NR_IO_QUEUES, "nr_io_queues=%d" }, | |
07bfcd09 | 545 | { NVMF_OPT_RECONNECT_DELAY, "reconnect_delay=%d" }, |
42a45274 | 546 | { NVMF_OPT_CTRL_LOSS_TMO, "ctrl_loss_tmo=%d" }, |
038bd4cb | 547 | { NVMF_OPT_KATO, "keep_alive_tmo=%d" }, |
07bfcd09 | 548 | { NVMF_OPT_HOSTNQN, "hostnqn=%s" }, |
478bcb93 | 549 | { NVMF_OPT_HOST_TRADDR, "host_traddr=%s" }, |
6bfe0425 | 550 | { NVMF_OPT_HOST_ID, "hostid=%s" }, |
3b338762 | 551 | { NVMF_OPT_DUP_CONNECT, "duplicate_connect" }, |
07bfcd09 CH |
552 | { NVMF_OPT_ERR, NULL } |
553 | }; | |
554 | ||
555 | static int nvmf_parse_options(struct nvmf_ctrl_options *opts, | |
556 | const char *buf) | |
557 | { | |
558 | substring_t args[MAX_OPT_ARGS]; | |
559 | char *options, *o, *p; | |
560 | int token, ret = 0; | |
561 | size_t nqnlen = 0; | |
42a45274 | 562 | int ctrl_loss_tmo = NVMF_DEF_CTRL_LOSS_TMO; |
6bfe0425 | 563 | uuid_t hostid; |
07bfcd09 CH |
564 | |
565 | /* Set defaults */ | |
566 | opts->queue_size = NVMF_DEF_QUEUE_SIZE; | |
567 | opts->nr_io_queues = num_online_cpus(); | |
07bfcd09 | 568 | opts->reconnect_delay = NVMF_DEF_RECONNECT_DELAY; |
8edd11c9 | 569 | opts->kato = NVME_DEFAULT_KATO; |
3b338762 | 570 | opts->duplicate_connect = false; |
07bfcd09 CH |
571 | |
572 | options = o = kstrdup(buf, GFP_KERNEL); | |
573 | if (!options) | |
574 | return -ENOMEM; | |
575 | ||
6bfe0425 JT |
576 | uuid_gen(&hostid); |
577 | ||
07bfcd09 CH |
578 | while ((p = strsep(&o, ",\n")) != NULL) { |
579 | if (!*p) | |
580 | continue; | |
581 | ||
582 | token = match_token(p, opt_tokens, args); | |
583 | opts->mask |= token; | |
584 | switch (token) { | |
585 | case NVMF_OPT_TRANSPORT: | |
586 | p = match_strdup(args); | |
587 | if (!p) { | |
588 | ret = -ENOMEM; | |
589 | goto out; | |
590 | } | |
591 | opts->transport = p; | |
592 | break; | |
593 | case NVMF_OPT_NQN: | |
594 | p = match_strdup(args); | |
595 | if (!p) { | |
596 | ret = -ENOMEM; | |
597 | goto out; | |
598 | } | |
599 | opts->subsysnqn = p; | |
600 | nqnlen = strlen(opts->subsysnqn); | |
601 | if (nqnlen >= NVMF_NQN_SIZE) { | |
602 | pr_err("%s needs to be < %d bytes\n", | |
6eb72830 | 603 | opts->subsysnqn, NVMF_NQN_SIZE); |
07bfcd09 CH |
604 | ret = -EINVAL; |
605 | goto out; | |
606 | } | |
607 | opts->discovery_nqn = | |
608 | !(strcmp(opts->subsysnqn, | |
609 | NVME_DISC_SUBSYS_NAME)); | |
610 | if (opts->discovery_nqn) | |
611 | opts->nr_io_queues = 0; | |
612 | break; | |
613 | case NVMF_OPT_TRADDR: | |
614 | p = match_strdup(args); | |
615 | if (!p) { | |
616 | ret = -ENOMEM; | |
617 | goto out; | |
618 | } | |
619 | opts->traddr = p; | |
620 | break; | |
621 | case NVMF_OPT_TRSVCID: | |
622 | p = match_strdup(args); | |
623 | if (!p) { | |
624 | ret = -ENOMEM; | |
625 | goto out; | |
626 | } | |
627 | opts->trsvcid = p; | |
628 | break; | |
629 | case NVMF_OPT_QUEUE_SIZE: | |
630 | if (match_int(args, &token)) { | |
631 | ret = -EINVAL; | |
632 | goto out; | |
633 | } | |
634 | if (token < NVMF_MIN_QUEUE_SIZE || | |
635 | token > NVMF_MAX_QUEUE_SIZE) { | |
636 | pr_err("Invalid queue_size %d\n", token); | |
637 | ret = -EINVAL; | |
638 | goto out; | |
639 | } | |
640 | opts->queue_size = token; | |
641 | break; | |
642 | case NVMF_OPT_NR_IO_QUEUES: | |
643 | if (match_int(args, &token)) { | |
644 | ret = -EINVAL; | |
645 | goto out; | |
646 | } | |
647 | if (token <= 0) { | |
648 | pr_err("Invalid number of IOQs %d\n", token); | |
649 | ret = -EINVAL; | |
650 | goto out; | |
651 | } | |
652 | opts->nr_io_queues = min_t(unsigned int, | |
653 | num_online_cpus(), token); | |
654 | break; | |
038bd4cb SG |
655 | case NVMF_OPT_KATO: |
656 | if (match_int(args, &token)) { | |
657 | ret = -EINVAL; | |
658 | goto out; | |
659 | } | |
660 | ||
038bd4cb SG |
661 | if (token < 0) { |
662 | pr_err("Invalid keep_alive_tmo %d\n", token); | |
663 | ret = -EINVAL; | |
664 | goto out; | |
8edd11c9 | 665 | } else if (token == 0 && !opts->discovery_nqn) { |
038bd4cb SG |
666 | /* Allowed for debug */ |
667 | pr_warn("keep_alive_tmo 0 won't execute keep alives!!!\n"); | |
668 | } | |
669 | opts->kato = token; | |
8edd11c9 GP |
670 | |
671 | if (opts->discovery_nqn && opts->kato) { | |
672 | pr_err("Discovery controllers cannot accept KATO != 0\n"); | |
673 | ret = -EINVAL; | |
674 | goto out; | |
675 | } | |
676 | ||
038bd4cb | 677 | break; |
42a45274 SG |
678 | case NVMF_OPT_CTRL_LOSS_TMO: |
679 | if (match_int(args, &token)) { | |
680 | ret = -EINVAL; | |
681 | goto out; | |
682 | } | |
683 | ||
684 | if (token < 0) | |
685 | pr_warn("ctrl_loss_tmo < 0 will reconnect forever\n"); | |
686 | ctrl_loss_tmo = token; | |
687 | break; | |
07bfcd09 CH |
688 | case NVMF_OPT_HOSTNQN: |
689 | if (opts->host) { | |
690 | pr_err("hostnqn already user-assigned: %s\n", | |
691 | opts->host->nqn); | |
692 | ret = -EADDRINUSE; | |
693 | goto out; | |
694 | } | |
695 | p = match_strdup(args); | |
696 | if (!p) { | |
697 | ret = -ENOMEM; | |
698 | goto out; | |
699 | } | |
700 | nqnlen = strlen(p); | |
701 | if (nqnlen >= NVMF_NQN_SIZE) { | |
702 | pr_err("%s needs to be < %d bytes\n", | |
703 | p, NVMF_NQN_SIZE); | |
8eadfcb1 | 704 | kfree(p); |
07bfcd09 CH |
705 | ret = -EINVAL; |
706 | goto out; | |
707 | } | |
708 | opts->host = nvmf_host_add(p); | |
8eadfcb1 | 709 | kfree(p); |
07bfcd09 CH |
710 | if (!opts->host) { |
711 | ret = -ENOMEM; | |
712 | goto out; | |
713 | } | |
714 | break; | |
715 | case NVMF_OPT_RECONNECT_DELAY: | |
716 | if (match_int(args, &token)) { | |
717 | ret = -EINVAL; | |
718 | goto out; | |
719 | } | |
720 | if (token <= 0) { | |
721 | pr_err("Invalid reconnect_delay %d\n", token); | |
722 | ret = -EINVAL; | |
723 | goto out; | |
724 | } | |
725 | opts->reconnect_delay = token; | |
726 | break; | |
478bcb93 JS |
727 | case NVMF_OPT_HOST_TRADDR: |
728 | p = match_strdup(args); | |
729 | if (!p) { | |
730 | ret = -ENOMEM; | |
731 | goto out; | |
732 | } | |
733 | opts->host_traddr = p; | |
734 | break; | |
6bfe0425 JT |
735 | case NVMF_OPT_HOST_ID: |
736 | p = match_strdup(args); | |
737 | if (!p) { | |
738 | ret = -ENOMEM; | |
739 | goto out; | |
740 | } | |
741 | if (uuid_parse(p, &hostid)) { | |
9b483da1 | 742 | pr_err("Invalid hostid %s\n", p); |
6bfe0425 JT |
743 | ret = -EINVAL; |
744 | goto out; | |
745 | } | |
746 | break; | |
3b338762 JS |
747 | case NVMF_OPT_DUP_CONNECT: |
748 | opts->duplicate_connect = true; | |
749 | break; | |
07bfcd09 CH |
750 | default: |
751 | pr_warn("unknown parameter or missing value '%s' in ctrl creation request\n", | |
752 | p); | |
753 | ret = -EINVAL; | |
754 | goto out; | |
755 | } | |
756 | } | |
757 | ||
42a45274 SG |
758 | if (ctrl_loss_tmo < 0) |
759 | opts->max_reconnects = -1; | |
760 | else | |
761 | opts->max_reconnects = DIV_ROUND_UP(ctrl_loss_tmo, | |
762 | opts->reconnect_delay); | |
763 | ||
07bfcd09 CH |
764 | if (!opts->host) { |
765 | kref_get(&nvmf_default_host->ref); | |
766 | opts->host = nvmf_default_host; | |
767 | } | |
768 | ||
6bfe0425 JT |
769 | uuid_copy(&opts->host->id, &hostid); |
770 | ||
07bfcd09 CH |
771 | out: |
772 | kfree(options); | |
773 | return ret; | |
774 | } | |
775 | ||
776 | static int nvmf_check_required_opts(struct nvmf_ctrl_options *opts, | |
777 | unsigned int required_opts) | |
778 | { | |
779 | if ((opts->mask & required_opts) != required_opts) { | |
780 | int i; | |
781 | ||
782 | for (i = 0; i < ARRAY_SIZE(opt_tokens); i++) { | |
783 | if ((opt_tokens[i].token & required_opts) && | |
784 | !(opt_tokens[i].token & opts->mask)) { | |
785 | pr_warn("missing parameter '%s'\n", | |
786 | opt_tokens[i].pattern); | |
787 | } | |
788 | } | |
789 | ||
790 | return -EINVAL; | |
791 | } | |
792 | ||
793 | return 0; | |
794 | } | |
795 | ||
796 | static int nvmf_check_allowed_opts(struct nvmf_ctrl_options *opts, | |
797 | unsigned int allowed_opts) | |
798 | { | |
799 | if (opts->mask & ~allowed_opts) { | |
800 | int i; | |
801 | ||
802 | for (i = 0; i < ARRAY_SIZE(opt_tokens); i++) { | |
81a0b8d7 CH |
803 | if ((opt_tokens[i].token & opts->mask) && |
804 | (opt_tokens[i].token & ~allowed_opts)) { | |
07bfcd09 CH |
805 | pr_warn("invalid parameter '%s'\n", |
806 | opt_tokens[i].pattern); | |
807 | } | |
808 | } | |
809 | ||
810 | return -EINVAL; | |
811 | } | |
812 | ||
813 | return 0; | |
814 | } | |
815 | ||
816 | void nvmf_free_options(struct nvmf_ctrl_options *opts) | |
817 | { | |
818 | nvmf_host_put(opts->host); | |
819 | kfree(opts->transport); | |
820 | kfree(opts->traddr); | |
821 | kfree(opts->trsvcid); | |
822 | kfree(opts->subsysnqn); | |
478bcb93 | 823 | kfree(opts->host_traddr); |
07bfcd09 CH |
824 | kfree(opts); |
825 | } | |
826 | EXPORT_SYMBOL_GPL(nvmf_free_options); | |
827 | ||
828 | #define NVMF_REQUIRED_OPTS (NVMF_OPT_TRANSPORT | NVMF_OPT_NQN) | |
829 | #define NVMF_ALLOWED_OPTS (NVMF_OPT_QUEUE_SIZE | NVMF_OPT_NR_IO_QUEUES | \ | |
6bfe0425 | 830 | NVMF_OPT_KATO | NVMF_OPT_HOSTNQN | \ |
3b338762 | 831 | NVMF_OPT_HOST_ID | NVMF_OPT_DUP_CONNECT) |
07bfcd09 CH |
832 | |
833 | static struct nvme_ctrl * | |
834 | nvmf_create_ctrl(struct device *dev, const char *buf, size_t count) | |
835 | { | |
836 | struct nvmf_ctrl_options *opts; | |
837 | struct nvmf_transport_ops *ops; | |
838 | struct nvme_ctrl *ctrl; | |
839 | int ret; | |
840 | ||
841 | opts = kzalloc(sizeof(*opts), GFP_KERNEL); | |
842 | if (!opts) | |
843 | return ERR_PTR(-ENOMEM); | |
844 | ||
845 | ret = nvmf_parse_options(opts, buf); | |
846 | if (ret) | |
847 | goto out_free_opts; | |
848 | ||
d1f1071f SG |
849 | |
850 | request_module("nvme-%s", opts->transport); | |
851 | ||
07bfcd09 CH |
852 | /* |
853 | * Check the generic options first as we need a valid transport for | |
854 | * the lookup below. Then clear the generic flags so that transport | |
855 | * drivers don't have to care about them. | |
856 | */ | |
857 | ret = nvmf_check_required_opts(opts, NVMF_REQUIRED_OPTS); | |
858 | if (ret) | |
859 | goto out_free_opts; | |
860 | opts->mask &= ~NVMF_REQUIRED_OPTS; | |
861 | ||
489beb91 | 862 | down_read(&nvmf_transports_rwsem); |
07bfcd09 CH |
863 | ops = nvmf_lookup_transport(opts); |
864 | if (!ops) { | |
865 | pr_info("no handler found for transport %s.\n", | |
866 | opts->transport); | |
867 | ret = -EINVAL; | |
868 | goto out_unlock; | |
869 | } | |
870 | ||
871 | ret = nvmf_check_required_opts(opts, ops->required_opts); | |
872 | if (ret) | |
873 | goto out_unlock; | |
874 | ret = nvmf_check_allowed_opts(opts, NVMF_ALLOWED_OPTS | | |
875 | ops->allowed_opts | ops->required_opts); | |
876 | if (ret) | |
877 | goto out_unlock; | |
878 | ||
879 | ctrl = ops->create_ctrl(dev, opts); | |
880 | if (IS_ERR(ctrl)) { | |
881 | ret = PTR_ERR(ctrl); | |
882 | goto out_unlock; | |
883 | } | |
884 | ||
ab9e00cc | 885 | if (strcmp(ctrl->subsys->subnqn, opts->subsysnqn)) { |
b1465c63 CH |
886 | dev_warn(ctrl->device, |
887 | "controller returned incorrect NQN: \"%s\".\n", | |
ab9e00cc | 888 | ctrl->subsys->subnqn); |
489beb91 | 889 | up_read(&nvmf_transports_rwsem); |
c5017e85 | 890 | nvme_delete_ctrl_sync(ctrl); |
b1465c63 CH |
891 | return ERR_PTR(-EINVAL); |
892 | } | |
893 | ||
489beb91 | 894 | up_read(&nvmf_transports_rwsem); |
07bfcd09 CH |
895 | return ctrl; |
896 | ||
897 | out_unlock: | |
489beb91 | 898 | up_read(&nvmf_transports_rwsem); |
07bfcd09 | 899 | out_free_opts: |
f3116d8f | 900 | nvmf_free_options(opts); |
07bfcd09 CH |
901 | return ERR_PTR(ret); |
902 | } | |
903 | ||
904 | static struct class *nvmf_class; | |
905 | static struct device *nvmf_device; | |
906 | static DEFINE_MUTEX(nvmf_dev_mutex); | |
907 | ||
908 | static ssize_t nvmf_dev_write(struct file *file, const char __user *ubuf, | |
909 | size_t count, loff_t *pos) | |
910 | { | |
911 | struct seq_file *seq_file = file->private_data; | |
912 | struct nvme_ctrl *ctrl; | |
913 | const char *buf; | |
914 | int ret = 0; | |
915 | ||
916 | if (count > PAGE_SIZE) | |
917 | return -ENOMEM; | |
918 | ||
919 | buf = memdup_user_nul(ubuf, count); | |
920 | if (IS_ERR(buf)) | |
921 | return PTR_ERR(buf); | |
922 | ||
923 | mutex_lock(&nvmf_dev_mutex); | |
924 | if (seq_file->private) { | |
925 | ret = -EINVAL; | |
926 | goto out_unlock; | |
927 | } | |
928 | ||
929 | ctrl = nvmf_create_ctrl(nvmf_device, buf, count); | |
930 | if (IS_ERR(ctrl)) { | |
931 | ret = PTR_ERR(ctrl); | |
932 | goto out_unlock; | |
933 | } | |
934 | ||
935 | seq_file->private = ctrl; | |
936 | ||
937 | out_unlock: | |
938 | mutex_unlock(&nvmf_dev_mutex); | |
939 | kfree(buf); | |
940 | return ret ? ret : count; | |
941 | } | |
942 | ||
943 | static int nvmf_dev_show(struct seq_file *seq_file, void *private) | |
944 | { | |
945 | struct nvme_ctrl *ctrl; | |
946 | int ret = 0; | |
947 | ||
948 | mutex_lock(&nvmf_dev_mutex); | |
949 | ctrl = seq_file->private; | |
950 | if (!ctrl) { | |
951 | ret = -EINVAL; | |
952 | goto out_unlock; | |
953 | } | |
954 | ||
955 | seq_printf(seq_file, "instance=%d,cntlid=%d\n", | |
956 | ctrl->instance, ctrl->cntlid); | |
957 | ||
958 | out_unlock: | |
959 | mutex_unlock(&nvmf_dev_mutex); | |
960 | return ret; | |
961 | } | |
962 | ||
963 | static int nvmf_dev_open(struct inode *inode, struct file *file) | |
964 | { | |
965 | /* | |
966 | * The miscdevice code initializes file->private_data, but doesn't | |
967 | * make use of it later. | |
968 | */ | |
969 | file->private_data = NULL; | |
970 | return single_open(file, nvmf_dev_show, NULL); | |
971 | } | |
972 | ||
973 | static int nvmf_dev_release(struct inode *inode, struct file *file) | |
974 | { | |
975 | struct seq_file *seq_file = file->private_data; | |
976 | struct nvme_ctrl *ctrl = seq_file->private; | |
977 | ||
978 | if (ctrl) | |
979 | nvme_put_ctrl(ctrl); | |
980 | return single_release(inode, file); | |
981 | } | |
982 | ||
983 | static const struct file_operations nvmf_dev_fops = { | |
984 | .owner = THIS_MODULE, | |
985 | .write = nvmf_dev_write, | |
986 | .read = seq_read, | |
987 | .open = nvmf_dev_open, | |
988 | .release = nvmf_dev_release, | |
989 | }; | |
990 | ||
991 | static struct miscdevice nvmf_misc = { | |
992 | .minor = MISC_DYNAMIC_MINOR, | |
993 | .name = "nvme-fabrics", | |
994 | .fops = &nvmf_dev_fops, | |
995 | }; | |
996 | ||
997 | static int __init nvmf_init(void) | |
998 | { | |
999 | int ret; | |
1000 | ||
1001 | nvmf_default_host = nvmf_host_default(); | |
1002 | if (!nvmf_default_host) | |
1003 | return -ENOMEM; | |
1004 | ||
1005 | nvmf_class = class_create(THIS_MODULE, "nvme-fabrics"); | |
1006 | if (IS_ERR(nvmf_class)) { | |
1007 | pr_err("couldn't register class nvme-fabrics\n"); | |
1008 | ret = PTR_ERR(nvmf_class); | |
1009 | goto out_free_host; | |
1010 | } | |
1011 | ||
1012 | nvmf_device = | |
1013 | device_create(nvmf_class, NULL, MKDEV(0, 0), NULL, "ctl"); | |
1014 | if (IS_ERR(nvmf_device)) { | |
1015 | pr_err("couldn't create nvme-fabris device!\n"); | |
1016 | ret = PTR_ERR(nvmf_device); | |
1017 | goto out_destroy_class; | |
1018 | } | |
1019 | ||
1020 | ret = misc_register(&nvmf_misc); | |
1021 | if (ret) { | |
1022 | pr_err("couldn't register misc device: %d\n", ret); | |
1023 | goto out_destroy_device; | |
1024 | } | |
1025 | ||
1026 | return 0; | |
1027 | ||
1028 | out_destroy_device: | |
1029 | device_destroy(nvmf_class, MKDEV(0, 0)); | |
1030 | out_destroy_class: | |
1031 | class_destroy(nvmf_class); | |
1032 | out_free_host: | |
1033 | nvmf_host_put(nvmf_default_host); | |
1034 | return ret; | |
1035 | } | |
1036 | ||
1037 | static void __exit nvmf_exit(void) | |
1038 | { | |
1039 | misc_deregister(&nvmf_misc); | |
1040 | device_destroy(nvmf_class, MKDEV(0, 0)); | |
1041 | class_destroy(nvmf_class); | |
1042 | nvmf_host_put(nvmf_default_host); | |
1043 | ||
1044 | BUILD_BUG_ON(sizeof(struct nvmf_connect_command) != 64); | |
1045 | BUILD_BUG_ON(sizeof(struct nvmf_property_get_command) != 64); | |
1046 | BUILD_BUG_ON(sizeof(struct nvmf_property_set_command) != 64); | |
1047 | BUILD_BUG_ON(sizeof(struct nvmf_connect_data) != 1024); | |
1048 | } | |
1049 | ||
1050 | MODULE_LICENSE("GPL v2"); | |
1051 | ||
1052 | module_init(nvmf_init); | |
1053 | module_exit(nvmf_exit); |