NVME-CONNECT(1)                   NVMe Manual                  NVME-CONNECT(1)

<?><?><?> (NAME)
       nvme-connect - <?><?><?><?><?> <?><?> <?><?><?><?><?><?> NVMe-oF
       (<?><?><?><?><?><?> NVMe <?><?><?> <?><?><?><?>)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       nvme connect [--transport=<trtype> | -t <trtype>]
                               [--nqn=<subnqn> | -n <subnqn>]
                               [--traddr=<traddr> | -a <traddr>]
                               [--trsvcid=<trsvcid> | -s <trsvcid>]
                               [--host-traddr=<traddr> | -w <traddr>]
                               [--host-iface=<iface> | -f <iface>]
                               [--hostnqn=<hostnqn> | -q <hostnqn>]
                               [--hostid=<hostid> | -I <hostid>]
                               [--config=<filename> | -J <filename>]
                               [--dhchap-secret=<secret> | -S <secret>]
                               [--dhchap-ctrl-secret=<secret> | -C <secret>]
                               [--nr-io-queues=<#> | -i <#>]
                               [--nr-write-queues=<#> | -W <#>]
                               [--nr-poll-queues=<#> | -P <#>]
                               [--queue-size=<#> | -Q <#>]
                               [--keep-alive-tmo=<#> | -k <#>]
                               [--reconnect-delay=<#> | -c <#>]
                               [--ctrl-loss-tmo=<#> | -l <#>] [--tos=<#> | -T <#>]
                               [--keyring=<keyring>] [--tls-key=<tls-key>]
                               [--tls-key-identity=<identity>]
                               [--duplicate-connect | -D] [--disable-sqflow ]
                               [--hdr-digest | -g] [--data-digest | -G] [--tls]
                               [--concat] [--dump-config | -O] [--application=<id>]
                               [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       (<?><?><?><?><?><?><?><?><?>) <?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?> (<?><?><?><?><?><?><?><?> <?><?> --traddr <?> --trsvcid) <?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> NVMe over Fabrics <?><?><?><?>
       <?><?><?><?><?><?><?><?> NVMe <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> --nqn.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -t <trtype>, --transport=<trtype>
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (fabric)
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           NVMe-over-Fabrics <?><?> <?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?>:

           +----------------+---------------------------+
           |<?><?><?><?><?> | <?><?><?><?><?>           |
           +----------------+---------------------------+
           |rdma            | <?><?><?><?>              |
           |                | <?><?><?><?><?><?> <?><?> |
           |                | <?><?><?><?> rdma         |
           |                | <?><?><?> (RoCE<?><?>     |
           |                | iWARP<?><?>               |
           |                | Infiniband<?><?> rdma     |
           |                | <?><?><?><?><?> <?>       |
           |                | <?><?><?><?>).            |
           +----------------+---------------------------+
           |fc              | <?><?> <?><?><?>          |
           |                | <?><?><?><?><?> (WIP)     |
           |                | <?><?><?><?>              |
           |                | <?><?><?><?><?><?> <?><?> |
           |                | <?><?><?><?>              |
           |                | <?><?><?><?><?>           |
           |                | <?><?><?><?> (Fibre       |
           |                | Channel) <?><?><?>.       |
           +----------------+---------------------------+
           |tcp             | <?><?><?><?>              |
           |                | <?><?><?><?><?><?> <?><?> |
           |                | <?><?><?><?> TCP/IP       |
           |                | <?><?><?>.                |
           +----------------+---------------------------+
           |loop            | <?><?><?><?><?> <?><?>    |
           |                | <?><?> <?><?><?><?>       |
           |                | (<?><?><?><?><?>) NVMe    |
           |                | over Fabrics <?><?><?>    |
           |                | <?><?><?><?><?><?>        |
           |                | <?><?><?><?>              |
           +----------------+---------------------------+

       -n <subnqn>, --nqn <subnqn>
           <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> NVMe
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

       -a <traddr>, --traddr=<traddr>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?><?> IP <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> (<?><?><?><?><?> rdma)<?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?> IP (<?><?><?><?><?> IPv4) <?><?><?><?>.

       -s <trsvcid>, --trsvcid=<trsvcid>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> (transport service id) <?><?> <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?><?><?><?> IP <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> (<?><?><?><?><?> rdma)<?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> IP <?><?><?><?> <?><?><?><?><?><?> RDMA
           <?><?><?><?><?> 4420 <?><?><?>.

       -w <traddr>, --host-traddr=<traddr>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> TCP<?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       -f <iface>, --host-iface=<iface>
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?> (<?><?><?><?><?> eth1<?><?> enp2s0<?><?>
           enx78e7d1ea46da). <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?>.

       -q <hostnqn>, --hostnqn=<hostnqn>
           <?><?><?><?><?> <?><?><?><?><?><?><?> Host NQN <?><?> <?><?>
           <?><?><?><?><?><?> NVMe <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.
           <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> /etc/nvme/hostnqn <?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?> NQN <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> NVMe Host
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?> Host NQN
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> NVMe <?><?>
           <?><?><?><?> <?><?><?><?><?><?>.

       -I <hostid>, --hostid=<hostid>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (UUID) <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>.

       -J <filename>, --config=<filename>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           JSON <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> /etc/nvme/config.json <?><?> none <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> JSON <?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?>:
           https://github.com/linux-nvme/libnvme/blob/master/doc/config-schema.json

       -S <secret>, --dhchap-secret=<secret>
           <?><?><?><?> <?><?><?><?><?><?> (<?><?><?>) <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (In-band)
           <?><?><?><?><?><?> NVMe<?> <?><?><?><?> <?><?><?> <?><?><?>
           8.13.5.8 <?><?><?><?><?><?><?><?><?> NVMe 2.0 <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?> (Secret representation) <?><?>
           <?><?><?><?> ASCII <?><?><?><?>.

       -C <secret>, --dhchap-ctrl-secret=<secret>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> NVMe <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?> 8.13.5.8 <?><?><?><?><?><?><?><?><?> NVMe 2.0
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> (Secret
           representation) <?><?> <?><?><?><?> ASCII <?><?><?><?>. <?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       -i <#>, --nr-io-queues=<#>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?>/<?><?><?><?><?> (I/O) <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       -W <#>, --nr-write-queues=<#>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> I/O <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>.

       -P <#>, --nr-poll-queues=<#>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> (polling) <?><?><?><?><?><?> I/O <?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?><?>.

       -Q <#>, --queue-size=<#>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> I/O <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       -k <#>, --keep-alive-tmo=<#>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> (Keep Alive <?><?><?><?><?>
           <?><?><?><?><?>) <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       -c <#>, --reconnect-delay=<#>
           <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?>
           <?><?><?><?><?>) <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       -l <#>, --ctrl-loss-tmo=<#>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?>
           <?><?><?><?><?>) <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
           reconnect-delay <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       -T <#>, --tos=<#>
           <?><?><?> <?><?><?><?><?> (Type of Service) <?><?><?><?>
           <?><?><?><?><?> (TCP).

       --keyring=<keyring>
           <?><?><?><?> <?><?><?><?> (keyring) <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> TLS<?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?>.

       --tls-key=<tls-key>
           <?><?><?><?> TLS <?><?><?><?> <?><?><?><?><?> (TCP)<?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> TLS <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           TLS <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>. <?><?> <?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> nvme tls --import <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?> <?><?>
           <?><?><?><?><?> --tls <?><?><?><?><?><?><?> <?><?><?><?>.
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?>.

       --tls-key-identity=<identity>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           tls-key. <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> tls <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
           <?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       -D, --duplicate-connect
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?>.

       --disable-sqflow
           <?><?><?><?><?> <?><?><?><?><?> SQ (<?><?> <?><?><?><?><?>) <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> (head doorbell) <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> nvme
           <?><?><?><?><?><?><?> <?><?><?>.

       -g, --hdr-digest
           <?><?><?><?><?> <?><?><?> (header digest) <?><?>
           <?><?><?><?><?>/<?><?><?><?><?> <?><?><?><?><?><?> (TCP).

       -G, --data-digest
           <?><?><?><?><?> <?><?><?><?> (data digest) <?><?>
           <?><?><?><?><?>/<?><?><?><?><?> <?><?><?><?><?><?> (TCP).

       --tls
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> TLS
           (<?><?><?><?><?><?> TCP).

       --concat
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> (TCP).

       -O, --dump-config
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> JSON
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           (stdout).

       --context <STR>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?> <STR>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.

       -o <fmt>, --output-format=<fmt>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> normal<?>
           json <?><?> binary. <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?>.

       -v, --verbose
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       o   <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?> nqn.2014-08.com.example:nvme:nvm-subsystem-sn-d78432
           <?><?><?> <?><?><?><?><?> IPv4 <?><?><?><?><?> <?><?> 192.168.1.3.
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> 4420
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>:

               # nvme connect --transport=rdma --traddr=192.168.1.3 \
               --nqn=nqn.2014-08.com.example:nvme:nvm-subsystem-sn-d78432

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       nvme-discover(1) nvme-connect-all(1)

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> Jay Freyensee[1] <?>
       Christoph Hellwig[2] <?><?><?><?><?> <?><?><?> <?><?><?>.

NVME
       <?><?><?><?> <?><?> <?><?><?><?><?><?> nvme-user

<?><?><?><?> (NOTES)
        1. Jay Freyensee
           mailto:james.p.freyensee@intel.com

        2. Christoph Hellwig
           mailto:hch@lst.de

NVMe                              02/16/2026                   NVME-CONNECT(1)