NAME

pfm_$rls_cleanup − release a cleanup handler

SYNOPSIS

C Syntax

#include <idl/c/base.h>
#include <ppfm.h>
 
void pfm_$rls_cleanup(
pfm_$cleanup_rec *cleanup_record,
status_$t *status)

Pascal Syntax

%include ’/sys/ins/base.ins.pas’;
%include ’/sys/ins/pfm.ins.pas’;
 
procedure pfm_$rls_cleanup(
in cleanup_record: pfm_$cleanup_rec;
out status: status_$t);

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

NOTE

This note concerns use of pfm_$rls_cleanup() on Apollo systems. 

In the SR10.0 and SR10.1 versions of <apollo/pfm.h>, the first argument of pfm_$rls_cleanup() is incorrectly preceded by an ampersand (&).  In the SR10.2 version, the first argument is correctly preceded by an asterisk (*). 

Programs compiled under SR10.0 or SR10.1 will continue to run correctly, since the implementation of pfm_$rls_cleanup() has not changed, but you may need to modify these programs in order to compile them under SR10.2.  Invocations of pfm_$rls_cleanup() that resembled:

pfm_$rls_cleanup(crec, &st)

when compiled under SR10.0 and SR10.1 must be modified to:

pfm_$rls_cleanup(&crec, &st)

when compiled under SR10.2. 

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995