PAPI_set_debug(3)

🌸 NAME 🌸

okay so bestie, welcome to PAPI_set_debug(3) from the PAPI manual — this function is literally here to set the current debug level for error output from PAPI. That's the whole name, no cap 💅

✨ SYNOPSIS ✨

💖 Detailed Description 💖

🧚 C Prototype 🧚

#include <papi.h>
int PAPI_set_debug( int level );

🎀 Parameters 🎀

• level — one of the constants shown in the table below and defined in the papi.h header file.

The possible debug levels for debugging are shown below.

• PAPI_QUIET — do not print anything, just return the error code.
• PAPI_VERB_ECONT — print error message and continue.
• PAPI_VERB_ESTOP — print error message and exit.

🦋 Return values 🦋

• PAPI_OK — listed as a return value, okay? ✨
• PAPI_EINVAL — the debug level is invalid.

The current debug level is used by both the internal error and debug message handler subroutines.

The debug handler is only used if the library was compiled with -DDEBUG.

The debug handler is called when there is an error upon a call to the PAPI API.

The error handler is always active and its behavior cannot be modified except for whether or not it prints anything.

The default PAPI debug handler prints out messages in the following form:

PAPI Error: Error Code code, symbol, description

If the error was caused from a system call and the return code is PAPI_ESYS, the message will have a colon space and the error string as reported by strerror() appended to the end.

The PAPI error handler prints out messages in the following form:

PAPI Error: message.

💀 Note 💀

This is the ONLY function that may be called BEFORE PAPI_library_init(). Like, the only one. Bestie, respect the caps. 🫶

⭐ Example ⭐

int ret;
ret = PAPI_set_debug(PAPI_VERB_ECONT);
if ( ret != PAPI_OK ) handle_error();

🔥 See also 🔥

• PAPI_library_init
• PAPI_get_opt
• PAPI_set_opt

👑 Author 👑

Generated automatically by Doxygen for PAPI from the source code.

---

mwah 💋 this page is Version 7.2.0.0, dated Wed Jun 25 2025 19:30:49, and it's the PAPI_set_debug(3) page. Byeee 🫶✨