xnvme_adm

Enums

Structs

Functions

xnvme_adm_format

int xnvme_adm_format(struct xnvme_cmd_ctx *ctx, uint32_t nsid, uint8_t lbaf, uint8_t zf, uint8_t mset, uint8_t ses, uint8_t pi, uint8_t pil)

Submit and wait for completion of an NVMe Format NVM command.

TODO: consider timeout, reset, and need for library/dev re-initialization

Parameters
  • ctx – Pointer to xnvme_cmd_ctx

  • nsid – Namespace identifier

  • lbaf – The LBA format to format the Namespace with

  • zf – Zone Format

  • mset – Metadata Settings

  • ses – Secure erase settings; 0x0: No Secure Erase, 0x1: User Data erase, 0x2: Cryptographic Erase

  • pil – Protection information location; 0x0: last eight bytes of metadata, 0x1: first eight bytes of metadata

  • pi – Protection information; 0x0: Disabled, 0x1: Enabled(Type1), 0x2: Enabled(Type2), 0x3: Enabled(Type3)

Returns

On success, 0 is returned. On error, negative errno is returned.

xnvme_adm_gfeat

int xnvme_adm_gfeat(struct xnvme_cmd_ctx *ctx, uint32_t nsid, uint8_t fid, uint8_t sel, void *dbuf, size_t dbuf_nbytes)

Submit and wait for completion of an NVMe Get Features (gfeat) command.

Parameters
  • ctx – Pointer to xnvme_cmd_ctx

  • nsid – Namespace identifier

  • fid – Feature identifier

  • sel – Select which value of the feature to select, that is, one of current/default/saved/supported

  • dbuf – pointer to data-payload, use if required for the given fid

  • dbuf_nbytes – size of data-payload in bytes

Returns

On success, 0 is returned. On error, negative errno is returned.

xnvme_adm_idfy

int xnvme_adm_idfy(struct xnvme_cmd_ctx *ctx, uint8_t cns, uint16_t cntid, uint8_t nsid, uint16_t nvmsetid, uint8_t uuid, struct xnvme_spec_idfy *dbuf)

Submit and wait for completion of an NVMe Identify command.

Parameters
  • ctx – Pointer to xnvme_cmd_ctx

  • cns – the xnvme_spec_idfy_cns to retrieve

  • cntid – Controller Identifier

  • nsid – Namespace Identifier

  • nvmsetid – NVM set Identifier

  • uuid – UUID index

  • dbuf – ponter to data-payload

Returns

On success, 0 is returned. On error, negative errno is returned.

xnvme_adm_idfy_ctrlr

int xnvme_adm_idfy_ctrlr(struct xnvme_cmd_ctx *ctx, struct xnvme_spec_idfy *dbuf)

Submit and wait for completion of an NVMe Identify command for the controller associated with the given device.

Parameters
  • ctx – Pointer to xnvme_cmd_ctx

  • dbuf – pointer to data-payload

Returns

On success, 0 is returned. On error, negative errno is returned.

xnvme_adm_idfy_ctrlr_csi

int xnvme_adm_idfy_ctrlr_csi(struct xnvme_cmd_ctx *ctx, uint8_t csi, struct xnvme_spec_idfy *dbuf)

Submit and wait for completion of an NVMe Identify Controller command.

Parameters
Returns

On success, 0 is returned. On error, negative errno is returned.

xnvme_adm_idfy_ns

int xnvme_adm_idfy_ns(struct xnvme_cmd_ctx *ctx, uint32_t nsid, struct xnvme_spec_idfy *dbuf)

Submit and wait for completion of an NVMe Identify command for the given nsid.

Execute an NVMe identify namespace command for the namespace associated with the given ‘dev’ when ‘nsid’=0, execute for the given ‘nsid’ when it is > 0, when the given ‘nsid’ == 0, then the command is executed for the namespace associated with the given device

Parameters
Returns

On success, 0 is returned. On error, negative errno is returned.

xnvme_adm_idfy_ns_csi

int xnvme_adm_idfy_ns_csi(struct xnvme_cmd_ctx *ctx, uint32_t nsid, uint8_t csi, struct xnvme_spec_idfy *dbuf)

Submit and wait for completion of an NVMe Identify command for the given nsid.

Execute an I/O Command Set specific NVMe identify namespace command for the given ‘nsid’. When the given ‘nsid’ == 0, then the command is executed for the namespace associated with the given device

Parameters
Returns

On success, 0 is returned. On error, negative errno is returned.

xnvme_adm_log

int xnvme_adm_log(struct xnvme_cmd_ctx *ctx, uint8_t lid, uint8_t lsp, uint64_t lpo_nbytes, uint32_t nsid, uint8_t rae, void *dbuf, uint32_t dbuf_nbytes)

Submit and wait for completion of an NVMe Get Log Page command.

Parameters
  • ctx – Pointer to xnvme_cmd_ctx

  • lid – Log Page Identifier for the log to retrieve entries for

  • lsp – Log Specific Field for the log to retrieve entries for

  • lpo_nbytes – Log page Offset in BYTES

  • nsid – Namespace Identifier

  • rae – Retain Asynchronous Event, 0=Clear, 1=Retain

  • dbuf – Buffer allocated with xnvme_buf_alloc

  • dbuf_nbytes – Number of BYTES to write from log-page to buf

Returns

On success, 0 is returned. On error, negative errno is returned.

xnvme_adm_sfeat

int xnvme_adm_sfeat(struct xnvme_cmd_ctx *ctx, uint32_t nsid, uint8_t fid, uint32_t feat, uint8_t save, const void *dbuf, size_t dbuf_nbytes)

Submit and wait for completion of an NVMe Set Feature (sfeat) command.

Parameters
  • ctx – Pointer to xnvme_cmd_ctx

  • nsid – Namespace identifier

  • fid – Feature identifier (see NVMe 1.3; Figure 84)

  • feat – Structure defining feature attributes

  • save

  • dbuf – pointer to data-payload

  • dbuf_nbytes – size of the data-payload in bytes

Returns

On success, 0 is returned. On error, negative errno is returned.