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.

       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.10                                    Fri Nov 22 2013                           One-time execution(3)