Developer's Daily Unix by Example
  main | java | perl | unix | dev directory | web log
 
 
Main
Unix
Man Pages
   

PTHREAD_ONCE

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
AUTHOR

NAME

pthread_once ? once-only initialization

SYNOPSIS

#include <pthread.h>

pthread_once_t once_control = PTHREAD_ONCE_INIT;

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

DESCRIPTION

The purpose of pthread_once is to ensure that a piece of initialization code is executed at most once. The once_control argument points to a static or extern variable statically initialized to PTHREAD_ONCE_INIT.

The first time pthread_once is called with a given once_control argument, it calls init_routine with no argument and changes the value of the once_control variable to record that initialization has been performed. Subsequent calls to pthread_once with the same once_control argument do nothing.

RETURN VALUE

pthread_once always returns 0.

ERRORS

None.

AUTHOR

Xavier Leroy <Xavier.Leroy@inria.fr>


copyright 1998-2007, devdaily.com, all rights reserved.
devdaily.com, an alvin j. alexander production.