NAME
libnvme_mi_mi_pda_read - Read the NVMe-MI Persistent Data Area (PDA)
SYNOPSIS
int libnvme_mi_mi_pda_read (struct libnvme_mi_ep *ep , enum nvme_mi_pda_dformat dformat , __u32 dofst , __u32 dlen , void *data , size_t *data_len );
ARGUMENTS
- ep
-
endpoint for MI communication
- dformat
-
data format to use for dofst and dlen, see enum nvme_mi_pda_dformat
- dofst
-
starting offset, in units of dformat, into the PDA to read
- dlen
-
length, in units of dformat, to read from the PDA starting at dofst
- data
-
buffer to receive the PDA contents
- data_len
-
in: size of data; out: length of data actually returned
DESCRIPTION
Performs an NVMe-MI PDA Read command. See the PDA Size (PDAS) and Supported Data Format (SDFORMAT) fields of struct nvme_mi_port_smb for the size and supported dformat values of the PDA on a given port.
RETURN
The nvme command status if a response was received (see enum nvme_status_field) or negative error code otherwise.