]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blame - drivers/nvme/host/nvme.h
nvme: Add a quirk mechanism that uses identify_ctrl
[mirror_ubuntu-bionic-kernel.git] / drivers / nvme / host / nvme.h
CommitLineData
f11bb3e2
CH
1/*
2 * Copyright (c) 2011-2014, Intel Corporation.
3 *
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms and conditions of the GNU General Public License,
6 * version 2, as published by the Free Software Foundation.
7 *
8 * This program is distributed in the hope it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
11 * more details.
12 */
13
14#ifndef _NVME_H
15#define _NVME_H
16
17#include <linux/nvme.h>
18#include <linux/pci.h>
19#include <linux/kref.h>
20#include <linux/blk-mq.h>
b0b4e09c 21#include <linux/lightnvm.h>
a98e58e5 22#include <linux/sed-opal.h>
f11bb3e2 23
297465c8
CH
24enum {
25 /*
26 * Driver internal status code for commands that were cancelled due
27 * to timeouts or controller shutdown. The value is negative so
28 * that it a) doesn't overlap with the unsigned hardware error codes,
29 * and b) can easily be tested for.
30 */
31 NVME_SC_CANCELLED = -EINTR,
32};
33
f11bb3e2
CH
34extern unsigned char nvme_io_timeout;
35#define NVME_IO_TIMEOUT (nvme_io_timeout * HZ)
36
21d34711
CH
37extern unsigned char admin_timeout;
38#define ADMIN_TIMEOUT (admin_timeout * HZ)
39
5fd4ce1b
CH
40extern unsigned char shutdown_timeout;
41#define SHUTDOWN_TIMEOUT (shutdown_timeout * HZ)
42
038bd4cb
SG
43#define NVME_DEFAULT_KATO 5
44#define NVME_KATO_GRACE 10
45
f80ec966
KB
46extern unsigned int nvme_max_retries;
47
ca064085
MB
48enum {
49 NVME_NS_LBA = 0,
50 NVME_NS_LIGHTNVM = 1,
51};
52
f11bb3e2 53/*
106198ed
CH
54 * List of workarounds for devices that required behavior not specified in
55 * the standard.
f11bb3e2 56 */
106198ed
CH
57enum nvme_quirks {
58 /*
59 * Prefers I/O aligned to a stripe size specified in a vendor
60 * specific Identify field.
61 */
62 NVME_QUIRK_STRIPE_SIZE = (1 << 0),
540c801c
KB
63
64 /*
65 * The controller doesn't handle Identify value others than 0 or 1
66 * correctly.
67 */
68 NVME_QUIRK_IDENTIFY_CNS = (1 << 1),
08095e70
KB
69
70 /*
71 * The controller deterministically returns O's on reads to discarded
72 * logical blocks.
73 */
74 NVME_QUIRK_DISCARD_ZEROES = (1 << 2),
54adc010
GP
75
76 /*
77 * The controller needs a delay before starts checking the device
78 * readiness, which is done by reading the NVME_CSTS_RDY bit.
79 */
80 NVME_QUIRK_DELAY_BEFORE_CHK_RDY = (1 << 3),
106198ed
CH
81};
82
d49187e9
CH
83/*
84 * Common request structure for NVMe passthrough. All drivers must have
85 * this structure as the first member of their request-private data.
86 */
87struct nvme_request {
88 struct nvme_command *cmd;
89 union nvme_result result;
90};
91
92static inline struct nvme_request *nvme_req(struct request *req)
93{
94 return blk_mq_rq_to_pdu(req);
95}
96
54adc010
GP
97/* The below value is the specific amount of delay needed before checking
98 * readiness in case of the PCI_DEVICE(0x1c58, 0x0003), which needs the
99 * NVME_QUIRK_DELAY_BEFORE_CHK_RDY quirk enabled. The value (in ms) was
100 * found empirically.
101 */
102#define NVME_QUIRK_DELAY_AMOUNT 2000
103
bb8d261e
CH
104enum nvme_ctrl_state {
105 NVME_CTRL_NEW,
106 NVME_CTRL_LIVE,
107 NVME_CTRL_RESETTING,
def61eca 108 NVME_CTRL_RECONNECTING,
bb8d261e 109 NVME_CTRL_DELETING,
0ff9d4e1 110 NVME_CTRL_DEAD,
bb8d261e
CH
111};
112
1c63dc66 113struct nvme_ctrl {
bb8d261e 114 enum nvme_ctrl_state state;
bd4da3ab 115 bool identified;
bb8d261e 116 spinlock_t lock;
1c63dc66 117 const struct nvme_ctrl_ops *ops;
f11bb3e2 118 struct request_queue *admin_q;
07bfcd09 119 struct request_queue *connect_q;
f11bb3e2 120 struct device *dev;
1673f1f0 121 struct kref kref;
f11bb3e2 122 int instance;
5bae7f73 123 struct blk_mq_tag_set *tagset;
f11bb3e2 124 struct list_head namespaces;
69d3b8ac 125 struct mutex namespaces_mutex;
5bae7f73 126 struct device *device; /* char device */
f3ca80fc 127 struct list_head node;
075790eb 128 struct ida ns_ida;
1c63dc66 129
4f1244c8 130 struct opal_dev *opal_dev;
a98e58e5 131
f11bb3e2
CH
132 char name[12];
133 char serial[20];
134 char model[40];
135 char firmware_rev[8];
76e3914a 136 u16 cntlid;
5fd4ce1b
CH
137
138 u32 ctrl_config;
139
140 u32 page_size;
f11bb3e2 141 u32 max_hw_sectors;
f11bb3e2 142 u16 oncs;
118472ab 143 u16 vid;
8a9ae523 144 u16 oacs;
6bf25d16 145 atomic_t abort_limit;
f11bb3e2
CH
146 u8 event_limit;
147 u8 vwc;
f3ca80fc 148 u32 vs;
07bfcd09 149 u32 sgls;
038bd4cb
SG
150 u16 kas;
151 unsigned int kato;
f3ca80fc 152 bool subsystem;
106198ed 153 unsigned long quirks;
5955be21 154 struct work_struct scan_work;
f866fc42 155 struct work_struct async_event_work;
038bd4cb 156 struct delayed_work ka_work;
07bfcd09
CH
157
158 /* Fabrics only */
159 u16 sqsize;
160 u32 ioccsz;
161 u32 iorcsz;
162 u16 icdoff;
163 u16 maxcmd;
164 struct nvmf_ctrl_options *opts;
f11bb3e2
CH
165};
166
167/*
168 * An NVM Express namespace is equivalent to a SCSI LUN
169 */
170struct nvme_ns {
171 struct list_head list;
172
1c63dc66 173 struct nvme_ctrl *ctrl;
f11bb3e2
CH
174 struct request_queue *queue;
175 struct gendisk *disk;
b0b4e09c 176 struct nvm_dev *ndev;
f11bb3e2 177 struct kref kref;
075790eb 178 int instance;
f11bb3e2 179
2b9b6e86
KB
180 u8 eui[8];
181 u8 uuid[16];
182
f11bb3e2
CH
183 unsigned ns_id;
184 int lba_shift;
185 u16 ms;
186 bool ext;
187 u8 pi_type;
646017a6
KB
188 unsigned long flags;
189
190#define NVME_NS_REMOVING 0
69d9a99c 191#define NVME_NS_DEAD 1
646017a6 192
f11bb3e2
CH
193 u64 mode_select_num_blocks;
194 u32 mode_select_block_len;
195};
196
1c63dc66 197struct nvme_ctrl_ops {
1a353d85 198 const char *name;
e439bb12 199 struct module *module;
07bfcd09 200 bool is_fabrics;
1c63dc66 201 int (*reg_read32)(struct nvme_ctrl *ctrl, u32 off, u32 *val);
5fd4ce1b 202 int (*reg_write32)(struct nvme_ctrl *ctrl, u32 off, u32 val);
7fd8930f 203 int (*reg_read64)(struct nvme_ctrl *ctrl, u32 off, u64 *val);
f3ca80fc 204 int (*reset_ctrl)(struct nvme_ctrl *ctrl);
1673f1f0 205 void (*free_ctrl)(struct nvme_ctrl *ctrl);
f866fc42 206 void (*submit_async_event)(struct nvme_ctrl *ctrl, int aer_idx);
1a353d85
ML
207 int (*delete_ctrl)(struct nvme_ctrl *ctrl);
208 const char *(*get_subsysnqn)(struct nvme_ctrl *ctrl);
209 int (*get_address)(struct nvme_ctrl *ctrl, char *buf, int size);
f11bb3e2
CH
210};
211
1c63dc66
CH
212static inline bool nvme_ctrl_ready(struct nvme_ctrl *ctrl)
213{
214 u32 val = 0;
215
216 if (ctrl->ops->reg_read32(ctrl, NVME_REG_CSTS, &val))
217 return false;
218 return val & NVME_CSTS_RDY;
219}
220
f3ca80fc
CH
221static inline int nvme_reset_subsystem(struct nvme_ctrl *ctrl)
222{
223 if (!ctrl->subsystem)
224 return -ENOTTY;
225 return ctrl->ops->reg_write32(ctrl, NVME_REG_NSSR, 0x4E564D65);
226}
227
f11bb3e2
CH
228static inline u64 nvme_block_nr(struct nvme_ns *ns, sector_t sector)
229{
230 return (sector >> (ns->lba_shift - 9));
231}
232
6904242d
ML
233static inline void nvme_cleanup_cmd(struct request *req)
234{
f9d03f96
CH
235 if (req->rq_flags & RQF_SPECIAL_PAYLOAD) {
236 kfree(page_address(req->special_vec.bv_page) +
237 req->special_vec.bv_offset);
238 }
6904242d
ML
239}
240
15a190f7
CH
241static inline int nvme_error_status(u16 status)
242{
243 switch (status & 0x7ff) {
244 case NVME_SC_SUCCESS:
245 return 0;
246 case NVME_SC_CAP_EXCEEDED:
247 return -ENOSPC;
248 default:
249 return -EIO;
250 }
251}
252
7688faa6
CH
253static inline bool nvme_req_needs_retry(struct request *req, u16 status)
254{
255 return !(status & NVME_SC_DNR || blk_noretry_request(req)) &&
f80ec966
KB
256 (jiffies - req->start_time) < req->timeout &&
257 req->retries < nvme_max_retries;
7688faa6
CH
258}
259
c55a2fd4 260void nvme_cancel_request(struct request *req, void *data, bool reserved);
bb8d261e
CH
261bool nvme_change_ctrl_state(struct nvme_ctrl *ctrl,
262 enum nvme_ctrl_state new_state);
5fd4ce1b
CH
263int nvme_disable_ctrl(struct nvme_ctrl *ctrl, u64 cap);
264int nvme_enable_ctrl(struct nvme_ctrl *ctrl, u64 cap);
265int nvme_shutdown_ctrl(struct nvme_ctrl *ctrl);
f3ca80fc
CH
266int nvme_init_ctrl(struct nvme_ctrl *ctrl, struct device *dev,
267 const struct nvme_ctrl_ops *ops, unsigned long quirks);
53029b04 268void nvme_uninit_ctrl(struct nvme_ctrl *ctrl);
1673f1f0 269void nvme_put_ctrl(struct nvme_ctrl *ctrl);
7fd8930f 270int nvme_init_identify(struct nvme_ctrl *ctrl);
5bae7f73 271
5955be21 272void nvme_queue_scan(struct nvme_ctrl *ctrl);
5bae7f73 273void nvme_remove_namespaces(struct nvme_ctrl *ctrl);
1673f1f0 274
4f1244c8
CH
275int nvme_sec_submit(void *data, u16 spsp, u8 secp, void *buffer, size_t len,
276 bool send);
a98e58e5 277
f866fc42 278#define NVME_NR_AERS 1
7bf58533
CH
279void nvme_complete_async_event(struct nvme_ctrl *ctrl, __le16 status,
280 union nvme_result *res);
f866fc42
CH
281void nvme_queue_async_events(struct nvme_ctrl *ctrl);
282
25646264
KB
283void nvme_stop_queues(struct nvme_ctrl *ctrl);
284void nvme_start_queues(struct nvme_ctrl *ctrl);
69d9a99c 285void nvme_kill_queues(struct nvme_ctrl *ctrl);
363c9aac 286
eb71f435 287#define NVME_QID_ANY -1
4160982e 288struct request *nvme_alloc_request(struct request_queue *q,
eb71f435 289 struct nvme_command *cmd, unsigned int flags, int qid);
7688faa6 290void nvme_requeue_req(struct request *req);
8093f7ca
ML
291int nvme_setup_cmd(struct nvme_ns *ns, struct request *req,
292 struct nvme_command *cmd);
f11bb3e2
CH
293int nvme_submit_sync_cmd(struct request_queue *q, struct nvme_command *cmd,
294 void *buf, unsigned bufflen);
295int __nvme_submit_sync_cmd(struct request_queue *q, struct nvme_command *cmd,
d49187e9 296 union nvme_result *result, void *buffer, unsigned bufflen,
eb71f435 297 unsigned timeout, int qid, int at_head, int flags);
4160982e
CH
298int nvme_submit_user_cmd(struct request_queue *q, struct nvme_command *cmd,
299 void __user *ubuffer, unsigned bufflen, u32 *result,
300 unsigned timeout);
0b7f1f26
KB
301int __nvme_submit_user_cmd(struct request_queue *q, struct nvme_command *cmd,
302 void __user *ubuffer, unsigned bufflen,
303 void __user *meta_buffer, unsigned meta_len, u32 meta_seed,
f11bb3e2 304 u32 *result, unsigned timeout);
1c63dc66
CH
305int nvme_identify_ctrl(struct nvme_ctrl *dev, struct nvme_id_ctrl **id);
306int nvme_identify_ns(struct nvme_ctrl *dev, unsigned nsid,
f11bb3e2 307 struct nvme_id_ns **id);
1c63dc66
CH
308int nvme_get_log_page(struct nvme_ctrl *dev, struct nvme_smart_log **log);
309int nvme_get_features(struct nvme_ctrl *dev, unsigned fid, unsigned nsid,
1a6fe74d 310 void *buffer, size_t buflen, u32 *result);
1c63dc66 311int nvme_set_features(struct nvme_ctrl *dev, unsigned fid, unsigned dword11,
1a6fe74d 312 void *buffer, size_t buflen, u32 *result);
9a0be7ab 313int nvme_set_queue_count(struct nvme_ctrl *ctrl, int *count);
038bd4cb
SG
314void nvme_start_keep_alive(struct nvme_ctrl *ctrl);
315void nvme_stop_keep_alive(struct nvme_ctrl *ctrl);
f11bb3e2
CH
316
317struct sg_io_hdr;
318
319int nvme_sg_io(struct nvme_ns *ns, struct sg_io_hdr __user *u_hdr);
320int nvme_sg_io32(struct nvme_ns *ns, unsigned long arg);
321int nvme_sg_get_version_num(int __user *ip);
322
c4699e70 323#ifdef CONFIG_NVM
ca064085 324int nvme_nvm_ns_supported(struct nvme_ns *ns, struct nvme_id_ns *id);
3dc87dd0 325int nvme_nvm_register(struct nvme_ns *ns, char *disk_name, int node);
b0b4e09c 326void nvme_nvm_unregister(struct nvme_ns *ns);
3dc87dd0
MB
327int nvme_nvm_register_sysfs(struct nvme_ns *ns);
328void nvme_nvm_unregister_sysfs(struct nvme_ns *ns);
84d4add7 329int nvme_nvm_ioctl(struct nvme_ns *ns, unsigned int cmd, unsigned long arg);
c4699e70 330#else
b0b4e09c 331static inline int nvme_nvm_register(struct nvme_ns *ns, char *disk_name,
3dc87dd0 332 int node)
c4699e70
KB
333{
334 return 0;
335}
336
b0b4e09c 337static inline void nvme_nvm_unregister(struct nvme_ns *ns) {};
3dc87dd0
MB
338static inline int nvme_nvm_register_sysfs(struct nvme_ns *ns)
339{
340 return 0;
341}
342static inline void nvme_nvm_unregister_sysfs(struct nvme_ns *ns) {};
c4699e70
KB
343static inline int nvme_nvm_ns_supported(struct nvme_ns *ns, struct nvme_id_ns *id)
344{
345 return 0;
346}
84d4add7
MB
347static inline int nvme_nvm_ioctl(struct nvme_ns *ns, unsigned int cmd,
348 unsigned long arg)
349{
350 return -ENOTTY;
351}
3dc87dd0
MB
352#endif /* CONFIG_NVM */
353
40267efd
SL
354static inline struct nvme_ns *nvme_get_ns_from_dev(struct device *dev)
355{
356 return dev_to_disk(dev)->private_data;
357}
ca064085 358
5bae7f73
CH
359int __init nvme_core_init(void);
360void nvme_core_exit(void);
361
f11bb3e2 362#endif /* _NVME_H */