pfm_$rls_cleanup(3)

NAME

pfm_$rls_cleanup − release a cleanup handler

SYNOPSIS

#include <idl/c/base.h>
#include <ppfm.h>

void pfm_$rls_cleanup(
pfm_$cleanup_rec *cleanup_record,
status_$t *status)

Remarks

To view this manual entry via the man(1) command, use the function name shown above without the “$” character.

DESCRIPTION

pfm_$rls_cleanup() releases the cleanup handler associated with cleanup_record().

On Apollo systems, this call releases the specified cleanup handler and all cleanup handlers established after it.

On all other systems, this call releases only the specified cleanup handler, and only the most recently established cleanup handler can be released.

If you are concerned about portability, use pfm_$rls_cleanup() only to release the most recent cleanup handler.

cleanup_record specifies the cleanup record to be released by the cleanup handler.

status is the completion status.

ERRORS

pfm_$bad_rls_order
The caller attempted to release a cleanup handler other than the one most recently established. On Apollo systems, this status is only a warning; the specified cleanup handler is released, along with any established after it. On other systems, this status probably indicates a user programming error; no cleanup handlers are released, and continued execution may result in more serious errors.