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 reported.

       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.
       Information about the project can be found at ⟨⟩.
       If you have a bug report for this manual page, send it to  This page was obtained from the project's upstream
       Git repository ⟨⟩ on
       2018-02-02.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-02-02.)  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

Performance Co-Pilot                 PCP                          PMNOMEM(3)