summaryrefslogtreecommitdiffstats
path: root/Documentation/nvme-show-regs.txt
blob: 0460365f7e8bd2f0c6372f8ec7eefed1cfbfdaf4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
nvme-id-ns(1)
=============

NAME
----
nvme-show-regs - Reads and shows the defined NVMe controller registers for
NVMe over PCIe or the controller properties for NVMe over Fabrics.

SYNOPSIS
--------
[verse]
'nvme show-regs' <device> [--human-readable | -H]
			[--output-format=<fmt> | -o <fmt>] [--verbose | -v]

DESCRIPTION
-----------
For the NVMe over PCIe device given, sends an identify namespace command and
provides the result and returned structure.
For the NVMe over Fabrics device given, sends a fabric command and provides
the result and returned structure.

The <device> parameter is mandatory and must be the nvme admin character
device (ex: /dev/nvme0). For NVMe over PCIe, the program uses knowledge of the
sysfs layout to map the device to the pci resource stored there and mmaps the
memory to get access to the registers. For NVMe over Fabrics, the programs
sends a fabric command to get the properties of the target NVMe controller.
Only the supported properties are displayed.

OPTIONS
-------
-H::
--human-readable::
	Display registers or supported properties in human readable format.

-o <fmt>::
--output-format=<fmt>::
	Set the reporting format to 'normal', 'json' or 'binary'. Only one
	output format can be used at a time.

-v::
--verbose::
	Increase the information detail in the output.

EXAMPLES
--------
* Show the NVMe over PCIe controller registers or the NVMe over Fabric controller
properties in a binary format:
+
------------
# nvme show-regs /dev/nvme0 -o binary
------------
* Show the NVMe over PCIe controller registers or the NVMe over Fabric controller
properties in a human readable format:
+
------------
# nvme show-regs /dev/nvme0 -H
------------
* Show the NVMe over PCIe controller registers or NVMe-oF controller properties
in a json format:
+
------------
# nvme show-regs /dev/nvme0 -o json
------------

NVME
----
Part of the nvme-user suite