---
name: "MPI_T_category_get_categories"
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_categories"
---

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

*MPI\_T\_category\_get\_categories* — Query which categories are in a category

## SYNTAX

### C Syntax

```
#include <mpi.h>
int MPI_T_category_get_categories(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 category indices.

## DESCRIPTION

*MPI\_T\_category\_get\_categories* can be used to query which other categories are in a category.

## ERRORS

*MPI\_T\_category\_get\_categories* 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