Visit Our UNIX and Linux User Community

One-time execution(3)						   globus common					     One-time execution(3)

NAME
One-time execution - Data Structures union globus_thread_once_t Thread once structure. Macros #define GLOBUS_THREAD_ONCE_INIT { .none = 0 } Functions int globus_thread_once (globus_thread_once_t *once, void(*init_routine)(void)) Detailed Description The globus_thread_once_t provides a way for applications and libraries to execute some code exactly one time, independent of the number of threads which attempt to execute it. To use this, statically initialize a globus_thread_once_t control with the value GLOBUS_THREAD_ONCE_INIT, and pass a pointer to a function to execute once, along with the control, to globus_thread_once(). Macro Definition Documentation #define GLOBUS_THREAD_ONCE_INIT { .none = 0 } Thread once initializer value. Function Documentation int globus_thread_once (globus_thread_once_t *once, void(*)(void)init_routine) Execute a function one time. .PP The globus_thread_once() function will execute the function pointed to by its @a init_routine parameter one time for each unique globus_thread_once_t object passed to it, independent of the number of threads calling it. The @a once value must be a static value initialized to GLOBUS_THREAD_ONCE_INIT. Parameters: once A pointer to the value used to govern whether the function passed via the init_routine parameter has executed. init_routine Function to execute one time. It is called with no parameters. Returns: On success, globus_thread_once() guarantees that the function pointed to by init_routine has run, and that subsequent calls to globus_thread_once() with the same value of once will not execute that function, and returns GLOBUS_SUCCESS. If an error occurs, globus_thread_once() returns an implementation-specific non-zero error value. Author Generated automatically by Doxygen for globus common from the source code. Version 14.7 Tue Nov 27 2012 One-time execution(3)

Featured Tech Videos