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

# pmiErrStr(3)

convert a LOGIMPORT error code into a string

## NAME

**pmiErrStr**, **pmiErrStr\_r** - convert a LOGIMPORT error code into a string

## C SYNOPSIS

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

**const char \*pmiErrStr(int** *code***);**\
 **char \*pmiErrStr\_r(int** *code***, char** *buf***, int** *buflen***);**

**cc ... -lpcp\_import -lpcp**

## Perl SYNOPSIS

**use PCP::LogImport;**

**pmiErrStr($***code***);**

## DESCRIPTION

As part of the Performance Co-Pilot Log Import API (see [**LOGIMPORT**(3)](/LOGIMPORT/3.md)), **pmiErrStr** translates error codes returned from the other routines in the Log Import library into printable error messages.

*code* would normally have a negative value. As a special case, if *code* is -1 then the error code returned from the last routine called in the LOGIMPORT library for this context will be used.

The **pmiErrStr\_r** function does the same, but stores the result in a user-supplied buffer *buf* of length *buflen*, which should have room for at least **PMI\_MAXERRMSGLEN** bytes.

The set of possible error codes and messages is all those defined by [**pmErrStr**(3)](/pmErrStr/3.md) and [**PCPIntro**(3)](/PCPIntro/3.md), plus the additional ones defined in **\<pcp/import.h\>** with error code names of the form **PMI\_ERR\_....**

## SEE ALSO

[**LOGIMPORT**(3)](/LOGIMPORT/3.md), [**PCPIntro**(3)](/PCPIntro/3.md) and [**pmErrStr**(3)](/pmErrStr/3.md).