__le_cib_get() — Get condition information block

Standards

Standards / Extensions	C or C++	Dependencies
Language Environment	both	AMODE 64

Format

#include <__le_api.h>

struct cib  *__le_cib_get(void);

General description

Returns the Condition Information Block (CIB) structure associated with the current signal.

Notes:

This function is valid when called while a Language Environment® exception handler is running.
This function is valid when called while a POSIX(OFF) signal catcher is running.
This function is valid when called while a POSIX(ON) signal catcher is running, if the signal is generated and caught immediately to the same thread. __le_cib_get() will fail if called from POSIX(ON) signal catchers that are driven as a result of signals generated by another thread or process. It may also fail when called from a catcher, if the caught signal is from the same thread but was delayed by blocking or by other signals being delivered at the same time.

Returned value

If there is an active condition the returned value is a pointer to the currently active CIB. If there is more than one active condition, the returned CIB will be for the most recent (most deeply nested) condition.

NULL is returned there is no active CIB, and the errno will be set to EMVSERR.

Error Code: Description
EMVSERR: No active CIB is available.