diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-10 19:41:32 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-10 19:41:32 +0000 |
| commit | f26f66d866ba1a9f3204e6fdfe2b07e67b5492ad (patch) | |
| tree | c953c007cbe4f60a147ab62f97937d58abb2e9ca /Documentation/nvme-intel-internal-log.txt | |
| parent | Initial commit. (diff) | |
| download | nvme-cli-f26f66d866ba1a9f3204e6fdfe2b07e67b5492ad.tar.xz nvme-cli-f26f66d866ba1a9f3204e6fdfe2b07e67b5492ad.zip | |
Adding upstream version 2.8.upstream/2.8
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'Documentation/nvme-intel-internal-log.txt')
| -rw-r--r-- | Documentation/nvme-intel-internal-log.txt | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/Documentation/nvme-intel-internal-log.txt b/Documentation/nvme-intel-internal-log.txt new file mode 100644 index 0000000..a1e1792 --- /dev/null +++ b/Documentation/nvme-intel-internal-log.txt @@ -0,0 +1,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 |