17#ifndef GLOBUS_CALLBACK_H
18#define GLOBUS_CALLBACK_H
40globus_module_descriptor_t globus_i_callback_module;
54#define GLOBUS_CALLBACK_MODULE (&globus_i_callback_module)
65#define GLOBUS_POLL_MODULE GLOBUS_CALLBACK_MODULE
146#define globus_callback_poll(a) \
147 globus_callback_space_poll((a), GLOBUS_CALLBACK_GLOBAL_SPACE)
160#define globus_poll_blocking() \
161 globus_callback_poll(&globus_i_abstime_infinity)
174#define globus_poll_nonblocking() \
175 globus_callback_poll(&globus_i_abstime_zero)
188#define globus_poll() \
189 globus_poll_nonblocking()
201#define globus_signal_poll() \
202 globus_callback_signal_poll()
215#define globus_callback_register_oneshot( \
220 globus_callback_space_register_oneshot( \
224 (callback_user_arg), \
225 GLOBUS_CALLBACK_GLOBAL_SPACE)
238#define globus_callback_register_periodic( \
244 globus_callback_space_register_periodic( \
249 (callback_user_arg), \
250 GLOBUS_CALLBACK_GLOBAL_SPACE)
264#define globus_callback_register_signal_handler( \
269 globus_callback_space_register_signal_handler( \
273 (callback_user_arg), \
274 GLOBUS_CALLBACK_GLOBAL_SPACE)
357 const globus_reltime_t * delay_time,
359 void * callback_user_arg,
409 const globus_reltime_t * delay_time,
410 const globus_reltime_t * period,
412 void * callback_user_arg,
496 const globus_reltime_t * new_delay);
533 const globus_reltime_t * new_period);
581 const globus_abstime_t * timestop,
631 globus_reltime_t * time_left);
688#define GLOBUS_CALLBACK_GLOBAL_SPACE -2
958#define GLOBUS_SIGNAL_INTERRUPT SIGINT
960#define GLOBUS_SIGNAL_INTERRUPT 0
1003 void * callback_user_arg,
1065 void (*wakeup)(
void *),
Reference Counting Module Activation and Deactivation.
void(* globus_callback_func_t)(void *user_arg)
Globus callback prototype.
Definition globus_callback.h:311
globus_result_t globus_callback_space_register_oneshot(globus_callback_handle_t *callback_handle, const globus_reltime_t *delay_time, globus_callback_func_t callback_func, void *callback_user_arg, globus_callback_space_t space)
Register a oneshot some delay from now.
globus_result_t globus_callback_space_register_periodic(globus_callback_handle_t *callback_handle, const globus_reltime_t *delay_time, const globus_reltime_t *period, globus_callback_func_t callback_func, void *callback_user_arg, globus_callback_space_t space)
Register a periodic callback.
void globus_callback_space_poll(const globus_abstime_t *timestop, globus_callback_space_t space)
Poll for ready callbacks.
globus_result_t globus_callback_adjust_oneshot(globus_callback_handle_t callback_handle, const globus_reltime_t *new_delay)
Adjust the delay of a oneshot callback.
void globus_callback_signal_poll()
Signal the poll.
globus_result_t globus_callback_unregister(globus_callback_handle_t callback_handle, globus_callback_func_t unregister_callback, void *unreg_arg, globus_bool_t *active)
Unregister a callback.
globus_result_t globus_callback_adjust_period(globus_callback_handle_t callback_handle, const globus_reltime_t *new_period)
Adjust the period of a periodic callback.
globus_bool_t globus_callback_has_time_expired()
See if there is remaining time in a callback.
void globus_callback_add_wakeup_handler(void(*wakeup)(void *), void *user_arg)
Register a wakeup handler with callback library.
globus_result_t globus_callback_unregister_signal_handler(int signum, globus_callback_func_t unregister_callback, void *unreg_arg)
Unregister a signal handling callback.
globus_result_t globus_callback_space_attr_get_behavior(globus_callback_space_attr_t attr, globus_callback_space_behavior_t *behavior)
Get the behavior associated with an attr.
globus_result_t globus_callback_space_destroy(globus_callback_space_t space)
Destroy a reference to a user space.
int globus_callback_space_get_depth(globus_callback_space_t space)
Retrieve the current nesting level of a space.
globus_result_t globus_callback_space_get(globus_callback_space_t *space)
Retrieve the space of a currently running callback.
globus_result_t globus_callback_space_init(globus_callback_space_t *space, globus_callback_space_attr_t attr)
Initialize a user space.
globus_result_t globus_callback_space_register_signal_handler(int signum, globus_bool_t persist, globus_callback_func_t callback_func, void *callback_user_arg, globus_callback_space_t space)
Fire a callback when the specified signal is received.
globus_result_t globus_callback_space_attr_destroy(globus_callback_space_attr_t attr)
Destroy a space attr.
globus_result_t globus_callback_space_attr_set_behavior(globus_callback_space_attr_t attr, globus_callback_space_behavior_t behavior)
Set the behavior of a space.
globus_result_t globus_callback_space_reference(globus_callback_space_t space)
Take a reference to a space.
globus_callback_space_behavior_t
Callback space behaviors describe how a space behaves.
Definition globus_callback.h:721
globus_result_t globus_callback_space_attr_init(globus_callback_space_attr_t *attr)
Initialize a space attr.
globus_bool_t globus_callback_was_restarted()
See if a callback has been restarted.
globus_bool_t globus_callback_get_timeout(globus_reltime_t *time_left)
Get the amount of time left in a callback.
globus_bool_t globus_callback_space_is_single(globus_callback_space_t space)
See if the specified space is a single threaded behavior space.
@ GLOBUS_CALLBACK_SPACE_BEHAVIOR_SINGLE
Definition globus_callback.h:725
@ GLOBUS_CALLBACK_SPACE_BEHAVIOR_SERIALIZED
Definition globus_callback.h:729
@ GLOBUS_CALLBACK_SPACE_BEHAVIOR_THREADED
Definition globus_callback.h:731
int globus_callback_space_t
Callback space handle.
Definition globus_callback.h:112
int globus_callback_handle_t
Periodic callback handle.
Definition globus_callback.h:102
globus_callback_error_type_t
Error types.
Definition globus_callback.h:79
struct globus_l_callback_space_attr_s * globus_callback_space_attr_t
Callback space attribute.
Definition globus_callback.h:121
@ GLOBUS_CALLBACK_ERROR_INVALID_CALLBACK_HANDLE
Definition globus_callback.h:81
@ GLOBUS_CALLBACK_ERROR_MEMORY_ALLOC
Definition globus_callback.h:85
@ GLOBUS_CALLBACK_ERROR_NO_ACTIVE_CALLBACK
Definition globus_callback.h:91
@ GLOBUS_CALLBACK_ERROR_ALREADY_CANCELED
Definition globus_callback.h:89
@ GLOBUS_CALLBACK_ERROR_INVALID_ARGUMENT
Definition globus_callback.h:87
@ GLOBUS_CALLBACK_ERROR_INVALID_SPACE
Definition globus_callback.h:83
uint32_t globus_result_t
Definition globus_types.h:99
int globus_bool_t
Boolean type.
Definition globus_types.h:93