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() .
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:
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | Yes |
Thread | Yes |