---
name: "libnvme_mi_mi_subsystem_health_status_poll-libnvme3"
section: "2"
platform: "linux"
package: "nvme-cli"
version: "3.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/libnvme_mi_mi_subsystem_health_status_poll-libnvme3"
---

# libnvme\_mi\_mi\_subsystem\_health\_status\_poll-libnvme3(2)

Read the Subsystem Health Data Structure from the NVM subsystem

## NAME

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

## 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

- ep

  endpoint for MI communication

- clear

  flag to clear the Composite Controller Status state

- nshds

  subsystem health status data to populate

## 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

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