flux_watcher_start(3)¶
SYNOPSIS¶
void flux_watcher_start (flux_watcher_t *w);
void flux_watcher_stop (flux_watcher_t *w);
void flux_watcher_destroy (flux_watcher_t *w);
double flux_watcher_next_wakeup (flux_watcher_t *w);
DESCRIPTION¶
flux_watcher_start() activates a flux_watcher_t object w so that it
can receive events. If w is already active, the call has no effect.
This may be called from within a flux_watcher_f callback.
flux_watcher_stop() deactivates a flux_watcher_t object w so that it
stops receiving events. If w is already inactive, the call has no effect.
This may be called from within a flux_watcher_f callback.
flux_watcher_destroy() destroys a flux_watcher_t object w,
after stopping it. It is not safe to destroy a watcher object within a
flux_watcher_f callback.
flux_watcher_next_wakeup() returns the absolute time that the watcher
is supposed to trigger next. This function only works for timer and
periodic watchers, and will return a value less than zero with errno
set to EINVAL otherwise.