1 /*****************************************************************************
2 * threads.c : threads implementation for the VideoLAN client
3 *****************************************************************************
4 * Copyright (C) 1999, 2000, 2001, 2002 VideoLAN
5 * $Id: threads.c,v 1.1 2002/06/01 12:32:01 sam Exp $
7 * Authors: Jean-Marc Dressler <polux@via.ecp.fr>
8 * Samuel Hocevar <sam@zoy.org>
9 * Gildas Bazin <gbazin@netcourrier.com>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
24 *****************************************************************************/
28 #define VLC_THREADS_UNINITIALIZED 0
29 #define VLC_THREADS_PENDING 1
30 #define VLC_THREADS_ERROR 2
31 #define VLC_THREADS_READY 3
33 /*****************************************************************************
34 * Prototype for GPROF wrapper
35 *****************************************************************************/
37 /* Wrapper function for profiling */
38 static void * vlc_thread_wrapper ( void *p_wrapper );
42 # define ITIMER_REAL 1
43 # define ITIMER_PROF 2
47 struct timeval it_value;
48 struct timeval it_interval;
51 int setitimer(int kind, const struct itimerval* itnew, struct itimerval* itold);
54 typedef struct wrapper_s
56 /* Data lock access */
60 /* Data used to spawn the real thread */
61 vlc_thread_func_t func;
64 /* Profiling timer passed to the thread */
65 struct itimerval itimer;
71 /*****************************************************************************
72 * vlc_threads_init: initialize threads system
73 *****************************************************************************/
74 int __vlc_threads_init( vlc_object_t *p_this )
76 /* FIXME: this is definitely _not_ threadsafe, but at least it works
77 * under all implementations. We should for instance use pthread_once
78 * for lazy initialization of the global lock. */
79 static int i_status = VLC_THREADS_UNINITIALIZED;
82 if( i_status == VLC_THREADS_READY )
87 if( i_status == VLC_THREADS_UNINITIALIZED )
89 i_status = VLC_THREADS_PENDING;
91 #if defined( PTH_INIT_IN_PTH_H )
94 #elif defined( ST_INIT_IN_ST_H )
97 #elif defined( WIN32 )
100 #elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
103 #elif defined( HAVE_CTHREADS_H )
106 #elif defined( HAVE_KERNEL_SCHEDULER_H )
112 i_status = VLC_THREADS_ERROR;
116 vlc_mutex_init( p_this, p_this->p_vlc->p_global_lock );
118 i_status = VLC_THREADS_READY;
123 /* Wait until the other thread has initialized the thread library */
124 while( i_status == VLC_THREADS_PENDING )
126 msleep( THREAD_SLEEP );
129 return( i_status == VLC_THREADS_READY );
132 /*****************************************************************************
133 * vlc_threads_end: stop threads system
134 *****************************************************************************/
135 int vlc_threads_end( void )
137 #if defined( PTH_INIT_IN_PTH_H )
140 #elif defined( ST_INIT_IN_ST_H )
143 #elif defined( WIN32 )
146 #elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
149 #elif defined( HAVE_CTHREADS_H )
152 #elif defined( HAVE_KERNEL_SCHEDULER_H )
158 static int mutexes = 0;
159 /*****************************************************************************
160 * vlc_mutex_init: initialize a mutex
161 *****************************************************************************/
162 int __vlc_mutex_init( vlc_object_t *p_this, vlc_mutex_t *p_mutex )
164 #if defined( PTH_INIT_IN_PTH_H )
165 return pth_mutex_init( p_mutex );
167 #elif defined( ST_INIT_IN_ST_H )
168 *p_mutex = st_mutex_new();
169 return ( *p_mutex == NULL ) ? errno : 0;
171 #elif defined( WIN32 )
172 /* We use mutexes on WinNT/2K/XP because we can use the SignalObjectAndWait
173 * function and have a 100% correct vlc_cond_wait() implementation.
174 * As this function is not available on Win9x, we can use the faster
175 * CriticalSections */
176 if( (GetVersion() < 0x80000000) && !p_this->p_vlc->p_sys->b_fast_pthread )
178 /* We are running on NT/2K/XP, we can use SignalObjectAndWait */
179 p_mutex->mutex = CreateMutex( 0, FALSE, 0 );
180 p_mutex->SignalObjectAndWait =
181 p_this->p_vlc->p_sys->SignalObjectAndWait;
182 return ( p_mutex->mutex ? 0 : 1 );
186 InitializeCriticalSection( &p_mutex->csection );
187 p_mutex->mutex = NULL;
191 #elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
192 # if defined(DEBUG) && defined(SYS_LINUX)
193 /* Create error-checking mutex to detect threads problems more easily. */
194 pthread_mutexattr_t attr;
197 pthread_mutexattr_init( &attr );
198 pthread_mutexattr_setkind_np( &attr, PTHREAD_MUTEX_ERRORCHECK_NP );
199 i_result = pthread_mutex_init( p_mutex, &attr );
200 pthread_mutexattr_destroy( &attr );
203 return pthread_mutex_init( p_mutex, NULL );
205 #elif defined( HAVE_CTHREADS_H )
206 mutex_init( p_mutex );
209 #elif defined( HAVE_KERNEL_SCHEDULER_H )
211 /* check the arguments and whether it's already been initialized */
212 if( p_mutex == NULL )
217 if( p_mutex->init == 9999 )
222 p_mutex->lock = create_sem( 1, "BeMutex" );
223 if( p_mutex->lock < B_NO_ERROR )
228 p_mutex->init = 9999;
234 /*****************************************************************************
235 * vlc_mutex_destroy: destroy a mutex, inner version
236 *****************************************************************************/
237 int __vlc_mutex_destroy( char * psz_file, int i_line, vlc_mutex_t *p_mutex )
239 #if defined( PTH_INIT_IN_PTH_H )
242 #elif defined( ST_INIT_IN_ST_H )
243 return st_mutex_destroy( *p_mutex );
245 #elif defined( WIN32 )
248 CloseHandle( p_mutex->mutex );
252 DeleteCriticalSection( &p_mutex->csection );
256 #elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
257 int i_return = pthread_mutex_destroy( p_mutex );
260 //X intf_ErrMsg( "thread %d error: mutex_destroy failed at %s:%d (%s)",
261 //X pthread_self(), psz_file, i_line, strerror(i_return) );
265 #elif defined( HAVE_CTHREADS_H )
268 #elif defined( HAVE_KERNEL_SCHEDULER_H )
269 if( p_mutex->init == 9999 )
271 delete_sem( p_mutex->lock );
280 /*****************************************************************************
281 * vlc_cond_init: initialize a condition
282 *****************************************************************************/
283 int vlc_cond_init( vlc_cond_t *p_condvar )
285 #if defined( PTH_INIT_IN_PTH_H )
286 return pth_cond_init( p_condvar );
288 #elif defined( ST_INIT_IN_ST_H )
289 *p_condvar = st_cond_new();
290 return ( *p_condvar == NULL ) ? errno : 0;
292 #elif defined( WIN32 )
293 /* initialise counter */
294 p_condvar->i_waiting_threads = 0;
296 /* Create an auto-reset event. */
297 p_condvar->signal = CreateEvent( NULL, /* no security */
298 FALSE, /* auto-reset event */
299 FALSE, /* non-signaled initially */
300 NULL ); /* unnamed */
302 return( !p_condvar->signal );
304 #elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
305 return pthread_cond_init( p_condvar, NULL );
307 #elif defined( HAVE_CTHREADS_H )
308 /* condition_init() */
309 spin_lock_init( &p_condvar->lock );
310 cthread_queue_init( &p_condvar->queue );
312 p_condvar->implications = 0;
316 #elif defined( HAVE_KERNEL_SCHEDULER_H )
322 if( p_condvar->init == 9999 )
327 p_condvar->thread = -1;
328 p_condvar->init = 9999;
334 /*****************************************************************************
335 * vlc_cond_destroy: destroy a condition, inner version
336 *****************************************************************************/
337 int __vlc_cond_destroy( char * psz_file, int i_line, vlc_cond_t *p_condvar )
339 #if defined( PTH_INIT_IN_PTH_H )
342 #elif defined( ST_INIT_IN_ST_H )
343 return st_cond_destroy( *p_condvar );
345 #elif defined( WIN32 )
346 return( !CloseHandle( p_condvar->signal ) );
348 #elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
349 int i_result = pthread_cond_destroy( p_condvar );
352 //X intf_ErrMsg( "thread %d error: cond_destroy failed at %s:%d (%s)",
353 //X pthread_self(), psz_file, i_line, strerror(i_result) );
357 #elif defined( HAVE_CTHREADS_H )
360 #elif defined( HAVE_KERNEL_SCHEDULER_H )
367 /*****************************************************************************
368 * vlc_thread_create: create a thread, inner version
369 *****************************************************************************/
370 int __vlc_thread_create( vlc_object_t *p_this, char * psz_file, int i_line,
371 char *psz_name, void * ( *func ) ( void * ),
376 vlc_mutex_init( p_this, &p_this->thread_lock );
377 vlc_cond_init( &p_this->thread_wait );
378 vlc_mutex_lock( &p_this->thread_lock );
383 /* Initialize the wrapper structure */
385 wrapper.p_data = (void *)p_this;
386 getitimer( ITIMER_PROF, &wrapper.itimer );
387 vlc_mutex_init( p_this, &wrapper.lock );
388 vlc_cond_init( &wrapper.wait );
389 vlc_mutex_lock( &wrapper.lock );
391 /* Alter user-passed data so that we call the wrapper instead
392 * of the real function */
394 func = vlc_thread_wrapper;
397 #if defined( PTH_INIT_IN_PTH_H )
398 p_this->thread_id = pth_spawn( PTH_ATTR_DEFAULT, func, (void *)p_this );
401 #elif defined( ST_INIT_IN_ST_H )
402 p_this->thread_id = st_thread_create( func, (void *)p_this, 1, 0 );
405 #elif defined( WIN32 )
407 /* When using the MSVCRT C library you have to use the _beginthreadex
408 * function instead of CreateThread, otherwise you'll end up with memory
409 * leaks and the signal functions not working */
410 p_this->thread_id = (HANDLE)_beginthreadex( NULL, 0, (PTHREAD_START) func,
411 (void *)p_this, 0, &threadID );
413 i_ret = ( p_this->thread_id ? 0 : 1 );
415 #elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
416 i_ret = pthread_create( &p_this->thread_id, NULL, func, (void *)p_this );
418 #elif defined( HAVE_CTHREADS_H )
419 p_this->thread_id = cthread_fork( (cthread_fn_t)func, (any_t)p_this );
422 #elif defined( HAVE_KERNEL_SCHEDULER_H )
423 p_this->thread_id = spawn_thread( (thread_func)func, psz_name,
424 B_NORMAL_PRIORITY, (void *)p_this );
425 i_ret = resume_thread( p_this->thread_id );
432 vlc_cond_wait( &wrapper.wait, &wrapper.lock );
435 vlc_mutex_unlock( &wrapper.lock );
436 vlc_mutex_destroy( &wrapper.lock );
437 vlc_cond_destroy( &wrapper.wait );
442 msg_Dbg( p_this, "thread %d (%s) created (%s:%d)",
443 p_this->thread_id, psz_name, psz_file, i_line );
445 p_this->b_thread = 1;
449 msg_Dbg( p_this, "waiting for thread completion" );
450 vlc_cond_wait( &p_this->thread_wait, &p_this->thread_lock );
453 vlc_mutex_unlock( &p_this->thread_lock );
457 msg_Err( p_this, "%s thread could not be created at %s:%d (%s)",
458 psz_name, psz_file, i_line, strerror(i_ret) );
459 vlc_mutex_unlock( &p_this->thread_lock );
460 vlc_mutex_destroy( &p_this->thread_lock );
461 vlc_cond_destroy( &p_this->thread_wait );
467 /*****************************************************************************
468 * vlc_thread_ready: tell the parent thread we were successfully spawned
469 *****************************************************************************/
470 void __vlc_thread_ready( vlc_object_t *p_this )
472 vlc_mutex_lock( &p_this->thread_lock );
473 vlc_cond_signal( &p_this->thread_wait );
474 vlc_mutex_unlock( &p_this->thread_lock );
477 /*****************************************************************************
478 * vlc_thread_join: wait until a thread exits, inner version
479 *****************************************************************************/
480 void __vlc_thread_join( vlc_object_t *p_this, char * psz_file, int i_line )
484 #if defined( PTH_INIT_IN_PTH_H )
485 i_ret = pth_join( p_this->thread_id, NULL );
487 #elif defined( ST_INIT_IN_ST_H )
488 i_ret = st_thread_join( p_this->thread_id, NULL );
490 #elif defined( WIN32 )
491 WaitForSingleObject( p_this->thread_id, INFINITE );
493 #elif defined( PTHREAD_COND_T_IN_PTHREAD_H )
494 i_ret = pthread_join( p_this->thread_id, NULL );
496 #elif defined( HAVE_CTHREADS_H )
497 cthread_join( p_this->thread_id );
500 #elif defined( HAVE_KERNEL_SCHEDULER_H )
502 wait_for_thread( p_this->thread_id, &exit_value );
506 vlc_mutex_destroy( &p_this->thread_lock );
507 vlc_cond_destroy( &p_this->thread_wait );
511 msg_Err( p_this, "thread_join(%d) failed at %s:%d (%s)",
512 p_this->thread_id, psz_file, i_line, strerror(i_ret) );
516 msg_Dbg( p_this, "thread %d joined (%s:%d)",
517 p_this->thread_id, psz_file, i_line );
520 p_this->b_thread = 0;
523 /*****************************************************************************
524 * vlc_thread_wrapper: wrapper around thread functions used when profiling.
525 *****************************************************************************/
527 static void *vlc_thread_wrapper( void *p_wrapper )
529 /* Put user data in thread-local variables */
530 void * p_data = ((wrapper_t*)p_wrapper)->p_data;
531 vlc_thread_func_t func = ((wrapper_t*)p_wrapper)->func;
533 /* Set the profile timer value */
534 setitimer( ITIMER_PROF, &((wrapper_t*)p_wrapper)->itimer, NULL );
536 /* Tell the calling thread that we don't need its data anymore */
537 vlc_mutex_lock( &((wrapper_t*)p_wrapper)->lock );
538 vlc_cond_signal( &((wrapper_t*)p_wrapper)->wait );
539 vlc_mutex_unlock( &((wrapper_t*)p_wrapper)->lock );
541 /* Call the real function */
542 return func( p_data );