nvme: add support for streams and directives

This adds support for Directives in NVMe, particular for the Streams
directive. Support for Directives is a new feature in NVMe 1.3. It
allows a user to pass in information about where to store the data, so
that it the device can do so most effiently. If an application is
managing and writing data with different life times, mixing differently
retentioned data onto the same locations on flash can cause write
amplification to grow. This, in turn, will reduce performance and life
time of the device.

Reviewed-by: Martin K. Petersen <martin.petersen@oracle.com>
Signed-off-by: Jens Axboe <axboe@kernel.dk>

1 files changed, 48 insertions, 0 deletions

diff --git a/include/linux/nvme.h b/include/linux/nvme.h
index 291587a0743f..f516a975bb21 100644
--- a/include/linux/nvme.h
+++ b/include/linux/nvme.h
@@ -253,6 +253,7 @@ enum {
         NVME_CTRL_ONCS_WRITE_ZEROES             = 1 << 3,
         NVME_CTRL_VWC_PRESENT                   = 1 << 0,
         NVME_CTRL_OACS_SEC_SUPP                 = 1 << 0,
+        NVME_CTRL_OACS_DIRECTIVES               = 1 << 5,
         NVME_CTRL_OACS_DBBUF_SUPP               = 1 << 7,
 };
 
@@ -304,6 +305,19 @@ enum {
 };
 
 enum {
+        NVME_DIR_IDENTIFY               = 0x00,
+        NVME_DIR_STREAMS                = 0x01,
+        NVME_DIR_SND_ID_OP_ENABLE       = 0x01,
+        NVME_DIR_SND_ST_OP_REL_ID       = 0x01,
+        NVME_DIR_SND_ST_OP_REL_RSC      = 0x02,
+        NVME_DIR_RCV_ID_OP_PARAM        = 0x01,
+        NVME_DIR_RCV_ST_OP_PARAM        = 0x01,
+        NVME_DIR_RCV_ST_OP_STATUS       = 0x02,
+        NVME_DIR_RCV_ST_OP_RESOURCE     = 0x03,
+        NVME_DIR_ENDIR                  = 0x01,
+};
+
+enum {
         NVME_NS_FEAT_THIN       = 1 << 0,
         NVME_NS_FLBAS_LBA_MASK  = 0xf,
         NVME_NS_FLBAS_META_EXT  = 0x10,
@@ -560,6 +574,7 @@ enum {
         NVME_RW_PRINFO_PRCHK_APP        = 1 << 11,
         NVME_RW_PRINFO_PRCHK_GUARD      = 1 << 12,
         NVME_RW_PRINFO_PRACT            = 1 << 13,
+        NVME_RW_DTYPE_STREAMS           = 1 << 4,
 };
 
 struct nvme_dsm_cmd {
@@ -634,6 +649,8 @@ enum nvme_admin_opcode {
         nvme_admin_download_fw          = 0x11,
         nvme_admin_ns_attach            = 0x15,
         nvme_admin_keep_alive           = 0x18,
+        nvme_admin_directive_send       = 0x19,
+        nvme_admin_directive_recv       = 0x1a,
         nvme_admin_dbbuf                = 0x7C,
         nvme_admin_format_nvm           = 0x80,
         nvme_admin_security_send        = 0x81,
@@ -797,6 +814,24 @@ struct nvme_get_log_page_command {
         __u32                   rsvd14[2];
 };
 
+struct nvme_directive_cmd {
+        __u8                    opcode;
+        __u8                    flags;
+        __u16                   command_id;
+        __le32                  nsid;
+        __u64                   rsvd2[2];
+        union nvme_data_ptr     dptr;
+        __le32                  numd;
+        __u8                    doper;
+        __u8                    dtype;
+        __le16                  dspec;
+        __u8                    endir;
+        __u8                    tdtype;
+        __u16                   rsvd15;
+
+        __u32                   rsvd16[3];
+};
+
 /*
  * Fabrics subcommands.
  */
@@ -927,6 +962,18 @@ struct nvme_dbbuf {
         __u32                   rsvd12[6];
 };
 
+struct streams_directive_params {
+        __u16   msl;
+        __u16   nssa;
+        __u16   nsso;
+        __u8    rsvd[10];
+        __u32   sws;
+        __u16   sgs;
+        __u16   nsa;
+        __u16   nso;
+        __u8    rsvd2[6];
+};
+
 struct nvme_command {
         union {
                 struct nvme_common_command common;
@@ -947,6 +994,7 @@ struct nvme_command {
                 struct nvmf_property_set_command prop_set;
                 struct nvmf_property_get_command prop_get;
                 struct nvme_dbbuf dbbuf;
+                struct nvme_directive_cmd directive;
         };
 };