---
name: "nvme_identify_nsid_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_nsid_ctrl_list"
---

# nvme\_identify\_nsid\_ctrl\_list(2)

Retrieves controller list attached to an nsid

## NAME

nvme\_identify\_nsid\_ctrl\_list - Retrieves controller list attached to an nsid

## SYNOPSIS

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

## ARGUMENTS

- fd

  File descriptor of nvme device

- nsid

  Return controllers that are attached to this nsid

- cntid

  Starting CNTLID to return in the list

- cntlist

  User space destination address to transfer the data

## DESCRIPTION

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

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