procmgr_event_trigger()

Trigger a system-wide event

Synopsis:

#include <sys/procmgr.h>

int procmgr_event_trigger( unsigned flags );

Arguments:

flags

A bitwise OR of the types of event that you want to trigger:

PROCMGR_EVENT_CONFSTR (privileged)
PROCMGR_EVENT_DAEMON_DEATH (privileged)
PROCMGR_EVENT_PATHSPACE
PROCMGR_EVENT_SYNC
PROCMGR_EVENT_SYSCONF (privileged)
PROCMGR_EVENT_TOD

For descriptions of the events, see "Event types" in the entry for procmgr_event_notify_add().

Note: In order to trigger a privileged event, your process must have the PROCMGR_AID_EVENT ability enabled. For more information, see procmgr_ability().

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The function procmgr_event_trigger() triggers a system-wide event. The event is sent to all processes that requested (via procmgr_event_notify_add() or procmgr_event_notify()) to be notified of the event identified by flags.

Returns:

-1 on error; any other value indicates success.

Examples:

#include <sys/procmgr.h>

int main ( void )
{   
   procmgr_event_trigger( PROCMGR_EVENT_SYNC );
}

Classification:

QNX Neutrino

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes