* This header provides a portable threads implementation.
*****************************************************************************
* Copyright (C) 1999, 2000 VideoLAN
- * $Id: threads.h,v 1.18 2001/06/14 01:49:44 sam Exp $
+ * $Id: threads.h,v 1.37 2002/03/01 00:33:18 massiot Exp $
*
* Authors: Jean-Marc Dressler <polux@via.ecp.fr>
* Samuel Hocevar <sam@via.ecp.fr>
#include <stdio.h>
+#if defined(GPROF) || defined(DEBUG)
+# include <sys/time.h>
+#endif
+
#if defined( PTH_INIT_IN_PTH_H ) /* GNU Pth */
# include <pth.h>
+#elif defined( ST_INIT_IN_ST_H ) /* State threads */
+# include <st.h>
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H ) /* pthreads (like Linux & BSD) */
# include <pthread.h>
+# ifdef DEBUG
+/* Needed for pthread_cond_timedwait */
+# include <errno.h>
+# endif
+/* This is not prototyped under Linux, though it exists. */
+int pthread_mutexattr_setkind_np( pthread_mutexattr_t *attr, int kind );
#elif defined( HAVE_CTHREADS_H ) /* GNUMach */
# include <cthreads.h>
#elif defined( HAVE_KERNEL_SCHEDULER_H ) /* BeOS */
-# undef MAX
-# undef MIN
# include <kernel/OS.h>
# include <kernel/scheduler.h>
# include <byteorder.h>
-#elif defined( WIN32 ) /* Win32 with MinGW32 compiler */
+#elif defined( WIN32 )
+#define WIN32_LEAN_AND_MEAN
# include <windows.h>
# include <process.h>
typedef pth_mutex_t vlc_mutex_t;
typedef pth_cond_t vlc_cond_t;
+#elif defined( ST_INIT_IN_ST_H )
+typedef st_thread_t * vlc_thread_t;
+typedef st_mutex_t * vlc_mutex_t;
+typedef st_cond_t * vlc_cond_t;
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
typedef pthread_t vlc_thread_t;
typedef pthread_mutex_t vlc_mutex_t;
} vlc_cond_t;
#elif defined( WIN32 )
-typedef HANDLE vlc_thread_t;
-typedef HANDLE vlc_mutex_t;
-typedef HANDLE vlc_cond_t;
+typedef HANDLE vlc_thread_t;
+typedef CRITICAL_SECTION vlc_mutex_t;
+
+typedef struct
+{
+ int i_waiting_threads;
+ HANDLE signal;
+} vlc_cond_t;
+
typedef unsigned (__stdcall *PTHREAD_START) (void *);
#endif
* Prototypes
*****************************************************************************/
-static __inline__ int vlc_thread_create ( vlc_thread_t *, char *,
- vlc_thread_func_t, void * );
-static __inline__ void vlc_thread_exit ( void );
-static __inline__ void vlc_thread_join ( vlc_thread_t );
+#ifdef GPROF
+/* Wrapper function for profiling */
+static void * vlc_thread_wrapper ( void *p_wrapper );
-static __inline__ int vlc_mutex_init ( vlc_mutex_t * );
-static __inline__ int vlc_mutex_lock ( vlc_mutex_t * );
-static __inline__ int vlc_mutex_unlock ( vlc_mutex_t * );
-static __inline__ int vlc_mutex_destroy ( vlc_mutex_t * );
+# ifdef WIN32
-static __inline__ int vlc_cond_init ( vlc_cond_t * );
-static __inline__ int vlc_cond_signal ( vlc_cond_t * );
-static __inline__ int vlc_cond_wait ( vlc_cond_t *, vlc_mutex_t * );
-static __inline__ int vlc_cond_destroy ( vlc_cond_t * );
+# define ITIMER_REAL 1
+# define ITIMER_PROF 2
-#if 0
-static __inline__ int vlc_cond_timedwait( vlc_cond_t *, vlc_mutex_t *,
- mtime_t );
-#endif
-
-/*****************************************************************************
- * vlc_thread_create: create a thread
- *****************************************************************************/
-static __inline__ int vlc_thread_create( vlc_thread_t *p_thread,
- char *psz_name, vlc_thread_func_t func,
- void *p_data )
+struct itimerval
{
-#if defined( PTH_INIT_IN_PTH_H )
- *p_thread = pth_spawn( PTH_ATTR_DEFAULT, func, p_data );
- return ( p_thread == NULL );
+ struct timeval it_value;
+ struct timeval it_interval;
+};
-#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
- return pthread_create( p_thread, NULL, func, p_data );
+int setitimer(int kind, const struct itimerval* itnew, struct itimerval* itold);
-#elif defined( HAVE_CTHREADS_H )
- *p_thread = cthread_fork( (cthread_fn_t)func, (any_t)p_data );
- return 0;
+# endif /* WIN32 */
-#elif defined( HAVE_KERNEL_SCHEDULER_H )
- *p_thread = spawn_thread( (thread_func)func, psz_name,
- B_NORMAL_PRIORITY, p_data );
- return resume_thread( *p_thread );
+typedef struct wrapper_s
+{
+ /* Data lock access */
+ vlc_mutex_t lock;
+ vlc_cond_t wait;
-#elif defined( WIN32 )
-#if 0
- DWORD threadID;
- /* This method is not recommended when using the MSVCRT C library,
- * so we'll have to use _beginthreadex instead */
- *p_thread = CreateThread(0, 0, (LPTHREAD_START_ROUTINE) func,
- p_data, 0, &threadID);
-#endif
- unsigned threadID;
- /* When using the MSVCRT C library you have to use the _beginthreadex
- * function instead of CreateThread, otherwise you'll end up with memory
- * leaks and the signal function not working */
- *p_thread = (HANDLE)_beginthreadex(NULL, 0, (PTHREAD_START) func,
- p_data, 0, &threadID);
-
- return( *p_thread ? 0 : 1 );
+ /* Data used to spawn the real thread */
+ vlc_thread_func_t func;
+ void *p_data;
-#endif
-}
+ /* Profiling timer passed to the thread */
+ struct itimerval itimer;
+
+} wrapper_t;
+
+#endif /* GPROF */
/*****************************************************************************
- * vlc_thread_exit: terminate a thread
+ * vlc_threads_init: initialize threads system
*****************************************************************************/
-static __inline__ void vlc_thread_exit( void )
+static __inline__ int vlc_threads_init( void )
{
#if defined( PTH_INIT_IN_PTH_H )
- pth_exit( 0 );
+ return pth_init();
+
+#elif defined( ST_INIT_IN_ST_H )
+ return st_init();
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
- pthread_exit( 0 );
+ return 0;
#elif defined( HAVE_CTHREADS_H )
- int result;
- cthread_exit( &result );
+ return 0;
#elif defined( HAVE_KERNEL_SCHEDULER_H )
- exit_thread( 0 );
+ return 0;
#elif defined( WIN32 )
-#if 0
- ExitThread( 0 );
-#endif
- /* For now we don't close the thread handles (because of race conditions).
- * Need to be looked at. */
- _endthreadex(0);
+ return 0;
#endif
}
/*****************************************************************************
- * vlc_thread_join: wait until a thread exits
+ * vlc_threads_end: stop threads system
*****************************************************************************/
-static __inline__ void vlc_thread_join( vlc_thread_t thread )
+static __inline__ int vlc_threads_end( void )
{
#if defined( PTH_INIT_IN_PTH_H )
- pth_join( thread, NULL );
+ return pth_kill();
+
+#elif defined( ST_INIT_IN_ST_H )
+ return 0;
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
- pthread_join( thread, NULL );
+ return 0;
#elif defined( HAVE_CTHREADS_H )
- cthread_join( thread );
+ return 0;
#elif defined( HAVE_KERNEL_SCHEDULER_H )
- int32 exit_value;
- wait_for_thread( thread, &exit_value );
+ return 0;
#elif defined( WIN32 )
- WaitForSingleObject( thread, INFINITE);
+ return 0;
#endif
}
#if defined( PTH_INIT_IN_PTH_H )
return pth_mutex_init( p_mutex );
+#elif defined( ST_INIT_IN_ST_H )
+ *p_mutex = st_mutex_new();
+ return ( *p_mutex == NULL ) ? errno : 0;
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
+# if defined(DEBUG) && defined(SYS_LINUX)
+ /* Create error-checking mutex to detect threads problems more easily. */
+ pthread_mutexattr_t attr;
+ int i_result;
+
+ pthread_mutexattr_init( &attr );
+ pthread_mutexattr_setkind_np( &attr, PTHREAD_MUTEX_ERRORCHECK_NP );
+ i_result = pthread_mutex_init( p_mutex, &attr );
+ pthread_mutexattr_destroy( &attr );
+ return( i_result );
+# endif
+
return pthread_mutex_init( p_mutex, NULL );
#elif defined( HAVE_CTHREADS_H )
return B_OK;
#elif defined( WIN32 )
- *p_mutex = CreateMutex(0,FALSE,0);
- return (*p_mutex?0:1);
+ InitializeCriticalSection( p_mutex );
+ return 0;
#endif
}
/*****************************************************************************
* vlc_mutex_lock: lock a mutex
*****************************************************************************/
-static __inline__ int vlc_mutex_lock( vlc_mutex_t *p_mutex )
+#ifdef DEBUG
+# define vlc_mutex_lock( P_MUTEX ) \
+ _vlc_mutex_lock( __FILE__, __LINE__, P_MUTEX )
+#else
+# define vlc_mutex_lock( P_MUTEX ) \
+ _vlc_mutex_lock( NULL, 0, P_MUTEX )
+#endif
+
+static __inline__ int _vlc_mutex_lock( char * psz_file, int i_line,
+ vlc_mutex_t *p_mutex )
{
#if defined( PTH_INIT_IN_PTH_H )
return pth_mutex_acquire( p_mutex, TRUE, NULL );
+#elif defined( ST_INIT_IN_ST_H )
+ return st_mutex_lock( *p_mutex );
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
- return pthread_mutex_lock( p_mutex );
+ int i_return = pthread_mutex_lock( p_mutex );
+ if( i_return )
+ {
+ intf_ErrMsg( "thread %d error: mutex_lock failed at %s:%d (%s)",
+ pthread_self(), psz_file, i_line, strerror(i_return) );
+ }
+ return i_return;
#elif defined( HAVE_CTHREADS_H )
mutex_lock( p_mutex );
return err;
#elif defined( WIN32 )
- WaitForSingleObject( *p_mutex, INFINITE );
+ EnterCriticalSection( p_mutex );
return 0;
#endif
/*****************************************************************************
* vlc_mutex_unlock: unlock a mutex
*****************************************************************************/
-static __inline__ int vlc_mutex_unlock( vlc_mutex_t *p_mutex )
+#ifdef DEBUG
+# define vlc_mutex_unlock( P_MUTEX ) \
+ _vlc_mutex_unlock( __FILE__, __LINE__, P_MUTEX )
+#else
+# define vlc_mutex_unlock( P_MUTEX ) \
+ _vlc_mutex_unlock( NULL, 0, P_MUTEX )
+#endif
+
+static __inline__ int _vlc_mutex_unlock( char * psz_file, int i_line,
+ vlc_mutex_t *p_mutex )
{
#if defined( PTH_INIT_IN_PTH_H )
return pth_mutex_release( p_mutex );
+#elif defined( ST_INIT_IN_ST_H )
+ return st_mutex_unlock( *p_mutex );
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
- return pthread_mutex_unlock( p_mutex );
+ int i_return = pthread_mutex_unlock( p_mutex );
+ if( i_return )
+ {
+ intf_ErrMsg( "thread %d error: mutex_unlock failed at %s:%d (%s)",
+ pthread_self(), psz_file, i_line, strerror(i_return) );
+ }
+ return i_return;
#elif defined( HAVE_CTHREADS_H )
mutex_unlock( p_mutex );
return B_OK;
#elif defined( WIN32 )
- ReleaseMutex( *p_mutex );
+ LeaveCriticalSection( p_mutex );
return 0;
#endif
/*****************************************************************************
* vlc_mutex_destroy: destroy a mutex
*****************************************************************************/
-static __inline__ int vlc_mutex_destroy( vlc_mutex_t *p_mutex )
+#ifdef DEBUG
+# define vlc_mutex_destroy( P_MUTEX ) \
+ _vlc_mutex_destroy( __FILE__, __LINE__, P_MUTEX )
+#else
+# define vlc_mutex_destroy( P_MUTEX ) \
+ _vlc_mutex_destroy( NULL, 0, P_MUTEX )
+#endif
+
+static __inline__ int _vlc_mutex_destroy( char * psz_file, int i_line,
+ vlc_mutex_t *p_mutex )
{
#if defined( PTH_INIT_IN_PTH_H )
return 0;
+#elif defined( ST_INIT_IN_ST_H )
+ return st_mutex_destroy( *p_mutex );
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
- return pthread_mutex_destroy( p_mutex );
+ int i_return = pthread_mutex_destroy( p_mutex );
+ if( i_return )
+ {
+ intf_ErrMsg( "thread %d error: mutex_destroy failed at %s:%d (%s)",
+ pthread_self(), psz_file, i_line, strerror(i_return) );
+ }
+ return i_return;
+
+#elif defined( HAVE_CTHREADS_H )
+ return 0;
#elif defined( HAVE_KERNEL_SCHEDULER_H )
if( p_mutex->init == 9999 )
return B_OK;
#elif defined( WIN32 )
- CloseHandle(*p_mutex);
+ DeleteCriticalSection( p_mutex );
return 0;
#endif
#if defined( PTH_INIT_IN_PTH_H )
return pth_cond_init( p_condvar );
+#elif defined( ST_INIT_IN_ST_H )
+ *p_condvar = st_cond_new();
+ return ( *p_condvar == NULL ) ? errno : 0;
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
return pthread_cond_init( p_condvar, NULL );
return 0;
#elif defined( WIN32 )
+ /* initialise counter */
+ p_condvar->i_waiting_threads = 0;
+
/* Create an auto-reset event. */
- *p_condvar = CreateEvent( NULL, /* no security */
- FALSE, /* auto-reset event */
- FALSE, /* non-signaled initially */
- NULL ); /* unnamed */
+ p_condvar->signal = CreateEvent( NULL, /* no security */
+ FALSE, /* auto-reset event */
+ FALSE, /* non-signaled initially */
+ NULL ); /* unnamed */
- return( *p_condvar ? 0 : 1 );
+ return( !p_condvar->signal );
#endif
}
#if defined( PTH_INIT_IN_PTH_H )
return pth_cond_notify( p_condvar, FALSE );
+#elif defined( ST_INIT_IN_ST_H )
+ return st_cond_signal( *p_condvar );
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
return pthread_cond_signal( p_condvar );
return 0;
#elif defined( WIN32 )
- /* Try to release one waiting thread. */
- PulseEvent ( *p_condvar );
+ /* Release one waiting thread if one is available. */
+ /* For this trick to work properly, the vlc_cond_signal must be surrounded
+ * by a mutex. This will prevent another thread from stealing the signal */
+ int i_waiting_threads = p_condvar->i_waiting_threads;
+ while( p_condvar->i_waiting_threads
+ && p_condvar->i_waiting_threads == i_waiting_threads )
+ {
+ PulseEvent( p_condvar->signal );
+ Sleep( 0 ); /* deschedule the current thread */
+ }
+ return 0;
+
+#endif
+}
+
+/*****************************************************************************
+ * vlc_cond_broadcast: start all threads waiting on condition completion
+ *****************************************************************************/
+/*
+ * FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME
+ * Only works with pthreads, you need to adapt it for others
+ * FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME
+ */
+static __inline__ int vlc_cond_broadcast( vlc_cond_t *p_condvar )
+{
+#if defined( PTH_INIT_IN_PTH_H )
+ return pth_cond_notify( p_condvar, FALSE );
+
+#elif defined( ST_INIT_IN_ST_H )
+ return st_cond_broadcast( p_condvar );
+
+#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
+ return pthread_cond_broadcast( p_condvar );
+
+#elif defined( HAVE_CTHREADS_H )
+ /* condition_signal() */
+ if ( p_condvar->queue.head || p_condvar->implications )
+ {
+ cond_signal( (condition_t)p_condvar );
+ }
+ return 0;
+
+#elif defined( HAVE_KERNEL_SCHEDULER_H )
+ if( !p_condvar )
+ {
+ return B_BAD_VALUE;
+ }
+
+ if( p_condvar->init < 2000 )
+ {
+ return B_NO_INIT;
+ }
+
+ while( p_condvar->thread != -1 )
+ {
+ thread_info info;
+ if( get_thread_info(p_condvar->thread, &info) == B_BAD_VALUE )
+ {
+ return 0;
+ }
+
+ if( info.state != B_THREAD_SUSPENDED )
+ {
+ /* The waiting thread is not suspended so it could
+ * have been interrupted beetwen the unlock and the
+ * suspend_thread line. That is why we sleep a little
+ * before retesting p_condver->thread. */
+ snooze( 10000 );
+ }
+ else
+ {
+ /* Ok, we have to wake up that thread */
+ resume_thread( p_condvar->thread );
+ return 0;
+ }
+ }
+ return 0;
+
+#elif defined( WIN32 )
+ /* Release all waiting threads. */
+ /* For this trick to work properly, the vlc_cond_signal must be surrounded
+ * by a mutex. This will prevent another thread from stealing the signal */
+ while( p_condvar->i_waiting_threads )
+ {
+ PulseEvent( p_condvar->signal );
+ Sleep( 0 ); /* deschedule the current thread */
+ }
return 0;
#endif
/*****************************************************************************
* vlc_cond_wait: wait until condition completion
*****************************************************************************/
-static __inline__ int vlc_cond_wait( vlc_cond_t *p_condvar, vlc_mutex_t *p_mutex )
+#ifdef DEBUG
+# define vlc_cond_wait( P_COND, P_MUTEX ) \
+ _vlc_cond_wait( __FILE__, __LINE__, P_COND, P_MUTEX )
+#else
+# define vlc_cond_wait( P_COND, P_MUTEX ) \
+ _vlc_cond_wait( NULL, 0, P_COND, P_MUTEX )
+#endif
+
+static __inline__ int _vlc_cond_wait( char * psz_file, int i_line,
+ vlc_cond_t *p_condvar,
+ vlc_mutex_t *p_mutex )
{
#if defined( PTH_INIT_IN_PTH_H )
return pth_cond_await( p_condvar, p_mutex, NULL );
+#elif defined( ST_INIT_IN_ST_H )
+ int i_ret;
+
+ st_mutex_unlock( *p_mutex );
+ i_ret = st_cond_wait( *p_condvar );
+ st_mutex_lock( *p_mutex );
+
+ return i_ret;
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
+
+#ifndef DEBUG
return pthread_cond_wait( p_condvar, p_mutex );
+#else
+ /* In debug mode, timeout */
+ struct timeval now;
+ struct timespec timeout;
+ int i_result;
+
+ for( ; ; )
+ {
+ gettimeofday( &now, NULL );
+ timeout.tv_sec = now.tv_sec + THREAD_COND_TIMEOUT;
+ timeout.tv_nsec = now.tv_usec * 1000;
+
+ i_result = pthread_cond_timedwait( p_condvar, p_mutex, &timeout );
+
+ if( i_result == ETIMEDOUT )
+ {
+ intf_WarnMsg( 1, "thread %d warning: Possible deadlock detected in cond_wait at %s:%d (%s)",
+ pthread_self(), psz_file, i_line, strerror(i_result) );
+ continue;
+ }
+
+ if( i_result )
+ {
+ intf_ErrMsg( "thread %d error: cond_wait failed at %s:%d (%s)",
+ pthread_self(), psz_file, i_line, strerror(i_result) );
+ }
+ return( i_result );
+ }
+#endif
#elif defined( HAVE_CTHREADS_H )
condition_wait( (condition_t)p_condvar, (mutex_t)p_mutex );
return 0;
#elif defined( WIN32 )
- /* Release the <external_mutex> here and wait for the event
- * to become signaled, due to <pthread_cond_signal> being
- * called. */
+ /* The ideal would be to use a function which atomically releases the
+ * mutex and initiate the waiting.
+ * Unfortunately only the SignalObjectAndWait function does this and it's
+ * only supported on WinNT/2K, furthermore it cannot take multiple
+ * events as parameters.
+ *
+ * The solution we use should however fulfill all our needs (even though
+ * it is not a correct pthreads implementation)
+ */
+ int i_result;
+
+ p_condvar->i_waiting_threads ++;
+
+ /* Release the mutex */
vlc_mutex_unlock( p_mutex );
- WaitForSingleObject( *p_condvar, INFINITE );
+ i_result = WaitForSingleObject( p_condvar->signal, INFINITE);
+
+ /* maybe we should protect this with a mutex ? */
+ p_condvar->i_waiting_threads --;
/* Reacquire the mutex before returning. */
vlc_mutex_lock( p_mutex );
- return 0;
+
+ return( i_result == WAIT_FAILED );
#endif
}
/*****************************************************************************
* vlc_cond_destroy: destroy a condition
*****************************************************************************/
-static __inline__ int vlc_cond_destroy( vlc_cond_t *p_condvar )
+#ifdef DEBUG
+# define vlc_cond_destroy( P_COND ) \
+ _vlc_cond_destroy( __FILE__, __LINE__, P_COND )
+#else
+# define vlc_cond_destroy( P_COND ) \
+ _vlc_cond_destroy( NULL, 0, P_COND )
+#endif
+
+static __inline__ int _vlc_cond_destroy( char * psz_file, int i_line,
+ vlc_cond_t *p_condvar )
{
#if defined( PTH_INIT_IN_PTH_H )
return 0;
+#elif defined( ST_INIT_IN_ST_H )
+ return st_cond_destroy( *p_condvar );
+
#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
- return pthread_cond_destroy( p_condvar );
+ int i_result = pthread_cond_destroy( p_condvar );
+ if( i_result )
+ {
+ intf_ErrMsg( "thread %d error: cond_destroy failed at %s:%d (%s)",
+ pthread_self(), psz_file, i_line, strerror(i_result) );
+ }
+ return i_result;
+
+#elif defined( HAVE_CTHREADS_H )
+ return 0;
#elif defined( HAVE_KERNEL_SCHEDULER_H )
p_condvar->init = 0;
return 0;
#elif defined( WIN32 )
- CloseHandle( *p_condvar );
- return 0;
+ return( !CloseHandle( p_condvar->signal ) );
#endif
}
+/*****************************************************************************
+ * vlc_thread_create: create a thread
+ *****************************************************************************/
+#ifdef DEBUG
+# define vlc_thread_create( P_THREAD, PSZ_NAME, FUNC, P_DATA ) \
+ _vlc_thread_create( __FILE__, __LINE__, P_THREAD, PSZ_NAME, FUNC, P_DATA )
+#else
+# define vlc_thread_create( P_THREAD, PSZ_NAME, FUNC, P_DATA ) \
+ _vlc_thread_create( NULL, 0, P_THREAD, PSZ_NAME, FUNC, P_DATA )
+#endif
+
+static __inline__ int _vlc_thread_create( char * psz_file, int i_line,
+ vlc_thread_t *p_thread,
+ char *psz_name,
+ vlc_thread_func_t func,
+ void *p_data )
+{
+ int i_ret;
+
+#ifdef GPROF
+ wrapper_t wrapper;
+
+ /* Initialize the wrapper structure */
+ wrapper.func = func;
+ wrapper.p_data = p_data;
+ getitimer( ITIMER_PROF, &wrapper.itimer );
+ vlc_mutex_init( &wrapper.lock );
+ vlc_cond_init( &wrapper.wait );
+ vlc_mutex_lock( &wrapper.lock );
+
+ /* Alter user-passed data so that we call the wrapper instead
+ * of the real function */
+ p_data = &wrapper;
+ func = vlc_thread_wrapper;
+#endif
+
+#if defined( PTH_INIT_IN_PTH_H )
+ *p_thread = pth_spawn( PTH_ATTR_DEFAULT, func, p_data );
+ i_ret = ( p_thread == NULL );
+
+#elif defined( ST_INIT_IN_ST_H )
+ *p_thread = st_thread_create( func, p_data, 1, 0 );
+ i_ret = ( p_thread == NULL );
+
+#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
+ i_ret = pthread_create( p_thread, NULL, func, p_data );
+
+#elif defined( HAVE_CTHREADS_H )
+ *p_thread = cthread_fork( (cthread_fn_t)func, (any_t)p_data );
+ i_ret = 0;
+
+#elif defined( HAVE_KERNEL_SCHEDULER_H )
+ *p_thread = spawn_thread( (thread_func)func, psz_name,
+ B_NORMAL_PRIORITY, p_data );
+ i_ret = resume_thread( *p_thread );
+
+#elif defined( WIN32 )
+#if 0
+ DWORD threadID;
+ /* This method is not recommended when using the MSVCRT C library,
+ * so we'll have to use _beginthreadex instead */
+ *p_thread = CreateThread(0, 0, (LPTHREAD_START_ROUTINE) func,
+ p_data, 0, &threadID);
+#endif
+ unsigned threadID;
+ /* When using the MSVCRT C library you have to use the _beginthreadex
+ * function instead of CreateThread, otherwise you'll end up with memory
+ * leaks and the signal function not working */
+ *p_thread = (HANDLE)_beginthreadex(NULL, 0, (PTHREAD_START) func,
+ p_data, 0, &threadID);
+
+ i_ret = ( *p_thread ? 0 : 1 );
+
+#endif
+
+#ifdef GPROF
+ if( i_ret == 0 )
+ {
+ vlc_cond_wait( &wrapper.wait, &wrapper.lock );
+ }
+
+ vlc_mutex_unlock( &wrapper.lock );
+ vlc_mutex_destroy( &wrapper.lock );
+ vlc_cond_destroy( &wrapper.wait );
+#endif
+
+ if( i_ret == 0 )
+ {
+ intf_WarnMsg( 2, "thread info: %d (%s) has been created (%s:%d)",
+ *p_thread, psz_name, psz_file, i_line );
+ }
+ else
+ {
+ intf_ErrMsg( "thread error: %s couldn't be created at %s:%d (%s)",
+ psz_name, psz_file, i_line, strerror(i_ret) );
+ }
+
+ return i_ret;
+}
+
+/*****************************************************************************
+ * vlc_thread_exit: terminate a thread
+ *****************************************************************************/
+static __inline__ void vlc_thread_exit( void )
+{
+#if defined( PTH_INIT_IN_PTH_H )
+ pth_exit( 0 );
+
+#elif defined( ST_INIT_IN_ST_H )
+ int result;
+ st_thread_exit( &result );
+
+#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
+ pthread_exit( 0 );
+
+#elif defined( HAVE_CTHREADS_H )
+ int result;
+ cthread_exit( &result );
+
+#elif defined( HAVE_KERNEL_SCHEDULER_H )
+ exit_thread( 0 );
+
+#elif defined( WIN32 )
+#if 0
+ ExitThread( 0 );
+#endif
+ /* For now we don't close the thread handles (because of race conditions).
+ * Need to be looked at. */
+ _endthreadex(0);
+
+#endif
+}
+
+/*****************************************************************************
+ * vlc_thread_join: wait until a thread exits
+ *****************************************************************************/
+#ifdef DEBUG
+# define vlc_thread_join( THREAD ) \
+ _vlc_thread_join( __FILE__, __LINE__, THREAD )
+#else
+# define vlc_thread_join( THREAD ) \
+ _vlc_thread_join( NULL, 0, THREAD )
+#endif
+
+static __inline__ void _vlc_thread_join( char * psz_file, int i_line,
+ vlc_thread_t thread )
+{
+ int i_ret = 0;
+
+#if defined( PTH_INIT_IN_PTH_H )
+ i_ret = pth_join( thread, NULL );
+
+#elif defined( ST_INIT_IN_ST_H )
+ i_ret = st_thread_join( thread, NULL );
+
+#elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
+ i_ret = pthread_join( thread, NULL );
+
+#elif defined( HAVE_CTHREADS_H )
+ cthread_join( thread );
+ i_ret = 1;
+
+#elif defined( HAVE_KERNEL_SCHEDULER_H )
+ int32 exit_value;
+ wait_for_thread( thread, &exit_value );
+
+#elif defined( WIN32 )
+ WaitForSingleObject( thread, INFINITE );
+
+#endif
+
+ if( i_ret )
+ {
+ intf_ErrMsg( "thread error: thread_join(%d) failed at %s:%d (%s)",
+ thread, psz_file, i_line, strerror(i_ret) );
+ }
+ else
+ {
+ intf_WarnMsg( 2, "thread info: %d has been joined (%s:%d)",
+ thread, psz_file, i_line );
+ }
+}
+
+#ifdef GPROF
+static void *vlc_thread_wrapper( void *p_wrapper )
+{
+ /* Put user data in thread-local variables */
+ void * p_data = ((wrapper_t*)p_wrapper)->p_data;
+ vlc_thread_func_t func = ((wrapper_t*)p_wrapper)->func;
+
+ /* Set the profile timer value */
+ setitimer( ITIMER_PROF, &((wrapper_t*)p_wrapper)->itimer, NULL );
+
+ /* Tell the calling thread that we don't need its data anymore */
+ vlc_mutex_lock( &((wrapper_t*)p_wrapper)->lock );
+ vlc_cond_signal( &((wrapper_t*)p_wrapper)->wait );
+ vlc_mutex_unlock( &((wrapper_t*)p_wrapper)->lock );
+
+ /* Call the real function */
+ return func( p_data );
+}
+#endif
+