---
name: "MPI_T_category_get_pvars"
section: "3"
platform: "linux"
package: "openmpi"
version: "5.0.11-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/MPI_T_category_get_pvars"
---

# MPI\_T\_category\_get\_pvars(3)

*MPI\_T\_category\_get\_pvars* — Query which performance variables are in a category

## SYNTAX

### C Syntax

```
#include <mpi.h>
int MPI_T_category_get_pvars(int cat_index, int len, int indices[])
```

## INPUT PARAMETERS

- •

  **cat\_index**: Index of the category to be queried.

- •

  **len**: The length of the indices array.

## OUTPUT PARAMETERS

- •

  **indices**: An integer array of size len, indicating performance variable indices.

## DESCRIPTION

*MPI\_T\_category\_get\_pvars* can be used to query which performance variables are contained in a particular category. A category contains zero or more performance variables.

## ERRORS

*MPI\_T\_category\_get\_pvars* will fail if:

- •

  **MPI\_T\_ERR\_NOT\_INITIALIZED**: The MPI Tools interface not initialized

- •

  **MPI\_T\_ERR\_INVALID\_INDEX**: The category index is invalid

## COPYRIGHT

2003-2026, The Open MPI Community