table of contents
other versions
- wheezy 14.7-2
- wheezy-backports 15.26-3~bpo70+1
- jessie 15.26-3
- testing 16.9-1
- unstable 17.1-1
One-time execution(3) | globus common | One-time execution(3) |
NAME¶
One-time execution -Data Structures¶
union globus_thread_once_t
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. .PPThe 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.Tue Nov 27 2012 | Version 14.7 |