---
name: "nvme_identify_secondary_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_secondary_ctrl_list"
---

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

Retrieves secondary controller list

## NAME

nvme\_identify\_secondary\_ctrl\_list - Retrieves secondary controller list

## SYNOPSIS

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

## ARGUMENTS

- fd

  File descriptor of nvme device

- cntid

  Return controllers starting at this identifier

- sc\_list

  User space destination address to transfer the data

## DESCRIPTION

A Secondary Controller List is returned to the host for up to 127 secondary controllers associated with the primary controller processing this command. The list contains entries for controller identifiers greater than or equal to the value specified in the Controller Identifier (cntid).

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

## RETURN

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