libnvme_mi_mi_pda_read(9)

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.