nvme-get-feature man page

nvme-get-feature — Gets an NVMe feature, returns applicable results


nvme get-feature <device> [--namespace-id=<nsid> | -n <nsid>]
                          [--feature-id=<fid> | -f <fid>] [--cdw11=<cdw11>]
                          [--data-len=<data-len> | -l <data-len>]
                          [--sel=<select> | -s <select>]
                          [--raw-binary | -b]


Submits an NVMe Get Feature admin command and returns the applicable results. This may be the feature’s value, or may also include a feature structure if the feature requires it (ex: LBA Range Type).

The <device> parameter is mandatory and may be either the NVMe character device (ex: /dev/nvme0), or a namespace block device (ex: /dev/nvme0n1).

On success, the returned feature’s structure (if applicable) may be returned in one of several ways depending on the option flags; the structure may parsed by the program and printed in a readable format if it is a known structure, displayed in hex, or the raw buffer may be printed to stdout for another program to parse.


-n <nsid>, --namespace-id=<nsid>

Retrieve the feature for the given nsid. This is optional and most features do not use this value.

-f <fid>, --feature-id=<fid>

The feature id to send with the command. Value provided should be in hex.

-s <select>, --sel=<select>

Select (SEL): This field specifies which value of the attributes to return in the provided data:

Select Description
0 Current
1 Default
2 Saved
3 Supported capabilities
4–7 Reserved
-l <data-len>, --data-len=<data-len>

The data length for the buffer returned for this feature. Most known features do not use this value. The exception is LBA Range Type


The value for command dword 11, if applicable. Only known feature using this is the interrupt vector configuration feature.

-b, --raw-binary

Print the raw feature buffer to stdout if the feature returns a structure.



Part of the nvme-user suite

Referenced By


02/02/2017 NVMe Manual