pmnomem(3) — Linux manual page

NAME | C SYNOPSIS | DESCRIPTION | SEE ALSO | COLOPHON

PMNOMEM(3)               Library Functions Manual              PMNOMEM(3)

NAME         top

       pmNoMem - report out of memory conditions

C SYNOPSIS         top

       #include <pcp/pmapi.h>

       void pmNoMem(const char *where, size_t size, int fatal);

       cc ... -lpcp

DESCRIPTION         top

       pmNoMem is a convenience method that may be used when malloc(3) or
       a related memory allocation service fails.

       A standard message is emitted using pmNotifyErr(3) with where used
       as  a  message  prefix and the failing allocation size is also re‐
       ported.

       If fatal is zero (and PM_RECOV_ERR is zero), pmNoMem returns  (the
       allocation  failure  is  assumed to be recoverable by the caller),
       else (and PM_FATAL_ERR is a  good  value  to  use  in  this  case)
       exit(2) is called with an argument of 1.

SEE ALSO         top

       exit(2), malloc(3), PMAPI(3) and pmNotifyErr(3).

COLOPHON         top

       This  page is part of the PCP (Performance Co-Pilot) project.  In‐
       formation about the project can be found at  ⟨http://www.pcp.io/⟩.
       If  you  have  a  bug  report  for  this  manual  page, send it to
       pcp@groups.io.  This page was obtained from the project's upstream
       Git repository ⟨https://github.com/performancecopilot/pcp.git⟩  on
       2025-08-11.   (At  that  time,  the date of the most recent commit
       that was found in the repository was 2025-08-11.)  If you discover
       any rendering problems in this HTML version of the  page,  or  you
       believe  there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page),  send  a
       mail to man-pages@man7.org

Performance Co-Pilot               PCP                         PMNOMEM(3)