MPI\_T\_CATEGORY\_GET\_PVARS(3) Open MPI MPI\_T\_CATEGORY\_GET\_PVARS(3)

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

# [SYNTAX](#SYNTAX)

## [C Syntax](#C_Syntax)

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

# [INPUT PARAMETERS](#INPUT_PARAMETERS)

- **cat\_index**: Index of the category to be queried.
- **len**: The length of the indices array.

# [OUTPUT PARAMETERS](#OUTPUT_PARAMETERS)

•

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

# [DESCRIPTION](#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](#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](#Copyright)

2003-2026, The Open MPI Community

September 16, 2026

---

Document: MPI_T_category_get_pvars(3) from openmpi 5.0.11-r1 (Chainguard OS)
Source: https://github.com/open-mpi/ompi