nvme-config-show1
Show the resolved nvme-of ini connection configuration
Usage
nvme [<global-options>]
config
show
[{--config=<file> | -J
<file>}]
Overview
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.
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. Other versions are rejected.
-
--quiet -
Suppress informational messages. Errors are still reported, and --quiet cancels any --verbose for the library log level.
-
--set-options=<key=value>[,<key=value>...] -
Set libnvme library options for this invocation. Supported keys are force-4k, mi-probe-enabled, test-base-dir and test-sysfs-dir.
-
--timeout=<ms> -
Set the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff).
-
-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
Nvme
Part of the nvme-user suite