---
name: "nvme_mi_mi_subsystem_health_status_poll"
section: "2"
platform: "linux"
package: "libnvme-dev"
version: "1.13-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/nvme_mi_mi_subsystem_health_status_poll"
---

# nvme\_mi\_mi\_subsystem\_health\_status\_poll(2)

Read the Subsystem Health Data Structure from the NVM subsystem

## NAME

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

## SYNOPSIS

**int nvme\_mi\_mi\_subsystem\_health\_status\_poll** **(nvme\_mi\_ep\_t 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 -1 with errno set otherwise..