libnvme\_mi\_mi\_subsystem\_health\_status\_poll(9) libnvme API manual libnvme\_mi\_mi\_subsystem\_health\_status\_poll(9)

# [NAME](#NAME)

libnvme\_mi\_mi\_subsystem\_health\_status\_poll - Read the Subsystem Health Data Structure from the NVM subsystem

# [SYNOPSIS](#SYNOPSIS)

**int libnvme\_mi\_mi\_subsystem\_health\_status\_poll** **(struct libnvme\_mi\_ep \*ep ,** **bool clear ,** **struct nvme\_mi\_nvm\_ss\_health\_status \*nshds );**

# [ARGUMENTS](#ARGUMENTS)

[ep](#ep)

endpoint for MI communication

[clear](#clear)

flag to clear the Composite Controller Status state

[nshds](#nshds)

subsystem health status data to populate

# [DESCRIPTION](#DESCRIPTION)

Retrieves the Subsystem Health Data Structure into *nshds*. If *clear* is set, requests that the Composite Controller Status bits are cleared after the read. See NVMe-MI section 5.6 for details on the CCS bits.

See *struct nvme\_mi\_nvm\_ss\_health\_status*.

# [RETURN](#RETURN)

The nvme command status if a response was received (see *enum nvme\_status\_field*) or negative error code otherwise.

libnvme\_mi\_mi\_subsystem\_health\_status\_poll October 2026

---

Document: libnvme_mi_mi_subsystem_health_status_poll-libnvme3(2) from nvme-cli 3.2-r0 (Chainguard OS)
Source: https://github.com/linux-nvme/nvme-cli