1NVME-SET-FEATURE(1)               NVMe Manual              NVME-SET-FEATURE(1)
2
3
4

NAME

6       nvme-set-feature - Sets an NVMe feature, returns applicable results
7

SYNOPSIS

9       nvme set-feature <device> [--namespace-id=<nsid> | -n <nsid>]
10                                 [--feature-id=<fid> | -f <fid>] [--value=<value> | -v <value>]
11                                 [--data-len=<data-len> | -l <data-len>]
12                                 [--data=<data-file> | -d <data-file>]
13                                 [--save| -s]
14

DESCRIPTION

16       Submits an NVMe Set Feature admin command and returns the applicable
17       results. This may be the feature’s value, or may also include a feature
18       structure if the feature requires it (ex: LBA Range Type).
19
20       The <device> parameter is mandatory and may be either the NVMe
21       character device (ex: /dev/nvme0), or a namespace block device (ex:
22       /dev/nvme0n1).
23
24       On success, the value sent to the device is displayed
25

OPTIONS

27       -n <nsid>, --namespace-id=<nsid>
28           Sets the feature for the given nsid. This is optional and most
29           features do not use this value.
30
31       -f <fid>, --feature-id=<fid>
32           The feature id to send with the command. Value provided should be
33           in hex.
34
35       -l <data-len>, --data-len=<data-len>
36           The data length for the buffer submitted for this feature. Most
37           known features do not use this value. The exceptions are LBA Range
38           Type and host identifier.
39
40       -d <data-file>, --data=<data-file>
41           The data file for the buffer submitted for this feature. Most known
42           features do not use this value. The exceptions is LBA Range Type
43           and host identifier. This defaults to STDIN so files and echo can
44           be piped.
45
46       -v <value>, --value=<value>
47           The value for command dword 11, the value you want to set the
48           feature to.
49
50       -s, --save
51           Save the attribute so that it persists through all power states and
52           resets.
53

EXAMPLES

55       ·   Sets the Power State (PS) to 1 in feature id 2:
56
57               # nvme set-feature /dev/nvme0 -f 2 /dev/nvme0n1 -v 0x1
58
59       ·   Sets the host id to the ascii string.
60
61               # echo "abcdefgh" | nvme set-feature /dev/nvme0 -f 0x81 -l 8
62

NVME

64       Part of the nvme-user suite
65
66
67
68NVMe                              01/07/2020               NVME-SET-FEATURE(1)
Impressum