---
name: "pmNameInDomArchive"
section: "3"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pmNameInDomArchive"
---

# pmNameInDomArchive(3)

translate an instance identifier into an instance name

## NAME

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

## C SYNOPSIS

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

**int pmNameInDomArchive(pmInDom** *indom***,** **int** *inst***,** **char \*\****name***);**

**cc ... -lpcp**

## DESCRIPTION

Provided that the current Performance Metrics Application Programming Interface (PMAPI) context is associated with a set of archives, **pmNameInDomArchive** will scan the union of all the instance domain metadata for the instance domain *indom*, locate the first instance with the internal instance identifier given by *inst*, and return the full external instance identification via *name*.

This routine is a specialized version of the more general PMAPI routine **pmNameInDom**.

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 **pmNameInDomArchive** 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.

**pmNameInDomArchive** returns zero on success.

## DIAGNOSTICS

- **PM\_ERR\_NOTARCHIVE**

  the current PMAPI context is not associated with a set of archives

- **PM\_ERR\_INDOM\_LOG**

  *indom* is not a defined instance domain identifier for the set of archives

- **PM\_ERR\_INST\_LOG**

  the instance identifier *inst* is not known for the instance domain *indom* in the set of archives

## SEE ALSO

[**PMAPI**(3)](/PMAPI/3.md), [**pmGetConfig**(3)](/pmGetConfig/3.md), [**pmGetInDomArchive**(3)](/pmGetInDomArchive/3.md), [**pmLookupInDomArchive**(3)](/pmLookupInDomArchive/3.md), [**pmNameInDom**(3)](/pmNameInDom/3.md), [**pcp.conf**(5)](/pcp.conf/5.md) and [**pcp.env**(5)](/pcp.env/5.md).