nvme-io-mgmt-recv(1)

# nvme-io-mgmt-recv(1) Manual Page

## NAME

nvme-io-mgmt-recv - I/O Management Receive command

## SYNOPSIS

    nvme [<global-options>] io-mgmt recv <device>
                            [--namespace-id=<NUM> | -n <NUM>]
                            [--mos=<NUM> | -s <NUM>]
                            [--mo=<NUM> | -m <NUM>]
                            [--data=<FILE> | -d <FILE>]
                            [--data-len=<NUM> | -l <NUM>]

## DESCRIPTION

For the NVMe device given, issues the I/O Management Receive command with the requested management operation (mo) and management operation specific parameter (mos). This is the generic interface provided for forward compatibility as new operations are added that this program isn’t aware of at the time of its development. As such, this is a generic command that does not do any additional decoding for specific types of data received. This will only report the data as a hex dump, or binary.

The bare nvme io-mgmt-recv form (without a space) still works as a deprecated alias and will be removed in a future major version. New scripts should use nvme io-mgmt recv instead.

## OPTIONS

-n <NUM>
--namespace-id=<NUM>

  Use the provided namespace id for the command. If not provided, the namespace id of the block device will be used. If the command is issued to a non-block device, the parameter is required.

-d <FILE>
--data=<FILE>

  File to write received data into. If unspecified, received data will be hex dumped to the standard output stream.

-l <NUM>
--data-len=<NUM>

  Received data buffer length

-m <NUM>
--mo <NUM>

  Management Operation to perform.

-s <NUM>
--mos=<NUM>

  Management Operation Specific parameter.

## 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.

## NVME

Part of nvme-cli