NVME−READ - Online Linux Manual PageSection : 1
Updated : 02/01/2023
Source : NVMe
Note : NVMe Manual

NAMEnvme-read − Send an NVMe Read command, provide results

SYNOPSISnvme−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<storage−tag−check> | −C <storage−tag−check>] [−−force]

DESCRIPTIONThe 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 dont provide a file​.

OPTIONS−−start−block=<slba>, −s <slba> Start block​. −−block−count, −c The number of blocks to transfer​. This is a zeroes based value to align with the kernels use of this field​. (ie​. 0 means transfer 1 block)​. −−data−size=<size>, −z <size> Size of data, in bytes​. −−metadata−size=<size>, −y <size> Size of metadata in bytes​. −−data=<data−file>, −d <data−file> Data file​. If none provided, contents are sent to STDOUT​. −−metadata=<metadata−file>, −M <metadata−file> Metadata file, if necessary​. −−prinfo=<prinfo>, −p <prinfo> Protection Information field definition​. Bit Description 3 PRACT: Protection Information Action​. When set to 1, PI is stripped/inserted on read/write when the block formats 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 −−ref−tag=<reftag>, −r <reftag> Optional reftag when used with protection information​. −−app−tag−mask=<appmask>, −m <appmask> Optional application tag mask when used with protection information​. −−force−unit−access, −f Set the force−unit access flag​. −T <type>, −−dir−type=<type> Optional directive type​. The nvme−cli only enforces the value be in the defined range for the directive type, though the NVMe specification (1​.3a) defines only one directive, 01h, for write stream identifiers​. −S <spec>, −−dir−spec=<spec> Optional field for directive specifics​. When used with write streams, this value is defined to be the write stream identifier​. The nvme−cli will not validate the stream requested is within the controllers capabilities​. −D <dsm>, −−dsm=<dsm> The optional data set management attributes for this command​. The argument for this is the least significant 8 bits of the DSM field in a write command; the most significant 16 bits of the field come from the directive specific field, if used​. This may be used to set attributes for the LBAs being written, like access frequency, type, latency, among other things, as well as yet to be defined types​. Please consult the NVMe specification for detailed breakdown of how to use this field​. −v, −−show−cmd Print out the command to be sent​. −w, −−dry−run Do not actually send the command​. If want to use −−dry−run option, −−show−cmd option must be set​. Otherwise −−dry−run option will be ignored​. −t, −−latency Print out the latency the IOCTL took (in us)​. −−storage−tag=<storage−tag>, −g <storage−tag> Variable Sized Expected Logical Block Storage Tag(ELBST)​. −−storage−tag−check=<storage−tag−check>, −C <storage−tag−check> This bit specifies the Storage Tag field shall be checked as part of end−to−end data protection processing​. −−force Ignore namespace is currently busy and performed the operation even though​.

EXAMPLESNo examples yet​.

NVMEPart of the nvme−user suite
0
Johanes Gumabo
Data Size   :   19,505 byte
man-nvme-read.1Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   5 / 170,487
Visitor ID   :     :  
Visitor IP   :   13.58.32.115   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.