nvme-config-show(1)

# nvme-config-show(1) Manual Page

## NAME

nvme-config-show - Show the resolved NVMe-oF INI connection configuration

## SYNOPSIS

    nvme [<global-options>] config show
                            [--config=<file> | -J <file>]

## DESCRIPTION

Reads the NVMe-oF INI connection configuration file used by nvme connect-all and nvme discover, and prints every configured connection entry. The INI format is documented at https://github.com/linux-nvme/nvme-cli/blob/master/libnvme/design/CONFIG.md

By default, the file at /usr/local/etc/nvme/nvme-fabrics.conf is read. Use --config to show a file at a different path instead.

In the default and tabular output formats, each entry is rendered as the equivalent command line that would establish it: nvme connect-all for a Discovery Controller entry, nvme connect for an I/O Controller entry, preceded by a comment naming the entry’s source (which file/section it came from). The json output format instead reports each entry’s fields individually (transport, address, NQN, host identity, and any extra connect parameters).

This command never touches the network: addressing is shown exactly as configured, with no hostname resolution attempted. A persona with no hostnqn/hostid set is shown without those fields rather than the system default it would resolve to at connect time, since showing a concrete value here would suggest a fixed identity the configuration doesn’t actually pin.

## OPTIONS

-J <file>
--config=<file>

  Show this INI file instead of the default /usr/local/etc/nvme/nvme-fabrics.conf.

## GLOBAL OPTIONS

The following options are defined at the top-level `nvme` command and are available to this subcommand:

--dry-run

  Print the command that would be executed, but do not actually execute it.

--no-ioctl-probing

  Disable probing for 64-bit IOCTL support.

--no-retries

  Disable retry logic on transient errors.

-o <fmt>
--output-format=<fmt>

  Set the reporting format to normal, tabular, 'json, or binary. Only one output format may be used at a time.

--output-format-version=<version>

  Select the output format version. Version 1 uses the original field naming, while version 2 (default) provides more consistent and script-friendly field names.

--timeout=<ms>

  Set the timeout for the command in milliseconds.

-v
--verbose

  Increase the level of detail in the output. May be specified multiple times to further increase verbosity.

These options can also be set as machine-wide defaults in nvme-cli.conf(5). A command-line flag always overrides the file.

## EXAMPLES

- Show the system’s resolved configuration:

      # nvme config show

      # nvme0: Discovery Controller
      nvme connect-all --transport=tcp --traddr=192.168.1.10 --trsvcid=8009

      # nvme1: I/O Controller
      nvme connect --transport=tcp --traddr=192.168.1.10 --trsvcid=4420 \
              --nqn=nqn.2014-08.org.nvmexpress:uuid:6a4f5e3e-...

- Show a configuration file at a non-default path, as JSON:

      $ nvme config show --config /tmp/nvme-fabrics.conf -o json

## SEE ALSO

nvme-config-validate(1) nvme-config-convert(1) nvme-config-status(1) nvme-connect-all(1) nvme-discover(1) https://github.com/linux-nvme/nvme-cli/blob/master/libnvme/design/CONFIG.md

## NVME

Part of the nvme-user suite