[linux-2.6-block.git] / include / linux / nvme.h

/*
 * Definitions for the NVM Express interface
 * Copyright (c) 2011-2013, Intel Corporation.
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms and conditions of the GNU General Public License,
 * version 2, as published by the Free Software Foundation.
 *
 * This program is distributed in the hope it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc., 
 * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
 */

#ifndef _LINUX_NVME_H
#define _LINUX_NVME_H

#include <uapi/linux/nvme.h>
#include <linux/pci.h>
#include <linux/miscdevice.h>
#include <linux/kref.h>

struct nvme_bar {
	__u64			cap;	/* Controller Capabilities */
	__u32			vs;	/* Version */
	__u32			intms;	/* Interrupt Mask Set */
	__u32			intmc;	/* Interrupt Mask Clear */
	__u32			cc;	/* Controller Configuration */
	__u32			rsvd1;	/* Reserved */
	__u32			csts;	/* Controller Status */
	__u32			rsvd2;	/* Reserved */
	__u32			aqa;	/* Admin Queue Attributes */
	__u64			asq;	/* Admin SQ Base Address */
	__u64			acq;	/* Admin CQ Base Address */
};

#define NVME_CAP_MQES(cap)	((cap) & 0xffff)
#define NVME_CAP_TIMEOUT(cap)	(((cap) >> 24) & 0xff)
#define NVME_CAP_STRIDE(cap)	(((cap) >> 32) & 0xf)
#define NVME_CAP_MPSMIN(cap)	(((cap) >> 48) & 0xf)

enum {
	NVME_CC_ENABLE		= 1 << 0,
	NVME_CC_CSS_NVM		= 0 << 4,
	NVME_CC_MPS_SHIFT	= 7,
	NVME_CC_ARB_RR		= 0 << 11,
	NVME_CC_ARB_WRRU	= 1 << 11,
	NVME_CC_ARB_VS		= 7 << 11,
	NVME_CC_SHN_NONE	= 0 << 14,
	NVME_CC_SHN_NORMAL	= 1 << 14,
	NVME_CC_SHN_ABRUPT	= 2 << 14,
	NVME_CC_SHN_MASK	= 3 << 14,
	NVME_CC_IOSQES		= 6 << 16,
	NVME_CC_IOCQES		= 4 << 20,
	NVME_CSTS_RDY		= 1 << 0,
	NVME_CSTS_CFS		= 1 << 1,
	NVME_CSTS_SHST_NORMAL	= 0 << 2,
	NVME_CSTS_SHST_OCCUR	= 1 << 2,
	NVME_CSTS_SHST_CMPLT	= 2 << 2,
	NVME_CSTS_SHST_MASK	= 3 << 2,
};

#define NVME_VS(major, minor)	(major << 16 | minor)

#define NVME_IO_TIMEOUT	(5 * HZ)

/*
 * Represents an NVM Express device.  Each nvme_dev is a PCI function.
 */
struct nvme_dev {
	struct list_head node;
	struct nvme_queue **queues;
	u32 __iomem *dbs;
	struct pci_dev *pci_dev;
	struct dma_pool *prp_page_pool;
	struct dma_pool *prp_small_pool;
	int instance;
	int queue_count;
	u32 db_stride;
	u32 ctrl_config;
	struct msix_entry *entry;
	struct nvme_bar __iomem *bar;
	struct list_head namespaces;
	struct kref kref;
	struct miscdevice miscdev;
	work_func_t reset_workfn;
	struct work_struct reset_work;
	char name[12];
	char serial[20];
	char model[40];
	char firmware_rev[8];
	u32 max_hw_sectors;
	u32 stripe_size;
	u16 oncs;
	u16 abort_limit;
	u8 initialized;
};

/*
 * An NVM Express namespace is equivalent to a SCSI LUN
 */
struct nvme_ns {
	struct list_head list;

	struct nvme_dev *dev;
	struct request_queue *queue;
	struct gendisk *disk;

	unsigned ns_id;
	int lba_shift;
	int ms;
	u64 mode_select_num_blocks;
	u32 mode_select_block_len;
};

/*
 * The nvme_iod describes the data in an I/O, including the list of PRP
 * entries.  You can't see it in this data structure because C doesn't let
 * me express that.  Use nvme_alloc_iod to ensure there's enough space
 * allocated to store the PRP list.
 */
struct nvme_iod {
	void *private;		/* For the use of the submitter of the I/O */
	int npages;		/* In the PRP list. 0 means small pool in use */
	int offset;		/* Of PRP list */
	int nents;		/* Used in scatterlist */
	int length;		/* Of data, in bytes */
	unsigned long start_time;
	dma_addr_t first_dma;
	struct scatterlist sg[0];
};

static inline u64 nvme_block_nr(struct nvme_ns *ns, sector_t sector)
{
	return (sector >> (ns->lba_shift - 9));
}

/**
 * nvme_free_iod - frees an nvme_iod
 * @dev: The device that the I/O was submitted to
 * @iod: The memory to free
 */
void nvme_free_iod(struct nvme_dev *dev, struct nvme_iod *iod);

int nvme_setup_prps(struct nvme_dev *dev, struct nvme_common_command *cmd,
			struct nvme_iod *iod, int total_len, gfp_t gfp);
struct nvme_iod *nvme_map_user_pages(struct nvme_dev *dev, int write,
				unsigned long addr, unsigned length);
void nvme_unmap_user_pages(struct nvme_dev *dev, int write,
			struct nvme_iod *iod);
struct nvme_queue *get_nvmeq(struct nvme_dev *dev);
void put_nvmeq(struct nvme_queue *nvmeq);
int nvme_submit_sync_cmd(struct nvme_queue *nvmeq, struct nvme_command *cmd,
						u32 *result, unsigned timeout);
int nvme_submit_flush_data(struct nvme_queue *nvmeq, struct nvme_ns *ns);
int nvme_submit_admin_cmd(struct nvme_dev *, struct nvme_command *,
							u32 *result);
int nvme_identify(struct nvme_dev *, unsigned nsid, unsigned cns,
							dma_addr_t dma_addr);
int nvme_get_features(struct nvme_dev *dev, unsigned fid, unsigned nsid,
			dma_addr_t dma_addr, u32 *result);
int nvme_set_features(struct nvme_dev *dev, unsigned fid, unsigned dword11,
			dma_addr_t dma_addr, u32 *result);

struct sg_io_hdr;

int nvme_sg_io(struct nvme_ns *ns, struct sg_io_hdr __user *u_hdr);
int nvme_sg_io32(struct nvme_ns *ns, unsigned long arg);
int nvme_sg_get_version_num(int __user *ip);

#endif /* _LINUX_NVME_H */
Commit	Line	Data
b60503ba MW	1	/*
b60503ba MW	2	* Definitions for the NVM Express interface
42c77683	3	* Copyright (c) 2011-2013, Intel Corporation.
b60503ba MW	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	* You should have received a copy of the GNU General Public License along with
	15	* this program; if not, write to the Free Software Foundation, Inc.,
	16	* 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
	17	*/
	18
	19	#ifndef _LINUX_NVME_H
	20	#define _LINUX_NVME_H
	21
42c77683 MW	22	#include <uapi/linux/nvme.h>
	23	#include <linux/pci.h>
	24	#include <linux/miscdevice.h>
	25	#include <linux/kref.h>
b60503ba MW	26
	27	struct nvme_bar {
	28	__u64 cap; /* Controller Capabilities */
	29	__u32 vs; /* Version */
897cfe1c MW	30	__u32 intms; /* Interrupt Mask Set */
897cfe1c MW	31	__u32 intmc; /* Interrupt Mask Clear */
b60503ba	32	__u32 cc; /* Controller Configuration */
897cfe1c	33	__u32 rsvd1; /* Reserved */
b60503ba	34	__u32 csts; /* Controller Status */
897cfe1c	35	__u32 rsvd2; /* Reserved */
b60503ba MW	36	__u32 aqa; /* Admin Queue Attributes */
	37	__u64 asq; /* Admin SQ Base Address */
	38	__u64 acq; /* Admin CQ Base Address */
	39	};
	40
a0cadb85	41	#define NVME_CAP_MQES(cap) ((cap) & 0xffff)
22605f96	42	#define NVME_CAP_TIMEOUT(cap) (((cap) >> 24) & 0xff)
f1938f6e	43	#define NVME_CAP_STRIDE(cap) (((cap) >> 32) & 0xf)
8fc23e03	44	#define NVME_CAP_MPSMIN(cap) (((cap) >> 48) & 0xf)
22605f96	45
b60503ba MW	46	enum {
	47	NVME_CC_ENABLE = 1 << 0,
	48	NVME_CC_CSS_NVM = 0 << 4,
	49	NVME_CC_MPS_SHIFT = 7,
	50	NVME_CC_ARB_RR = 0 << 11,
	51	NVME_CC_ARB_WRRU = 1 << 11,
7f53f9d2 MW	52	NVME_CC_ARB_VS = 7 << 11,
	53	NVME_CC_SHN_NONE = 0 << 14,
	54	NVME_CC_SHN_NORMAL = 1 << 14,
	55	NVME_CC_SHN_ABRUPT = 2 << 14,
1894d8f1	56	NVME_CC_SHN_MASK = 3 << 14,
7f53f9d2 MW	57	NVME_CC_IOSQES = 6 << 16,
7f53f9d2 MW	58	NVME_CC_IOCQES = 4 << 20,
b60503ba MW	59	NVME_CSTS_RDY = 1 << 0,
	60	NVME_CSTS_CFS = 1 << 1,
	61	NVME_CSTS_SHST_NORMAL = 0 << 2,
	62	NVME_CSTS_SHST_OCCUR = 1 << 2,
	63	NVME_CSTS_SHST_CMPLT = 2 << 2,
1894d8f1	64	NVME_CSTS_SHST_MASK = 3 << 2,
b60503ba MW	65	};
	66
	67	#define NVME_VS(major, minor) (major << 16 \| minor)
	68
13c3b0fc VV	69	#define NVME_IO_TIMEOUT (5 * HZ)
	70
	71	/*
	72	* Represents an NVM Express device. Each nvme_dev is a PCI function.
	73	*/
	74	struct nvme_dev {
	75	struct list_head node;
	76	struct nvme_queue **queues;
	77	u32 __iomem *dbs;
	78	struct pci_dev *pci_dev;
	79	struct dma_pool *prp_page_pool;
	80	struct dma_pool *prp_small_pool;
	81	int instance;
	82	int queue_count;
b80d5ccc	83	u32 db_stride;
13c3b0fc VV	84	u32 ctrl_config;
	85	struct msix_entry *entry;
	86	struct nvme_bar __iomem *bar;
	87	struct list_head namespaces;
5e82e952 KB	88	struct kref kref;
5e82e952 KB	89	struct miscdevice miscdev;
9ca97374	90	work_func_t reset_workfn;
9a6b9458	91	struct work_struct reset_work;
5e82e952	92	char name[12];
13c3b0fc VV	93	char serial[20];
	94	char model[40];
	95	char firmware_rev[8];
	96	u32 max_hw_sectors;
159b67d7	97	u32 stripe_size;
13c3b0fc	98	u16 oncs;
c30341dc	99	u16 abort_limit;
d4b4ff8e	100	u8 initialized;
13c3b0fc VV	101	};
	102
	103	/*
	104	* An NVM Express namespace is equivalent to a SCSI LUN
	105	*/
	106	struct nvme_ns {
	107	struct list_head list;
	108
	109	struct nvme_dev *dev;
	110	struct request_queue *queue;
	111	struct gendisk *disk;
	112
c3bfe717	113	unsigned ns_id;
13c3b0fc	114	int lba_shift;
f410c680	115	int ms;
5d0f6131 VV	116	u64 mode_select_num_blocks;
5d0f6131 VV	117	u32 mode_select_block_len;
13c3b0fc VV	118	};
	119
	120	/*
	121	* The nvme_iod describes the data in an I/O, including the list of PRP
	122	* entries. You can't see it in this data structure because C doesn't let
	123	* me express that. Use nvme_alloc_iod to ensure there's enough space
	124	* allocated to store the PRP list.
	125	*/
	126	struct nvme_iod {
	127	void private; / For the use of the submitter of the I/O */
	128	int npages; /* In the PRP list. 0 means small pool in use */
	129	int offset; /* Of PRP list */
	130	int nents; /* Used in scatterlist */
	131	int length; /* Of data, in bytes */
6198221f	132	unsigned long start_time;
13c3b0fc VV	133	dma_addr_t first_dma;
	134	struct scatterlist sg[0];
	135	};
5d0f6131	136
063cc6d5 MW	137	static inline u64 nvme_block_nr(struct nvme_ns *ns, sector_t sector)
	138	{
	139	return (sector >> (ns->lba_shift - 9));
	140	}
	141
5d0f6131 VV	142	/**
	143	* nvme_free_iod - frees an nvme_iod
	144	* @dev: The device that the I/O was submitted to
	145	* @iod: The memory to free
	146	*/
	147	void nvme_free_iod(struct nvme_dev dev, struct nvme_iod iod);
	148
	149	int nvme_setup_prps(struct nvme_dev dev, struct nvme_common_command cmd,
	150	struct nvme_iod *iod, int total_len, gfp_t gfp);
	151	struct nvme_iod nvme_map_user_pages(struct nvme_dev dev, int write,
	152	unsigned long addr, unsigned length);
	153	void nvme_unmap_user_pages(struct nvme_dev *dev, int write,
	154	struct nvme_iod *iod);
	155	struct nvme_queue get_nvmeq(struct nvme_dev dev);
	156	void put_nvmeq(struct nvme_queue *nvmeq);
	157	int nvme_submit_sync_cmd(struct nvme_queue nvmeq, struct nvme_command cmd,
	158	u32 *result, unsigned timeout);
	159	int nvme_submit_flush_data(struct nvme_queue nvmeq, struct nvme_ns ns);
	160	int nvme_submit_admin_cmd(struct nvme_dev , struct nvme_command ,
	161	u32 *result);
	162	int nvme_identify(struct nvme_dev *, unsigned nsid, unsigned cns,
	163	dma_addr_t dma_addr);
	164	int nvme_get_features(struct nvme_dev *dev, unsigned fid, unsigned nsid,
	165	dma_addr_t dma_addr, u32 *result);
	166	int nvme_set_features(struct nvme_dev *dev, unsigned fid, unsigned dword11,
	167	dma_addr_t dma_addr, u32 *result);
	168
	169	struct sg_io_hdr;
	170
	171	int nvme_sg_io(struct nvme_ns ns, struct sg_io_hdr __user u_hdr);
320a3827	172	int nvme_sg_io32(struct nvme_ns *ns, unsigned long arg);
5d0f6131 VV	173	int nvme_sg_get_version_num(int __user *ip);
5d0f6131 VV	174
b60503ba	175	#endif /* _LINUX_NVME_H */