NVME-READ(1) | NVMe Manual | NVME-READ(1) |
NAME
nvme-read - Send an NVMe Read command, provide results
SYNOPSIS
nvme-read <device> [--start-block=<slba> | -s <slba>] [--block-count=<nlb> | -c <nlb>] [--data-size=<size> | -z <size>] [--metadata-size=<size> | -y <size>] [--ref-tag=<reftag> | -r <reftag>] [--data=<data-file> | -d <data-file>] [--metadata=<metadata-file> | -M <metadata-file>] [--prinfo=<prinfo> | -p <prinfo>] [--app-tag-mask=<appmask> | -m <appmask>] [--app-tag=<apptag> | -a <apptag>] [--limited-retry | -l] [--force-unit-access | -f] [--dir-type=<type> | -T <type>] [--dir-spec=<spec> | -S <spec>] [--dsm=<dsm> | -D <dsm>] [--show-command | -V] [--dry-run | -w] [--latency | -t] [--storage-tag<storage-tag> | -g <storage-tag>] [--storage-tag-check | -C] [--force] [--output-format=<fmt> | -o <fmt>] [--verbose | -v] [--timeout=<timeout>]
DESCRIPTION
The Read command reads the logical blocks specified by the command from the medium and copies to the data data buffer provided. Will use stdout by default if you don’t provide a file.
OPTIONS
-s <slba>, --start-block=<slba>
-c, --block-count
-z <size>, --data-size=<size>
-y <size>, --metadata-size=<size>
-d <data-file>, --data=<data-file>
-M <metadata-file>, --metadata=<metadata-file>
-p <prinfo>, --prinfo=<prinfo>
Bit | Description |
3 | PRACT: Protection Information Action. When set to 1, PI is stripped/inserted on read/write when the block format’s metadata size is 8. When set to 0, metadata is passes. |
2:0 | PRCHK: Protection Information Check: |
2 | Set to 1 enables checking the guard tag |
1 | Set to 1 enables checking the application tag |
0 | Set to 1 enables checking the reference tag |
-r <reftag>, --ref-tag=<reftag>
-m <appmask>, --app-tag-mask=<appmask>
-f, --force-unit-access
-T <type>, --dir-type=<type>
-S <spec>, --dir-spec=<spec>
-D <dsm>, --dsm=<dsm>
-V, --show-cmd
-w, --dry-run
-t, --latency
-g <storage-tag>, --storage-tag=<storage-tag>
-C, --storage-tag-check
--force
-o <fmt>, --output-format=<fmt>
-v, --verbose
--timeout=<timeout>
EXAMPLES
No examples yet.
NVME
Part of the nvme-user suite
11/16/2024 | NVMe |