pfm_$inhibit(3)

NAME

pfm_$inhibit − inhibit asynchronous faults

SYNOPSIS (C)

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

void pfm_$inhibit(void);

SYNOPSIS (PASCAL)

%include ’/sys/ins/base.ins.pas’;
%include ’/sys/ins/pfm.ins.pas’;

procedure pfm_$inhibit;

Remarks

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

DESCRIPTION

pfm_$inhibit() prevents asynchronous faults from being passed to the calling process. While faults are inhibited, the operating system holds at most one asynchronous fault. Consequently, a call to pfm_$inhibit() can result in the loss of some signals. For that and other reasons, it is good practice to inhibit faults only when absolutely necessary.

On systems with Concurrent Programming Support (CPS), pfm_$inhibit() also disables time-sliced task switching. It does not prevent task switching due to voluntary task yielding, either explicitly via task_$yield() or implicitly via other functions that yield. Do not use pfm_$inhibit() for critical region concurrency control; use the mutex_ facility instead.

See the reference description of pfm_$init() for a list of the C signals that the PFM package intercepts.

NOTE

This call has no effect on the processing of synchronous faults such as floating-point and overflow exceptions, access violations, and so on.

Museum

Related Articles