screen_register_event()

Updated: April 19, 2023

Register a sigevent for use with asynchronous notifications

Synopsis:

#include <screen/screen.h>
int screen_register_event(screen_context_t ctx,
                          struct sigevent *event)

Arguments:

ctx
The context which is registering the sigevent and will later be used for screen_notify().
event
The sigevent which needs to be registered.

Library:

libscreen

Description:

Function Type: Immediate Execution

This function registers a sigevent with Screen so that screen_notify() can be used with the event; it's associated with the preprocessor definition screen_register_event.

Returns:

0 if successful, or -1 if an error occurred (errno is set; refer to errno.h for more details).