---
name: "pmnameindom"
section: "3"
platform: "linux"
package: "libpcp3-dev"
version: "4.3.2+really4.3.1-0.1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/pmNameInDom"
---

# pmnameindom(3)

translate an instance identifier into an instance name

Part of [pmNameInDom(3)](/pmNameInDom/3.md).

## NAME

**pmNameInDom** - translate an instance identifier into an instance name

## C SYNOPSIS

**#include \<pcp/pmapi.h\>**

```
int pmNameInDom(pmInDom indom, int inst, char **name);
```

**cc ... -lpcp**

## DESCRIPTION

For the instance domain *indom*, in the current Performance Metrics Application Programming Interface (PMAPI) context, locate the instance with the internal instance identifier given by  *inst*, and return the full external instance identification via *name*.

The value for the instance domain *indom* is typically extracted from a *pmDesc* structure, following a call to [**pmLookupDesc**(3)](/pmLookupDesc/3.md) for a particular performance metric.

The space for the value of *name* will have been allocated in **pmNameInDom** with [**malloc**(3)](/malloc/3.md), and it is the responsibility of the caller to [**free**(3)](/free/3.md) the space when it is no longer required.

**pmNameInDom** returns zero on success.

## SEE ALSO

[**PMAPI**(3)](/PMAPI/3.md), [**pmGetConfig**(3)](/pmGetConfig/3.md), [**pmGetInDom**(3)](/pmGetInDom/3.md), [**pmLookupInDom**(3)](/pmLookupInDom/3.md), [**pmNameInDomArchive**(3)](/pmNameInDomArchive/3.md), [**pcp.conf**(5)](/pcp.conf/5.md) and [**pcp.env**(5)](/pcp.env/5.md).

## DIAGNOSTICS

- **PM\_ERR\_INDOM**

  *indom* is not a valid instance domain identifier

- **PM\_ERR\_INST**

  The instance identifier *inst* is not known for the instance domain *indom* in the current PMAPI context