[PATCH nvme-cli] nvme-connect: Add 'dhchap-secret' and 'dhchap-bidi' arguments
Sagi Grimberg
sagi at grimberg.me
Sun Sep 26 07:41:25 PDT 2021
On 9/13/21 12:42 PM, Hannes Reinecke wrote:
> Add 'dhchap-secret' and 'dhchap-bidi' arguments for nvme-connect
> to enable NVMe In-Band authentication.
> This is the nvme-cli patch to support NVMe In-band authentication as posted
> on the linux-nvme mailinglist.
>
> Signed-off-by: Hannes Reinecke <hare at suse.de>
> ---
> Documentation/nvme-connect.txt | 14 ++++++++++++++
> fabrics.c | 29 ++++++++++++++++++++++-------
> 2 files changed, 36 insertions(+), 7 deletions(-)
>
> diff --git a/Documentation/nvme-connect.txt b/Documentation/nvme-connect.txt
> index 4d7bb52..8cfc34e 100644
> --- a/Documentation/nvme-connect.txt
> +++ b/Documentation/nvme-connect.txt
> @@ -17,6 +17,7 @@ SYNOPSIS
> [--host-iface=<iface> | -f <iface>]
> [--hostnqn=<hostnqn> | -q <hostnqn>]
> [--hostid=<hostid> | -I <hostid>]
> + [--dhchap-secret=<secret> | -S <secret>]
> [--nr-io-queues=<#> | -i <#>]
> [--nr-write-queues=<#> | -W <#>]
> [--nr-poll-queues=<#> | -P <#>]
> @@ -28,6 +29,7 @@ SYNOPSIS
> [--disable-sqflow | -d]
> [--hdr-digest | -g]
> [--data-digest | -G]
> + [--dhchap-bidi | -B]
>
> DESCRIPTION
> -----------
> @@ -92,6 +94,14 @@ OPTIONS
> UUID(Universally Unique Identifier) to be discovered which should be
> formatted.
>
> +-S <secret>::
> +--dhchap-secret=<secret>::
> + NVMe In-band authentication secret; needs to be in ASCII format as
> + specified in NVMe 2.0 section 8.13.5.8 'Secret representation'.
> + If this option is not specified, the default is read from
> + /etc/nvme/hostkey. If that does not exist no in-band authentication
> + is attempted.
> +
> -i <#>::
> --nr-io-queues=<#>::
> Overrides the default number of I/O queues create by the driver.
> @@ -140,6 +150,10 @@ OPTIONS
> --data-digest::
> Generates/verifies data digest (TCP).
>
> +-B::
> +--dhchap-bidi::
> + Enable bidirectional authentication (TCP).
> +
> EXAMPLES
> --------
> * Connect to a subsystem named nqn.2014-08.com.example:nvme:nvm-subsystem-sn-d78432
> diff --git a/fabrics.c b/fabrics.c
> index b132546..d1386c3 100644
> --- a/fabrics.c
> +++ b/fabrics.c
> @@ -60,6 +60,7 @@ static const char *nvmf_htraddr = "host traddr (e.g. FC WWN's)";
> static const char *nvmf_hiface = "host interface (for tcp transport)";
> static const char *nvmf_hostnqn = "user-defined hostnqn";
> static const char *nvmf_hostid = "user-defined hostid (if default not used)";
> +static const char *nvmf_hostkey = "user-defined hostkey (if default not used)";
> static const char *nvmf_nr_io_queues = "number of io queues to use (default is core count)";
> static const char *nvmf_nr_write_queues = "number of write queues to use (default 0)";
> static const char *nvmf_nr_poll_queues = "number of poll queues to use (default 0)";
> @@ -72,6 +73,7 @@ static const char *nvmf_dup_connect = "allow duplicate connections between same
> static const char *nvmf_disable_sqflow = "disable controller sq flow control (default false)";
> static const char *nvmf_hdr_digest = "enable transport protocol header digest (TCP transport)";
> static const char *nvmf_data_digest = "enable transport protocol data digest (TCP transport)";
> +static const char *nvmf_dhchap_bidi = "enable bidirectional authentication (TCP transport)";
> static const char *nvmf_config_file = "Use specified JSON configuration file or 'none' to disable";
>
> #define NVMF_OPTS(c) \
> @@ -82,6 +84,7 @@ static const char *nvmf_config_file = "Use specified JSON configuration file or
> OPT_STRING("host-iface", 'f', "STR", &host_iface, nvmf_hiface), \
> OPT_STRING("hostnqn", 'q', "STR", &hostnqn, nvmf_hostnqn), \
> OPT_STRING("hostid", 'I', "STR", &hostid, nvmf_hostid), \
> + OPT_STRING("dhchap-secret", 'S', "STR", &hostkey, nvmf_hostkey), \
> OPT_INT("nr-io-queues", 'i', &c.nr_io_queues, nvmf_nr_io_queues), \
> OPT_INT("nr-write-queues", 'W', &c.nr_write_queues, nvmf_nr_write_queues),\
> OPT_INT("nr-poll-queues", 'P', &c.nr_poll_queues, nvmf_nr_poll_queues), \
> @@ -93,8 +96,8 @@ static const char *nvmf_config_file = "Use specified JSON configuration file or
> OPT_FLAG("duplicate-connect", 'D', &c.duplicate_connect, nvmf_dup_connect), \
> OPT_FLAG("disable-sqflow", 'd', &c.disable_sqflow, nvmf_disable_sqflow), \
> OPT_FLAG("hdr-digest", 'g', &c.hdr_digest, nvmf_hdr_digest), \
> - OPT_FLAG("data-digest", 'G', &c.data_digest, nvmf_data_digest) \
> -
> + OPT_FLAG("data-digest", 'G', &c.data_digest, nvmf_data_digest), \
> + OPT_FLAG("dhchap-bidi", 'B', &c.dhchap_bidi, nvmf_dhchap_bidi)
>
> static void space_strip_len(int max, char *str)
> {
> @@ -296,7 +299,7 @@ static int discover_from_conf_file(nvme_host_t h, const char *desc,
> {
> char *transport = NULL, *traddr = NULL, *trsvcid = NULL;
> char *host_traddr = NULL, *host_iface = NULL;
> - char *hostnqn = NULL, *hostid = NULL;
> + char *hostnqn = NULL, *hostid = NULL, *hostkey = NULL;
> char *ptr, **argv, *p, line[4096];
> int argc, ret = 0;
> FILE *f;
> @@ -369,10 +372,10 @@ out:
> int nvmf_discover(const char *desc, int argc, char **argv, bool connect)
> {
> char *nqn = NVME_DISC_SUBSYS_NAME;
> - char *hostnqn = NULL, *hostid = NULL;
> + char *hostnqn = NULL, *hostid = NULL, *hostkey = NULL;
> char *host_traddr = NULL, *host_iface = NULL;
> char *transport = NULL, *traddr = NULL, *trsvcid = NULL;
> - char *hnqn = NULL, *hid = NULL;
> + char *hnqn = NULL, *hid = NULL, *hkey = NULL;
> char *config_file = PATH_NVMF_CONFIG;
> enum nvme_print_flags flags;
> nvme_root_t r;
> @@ -434,6 +437,8 @@ int nvmf_discover(const char *desc, int argc, char **argv, bool connect)
> hostnqn = hnqn = nvmf_hostnqn_from_file();
> if (!hostid)
> hostid = hid = nvmf_hostid_from_file();
> + if (!hostkey)
> + hostkey = hkey = nvmf_hostkey_from_file();
> h = nvme_lookup_host(r, hostnqn, hostid);
> if (!h) {
> ret = ENOMEM;
> @@ -445,6 +450,8 @@ int nvmf_discover(const char *desc, int argc, char **argv, bool connect)
> else if (!strncmp(device, "/dev/", 5))
> device += 5;
> }
> + if (hostkey)
> + nvme_host_set_hostkey(h, hostkey);
Hannes, where is the implementation of this?
More information about the Linux-nvme
mailing list