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

# nvme\_identify\_ctrl\_list(2)

Retrieves identify controller list

## NAME

nvme\_identify\_ctrl\_list - Retrieves identify controller list

## SYNOPSIS

**int nvme\_identify\_ctrl\_list** **(int fd** *,* **\_\_u16 cntid** *,* **struct nvme\_ctrl\_list \*cntlist** *);*

## ARGUMENTS

- fd

  File descriptor of nvme device

- cntid

  Starting CNTLID to return in the list

- cntlist

  User space destination address to transfer the data

## DESCRIPTION

Up to 2047 controller identifiers is returned containing a controller identifier greater than or equal to the controller identifier  specified in *cntid*.

See *struct nvme\_ctrl\_list* for a definition of the structure returned.

## RETURN

The nvme command status if a response was received (see *enum nvme\_status\_field*) or -1 with errno set otherwise.