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.

SEE ALSO

flux_reactor_create (3)