globus_thread_once(3) [debian man page]

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)

Check Out this Related Man Page

pthread_once(3C)														  pthread_once(3C)

NAME

       pthread_once - initialize dynamic package

SYNOPSIS

       cc -mt [ flag... ] file... -lpthread [ library... ]

       #include <pthread.h>
       pthread_once_t once_control = PTHREAD_ONCE_INIT;

       int pthread_once(pthread_once_t *once_control, void (*init_routine)(void));

       If any thread in a process with a once_control parameter makes a call to pthread_once(), the first call will summon the init_routine(), but
       subsequent calls will not. The once_control parameter determines whether  the  associated  initialization  routine  has	been  called.  The
       init_routine() is complete upon return of pthread_once().

       pthread_once()  is not a cancellation point; however, if the function init_routine() is a cancellation point and is canceled, the effect on
       once_control is the same as if pthread_once() had never been called.

       The constant PTHREAD_ONCE_INIT is defined in the <pthread.h> header.

       If once_control has automatic storage duration or is not initialized by PTHREAD_ONCE_INIT, the behavior of pthread_once() is undefined.

       Upon successful completion, pthread_once() returns 0. Otherwise, an error number is returned to indicate the error.

       EINVAL	       once_control or	init_routine is NULL.

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

       attributes(5), standards(5)

       Solaris threads do not offer this functionality.

								    23 Mar 2005 						  pthread_once(3C)

Linux and UNIX Man Pages

globus_thread_once(3) [debian man page]

Check Out this Related Man Page