summaryrefslogtreecommitdiffstats
path: root/Documentation/nvme-intel-internal-log.txt
blob: a1e1792d29ac77aea34f1bb424f63b1dc0e85848 (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
68
69
70
71
72
73
nvme-intel-internal-log(1)
==========================

NAME
----
nvme-intel-internal-log - Retrieve Intel device's internal log and save to file.

SYNOPSIS
--------
[verse]
'nvme intel internal-log ' <device> [--log=<NUM>, -l <NUM>]
		[--region=<NUM>, r <NUM>]
		[--nlognum=<NUM>, m <NUM>]
		[--namespace-id=<NUM>, -n <NUM>]
		[--output-file=<FILE>, -o <FILE>]

DESCRIPTION
-----------
For the NVMe device given, sends the Intel vendor unique device log
request and saves the result to a file.

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

This will only work on Intel devices supporting this feature which
includes (but not limited to) all the Intel DC P3xxx family of
controllers. Results for any other device are undefined.

OPTIONS
-------
-l <NUM>::
--log=<NUM>::
	Log type: 0, 1, or 2 for nlog, event log, and assert log,
	respectively.

-n <NUM>::
--namespace-id=<NUM>::
	Namespace to use.

-o <FILE>::
--output-file=<FILE>::
	Output file; defaults to device name provided

-r <NUM>::
--region=<NUM>::
	Select which core region to retrieve the log from. -1 for all
	available, if supported by the device.

-m <NUM>::
--nlognum=<NUM>::
	When used with 'nlog', this specifies which nlog to read. -1
	for all, if supported by the device.

EXAMPLES
--------
* Gets the nlog from the device and saves to default file:
+
------------
# nvme intel internal-log /dev/nvme0 --namespace-id=1 --log=0
------------
+

* Gets the event log from the device and saves to defined file:
+
------------
# nvme intel internal-log /dev/nvme0 --namespace-id=1 --log=1 --output-file=MyAwesomeEventLog
------------

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