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.