X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=src%2Fmisc%2Fobjects.c;h=96214c14d0710889a451e8df0252bc433da03894;hb=0d8adc76dbf01e54ef043a07a623982a7fa9a426;hp=b4f3a6dfc60e4f7bacfe3cd3e93f8631ff865692;hpb=f9b646408f693e006d9df0afd3355374f0583d12;p=vlc diff --git a/src/misc/objects.c b/src/misc/objects.c index b4f3a6dfc6..96214c14d0 100644 --- a/src/misc/objects.c +++ b/src/misc/objects.c @@ -2,7 +2,6 @@ * objects.c: vlc_object_t handling ***************************************************************************** * Copyright (C) 2004-2008 the VideoLAN team - * $Id$ * * Authors: Samuel Hocevar * @@ -34,7 +33,7 @@ # include "config.h" #endif -#include +#include #include "../libvlc.h" #include @@ -82,14 +81,23 @@ static void ListChildren ( vlc_list_t *, vlc_object_t *, int ); static void vlc_object_destroy( vlc_object_t *p_this ); static void vlc_object_detach_unlocked (vlc_object_t *p_this); +#ifdef LIBVLC_REFCHECK +static vlc_threadvar_t held_objects; +typedef struct held_list_t +{ + struct held_list_t *next; + vlc_object_t *obj; +} held_list_t; +static void held_objects_destroy (void *); +#endif + /***************************************************************************** * Local structure lock *****************************************************************************/ static vlc_mutex_t structure_lock; -static vlc_threadvar_t thread_object; -void *vlc_custom_create( vlc_object_t *p_this, size_t i_size, - int i_type, const char *psz_type ) +void *__vlc_custom_create( vlc_object_t *p_this, size_t i_size, + int i_type, const char *psz_type ) { vlc_object_t *p_new; vlc_object_internals_t *p_priv; @@ -143,6 +151,10 @@ void *vlc_custom_create( vlc_object_t *p_this, size_t i_size, p_libvlc_global->i_counter = 0; p_priv->next = p_priv->prev = p_new; vlc_mutex_init( &structure_lock ); +#ifdef LIBVLC_REFCHECK + /* TODO: use the destruction callback to track ref leaks */ + vlc_threadvar_create( &held_objects, held_objects_destroy ); +#endif } else { @@ -164,14 +176,14 @@ void *vlc_custom_create( vlc_object_t *p_this, size_t i_size, p_new->p_private = NULL; /* Initialize mutexes and condvars */ - vlc_mutex_init( &p_new->object_lock ); - vlc_cond_init( p_new, &p_new->object_wait ); + vlc_mutex_init( &p_priv->lock ); + vlc_cond_init( p_new, &p_priv->wait ); vlc_mutex_init( &p_priv->var_lock ); vlc_spin_init( &p_priv->spin ); p_priv->pipes[0] = p_priv->pipes[1] = -1; p_priv->next = VLC_OBJECT (p_libvlc_global); -#if defined (NDEBUG) +#if !defined (LIBVLC_REFCHECK) /* ... */ #elif defined (LIBVLC_USE_PTHREAD) p_priv->creator_id = pthread_self (); @@ -214,26 +226,10 @@ void * __vlc_object_create( vlc_object_t *p_this, int i_type ) switch( i_type ) { - case VLC_OBJECT_LIBVLC: - i_size = sizeof(libvlc_int_t); - psz_type = "libvlc"; - break; case VLC_OBJECT_INTF: i_size = sizeof(intf_thread_t); psz_type = "interface"; break; - case VLC_OBJECT_DIALOGS: - i_size = sizeof(intf_thread_t); - psz_type = "dialogs"; - break; - case VLC_OBJECT_DEMUX: - i_size = sizeof(demux_t); - psz_type = "demux"; - break; - case VLC_OBJECT_ACCESS: - i_size = sizeof(access_t); - psz_type = "access"; - break; case VLC_OBJECT_DECODER: i_size = sizeof(decoder_t); psz_type = "decoder"; @@ -246,22 +242,10 @@ void * __vlc_object_create( vlc_object_t *p_this, int i_type ) i_size = sizeof(encoder_t); psz_type = "encoder"; break; - case VLC_OBJECT_FILTER: - i_size = sizeof(filter_t); - psz_type = "filter"; - break; - case VLC_OBJECT_VOUT: - i_size = sizeof(vout_thread_t); - psz_type = "video output"; - break; case VLC_OBJECT_AOUT: i_size = sizeof(aout_instance_t); psz_type = "audio output"; break; - case VLC_OBJECT_SOUT: - i_size = sizeof(sout_instance_t); - psz_type = "stream output"; - break; case VLC_OBJECT_OPENGL: i_size = sizeof( vout_thread_t ); psz_type = "opengl"; @@ -270,13 +254,9 @@ void * __vlc_object_create( vlc_object_t *p_this, int i_type ) i_size = sizeof( announce_handler_t ); psz_type = "announce"; break; - case VLC_OBJECT_INTERACTION: - i_size = sizeof( interaction_t ); - psz_type = "interaction"; - break; default: - i_size = i_type > (int)sizeof(vlc_object_t) - ? i_type : (int)sizeof(vlc_object_t); + assert( i_type > 0 ); /* unknown type?! */ + i_size = i_type; i_type = VLC_OBJECT_GENERIC; psz_type = "generic"; break; @@ -321,7 +301,12 @@ static void vlc_object_destroy( vlc_object_t *p_this ) /* If we are running on a thread, wait until it ends */ if( p_priv->b_thread ) + { + msg_Warn (p_this->p_libvlc, /* do NOT use a dead object for logging! */ + "%s %d destroyed while thread alive (VLC might crash)", + p_this->psz_object_type, p_this->i_object_id); vlc_thread_join( p_this ); + } /* Call the custom "subclass" destructor */ if( p_priv->pf_destructor ) @@ -341,9 +326,9 @@ static void vlc_object_destroy( vlc_object_t *p_this ) if( p_this->p_libvlc == NULL ) { +#ifndef NDEBUG libvlc_global_data_t *p_global = (libvlc_global_data_t *)p_this; -#ifndef NDEBUG assert( p_global == vlc_global() ); /* Test for leaks */ if (p_priv->next != p_this) @@ -372,6 +357,10 @@ static void vlc_object_destroy( vlc_object_t *p_this ) /* We are the global object ... no need to lock. */ vlc_mutex_destroy( &structure_lock ); +#ifdef LIBVLC_REFCHECK + held_objects_destroy( vlc_threadvar_get( &held_objects ) ); + vlc_threadvar_delete( &held_objects ); +#endif } FREENULL( p_this->psz_object_name ); @@ -383,8 +372,8 @@ static void vlc_object_destroy( vlc_object_t *p_this ) #endif vlc_spin_destroy( &p_priv->ref_spin ); - vlc_mutex_destroy( &p_this->object_lock ); - vlc_cond_destroy( &p_this->object_wait ); + vlc_mutex_destroy( &p_priv->lock ); + vlc_cond_destroy( &p_priv->wait ); vlc_spin_destroy( &p_priv->spin ); if( p_priv->pipes[1] != -1 ) close( p_priv->pipes[1] ); @@ -399,13 +388,13 @@ static void vlc_object_destroy( vlc_object_t *p_this ) void __vlc_object_lock( vlc_object_t *obj ) { - vlc_mutex_lock( &obj->object_lock ); + vlc_mutex_lock( &(vlc_internals(obj)->lock) ); } void __vlc_object_unlock( vlc_object_t *obj ) { - vlc_assert_locked( &obj->object_lock ); - vlc_mutex_unlock( &obj->object_lock ); + vlc_assert_locked( &(vlc_internals(obj)->lock) ); + vlc_mutex_unlock( &(vlc_internals(obj)->lock) ); } #ifdef WIN32 @@ -536,8 +525,9 @@ int __vlc_object_waitpipe( vlc_object_t *obj ) */ void __vlc_object_wait( vlc_object_t *obj ) { - vlc_assert_locked( &obj->object_lock ); - vlc_cond_wait( &obj->object_wait, &obj->object_lock ); + vlc_object_internals_t *priv = vlc_internals( obj ); + vlc_assert_locked( &priv->lock); + vlc_cond_wait( &priv->wait, &priv->lock ); } @@ -550,37 +540,9 @@ void __vlc_object_wait( vlc_object_t *obj ) */ int __vlc_object_timedwait( vlc_object_t *obj, mtime_t deadline ) { - vlc_assert_locked( &obj->object_lock ); - return vlc_cond_timedwait( &obj->object_wait, &obj->object_lock, deadline ); -} - - -/** - * Checks whether an object has been "killed". - * The object lock must be held. - * - * Typical code for an object thread could be: - * - vlc_object_lock (self); - ...initialization... - while (vlc_object_alive (self)) - { - ...preprocessing... - - vlc_object_wait (self); - - ...postprocessing... - } - ...deinitialization... - vlc_object_unlock (self); - * - * - * @return true iff the object has not been killed yet - */ -bool __vlc_object_alive( vlc_object_t *obj ) -{ - vlc_assert_locked( &obj->object_lock ); - return !obj->b_die; + vlc_object_internals_t *priv = vlc_internals( obj ); + vlc_assert_locked( &priv->lock); + return vlc_cond_timedwait( &priv->wait, &priv->lock, deadline ); } @@ -593,8 +555,8 @@ bool __vlc_object_alive( vlc_object_t *obj ) */ void __vlc_object_signal_unlocked( vlc_object_t *obj ) { - vlc_assert_locked (&obj->object_lock); - vlc_cond_signal( &obj->object_wait ); + vlc_assert_locked (&(vlc_internals(obj)->lock)); + vlc_cond_signal( &(vlc_internals(obj)->wait) ); } @@ -604,16 +566,16 @@ void __vlc_object_signal_unlocked( vlc_object_t *obj ) */ void __vlc_object_kill( vlc_object_t *p_this ) { - vlc_object_internals_t *internals = vlc_internals( p_this ); + vlc_object_internals_t *priv = vlc_internals( p_this ); int fd; - vlc_mutex_lock( &p_this->object_lock ); + vlc_object_lock( p_this ); p_this->b_die = true; - vlc_spin_lock (&internals->spin); - fd = internals->pipes[1]; - internals->pipes[1] = -1; - vlc_spin_unlock (&internals->spin); + vlc_spin_lock (&priv->spin); + fd = priv->pipes[1]; + priv->pipes[1] = -1; + vlc_spin_unlock (&priv->spin); if( fd != -1 ) { @@ -622,15 +584,8 @@ void __vlc_object_kill( vlc_object_t *p_this ) } vlc_object_signal_unlocked( p_this ); - vlc_mutex_unlock( &p_this->object_lock ); - - if (p_this->i_object_type == VLC_OBJECT_LIBVLC) - { - vlc_list_t *children = vlc_list_children (p_this); - for (int i = 0; i < children->i_count; i++) - vlc_object_kill (children->p_values[i].p_object); - vlc_list_release (children); - } + /* This also serves as a memory barrier toward vlc_object_alive(): */ + vlc_object_unlock( p_this ); } @@ -647,6 +602,7 @@ void * vlc_object_get( int i_id ) { libvlc_global_data_t *p_libvlc_global = vlc_global(); vlc_object_t *obj = NULL; +#ifndef NDEBUG vlc_object_t *caller = vlc_threadobj (); if (caller) @@ -654,7 +610,7 @@ void * vlc_object_get( int i_id ) else fprintf (stderr, "main thread uses deprecated vlc_object_get(%d)\n", i_id); - +#endif vlc_mutex_lock( &structure_lock ); for( obj = vlc_internals (p_libvlc_global)->next; @@ -668,10 +624,12 @@ void * vlc_object_get( int i_id ) } } obj = NULL; +#ifndef NDEBUG if (caller) msg_Warn (caller, "wants non-existing object %d", i_id); else fprintf (stderr, "main thread wants non-existing object %d\n", i_id); +#endif out: vlc_mutex_unlock( &structure_lock ); return obj; @@ -700,8 +658,8 @@ void * __vlc_object_find( vlc_object_t *p_this, int i_type, int i_mode ) { #ifndef NDEBUG if (i_type == VLC_OBJECT_PLAYLIST) - msg_Warn (p_this, "using vlc_object_find(VLC_OBJECT_PLAYLIST) " - "instead of pl_Yield()"); + msg_Err (p_this, "using vlc_object_find(VLC_OBJECT_PLAYLIST) " + "instead of pl_Yield()"); #endif return vlc_object_find (p_this->p_libvlc, i_type, (i_mode & ~0x000f)|FIND_CHILD); @@ -779,6 +737,16 @@ void __vlc_object_yield( vlc_object_t *p_this ) /* Increment the counter */ internals->i_refcount++; vlc_spin_unlock( &internals->ref_spin ); +#ifdef LIBVLC_REFCHECK + /* Update the list of referenced objects */ + /* Using TLS, so no need to lock */ + /* The following line may leak memory if a thread leaks objects. */ + held_list_t *newhead = malloc (sizeof (*newhead)); + held_list_t *oldhead = vlc_threadvar_get (&held_objects); + newhead->next = oldhead; + newhead->obj = p_this; + vlc_threadvar_set (&held_objects, newhead); +#endif } /***************************************************************************** @@ -790,6 +758,27 @@ void __vlc_object_release( vlc_object_t *p_this ) vlc_object_internals_t *internals = vlc_internals( p_this ); bool b_should_destroy; +#ifdef LIBVLC_REFCHECK + /* Update the list of referenced objects */ + /* Using TLS, so no need to lock */ + for (held_list_t *hlcur = vlc_threadvar_get (&held_objects), + *hlprev = NULL; + hlcur != NULL; + hlprev = hlcur, hlcur = hlcur->next) + { + if (hlcur->obj == p_this) + { + if (hlprev == NULL) + vlc_threadvar_set (&held_objects, hlcur->next); + else + hlprev->next = hlcur->next; + free (hlcur); + break; + } + } + /* TODO: what if releasing without references? */ +#endif + vlc_spin_lock( &internals->ref_spin ); assert( internals->i_refcount > 0 ); @@ -859,15 +848,6 @@ void __vlc_object_attach( vlc_object_t *p_this, vlc_object_t *p_parent ) INSERT_ELEM( priv->pp_children, priv->i_children, priv->i_children, p_this ); - /* Kill the object if parent is already dead. - * Note: We should surely lock parent here, but that would - * create quite a few dead lock case. Hopefully, it - * is perfectly safe to do it that way. We only risk - * receiving kill event twice. But given current API - * it is ok. */ - if( p_this->p_parent->b_die ) - vlc_object_kill( p_this ); - vlc_mutex_unlock( &structure_lock ); } @@ -1481,7 +1461,7 @@ static void ListChildren( vlc_list_t *p_list, vlc_object_t *p_this, int i_type ) } } -#ifndef NDEBUG +#ifdef LIBVLC_REFCHECK # if defined(HAVE_EXECINFO_H) && defined(HAVE_BACKTRACE) # include # endif @@ -1511,29 +1491,29 @@ void vlc_refcheck (vlc_object_t *obj) #endif return; - /* A thread can use its own object without reference! */ + /* A thread can use its own object without references! */ vlc_object_t *caller = vlc_threadobj (); if (caller == obj) return; - +#if 0 /* The calling thread is younger than the object. * Access could be valid through cross-thread synchronization; * we would need better accounting. */ if (caller && (caller->i_object_id > obj->i_object_id)) return; - +#endif int refs; vlc_spin_lock (&priv->ref_spin); refs = priv->i_refcount; vlc_spin_unlock (&priv->ref_spin); - /* Object has more than one reference. - * The current thread could be holding a valid reference. */ - if (refs > 1) - return; + for (held_list_t *hlcur = vlc_threadvar_get (&held_objects); + hlcur != NULL; hlcur = hlcur->next) + if (hlcur->obj == obj) + return; fprintf (stderr, "The %s %s thread object is accessing...\n" - "the %s %s object in a suspicous manner.\n", + "the %s %s object without references.\n", caller && caller->psz_object_name ? caller->psz_object_name : "unnamed", caller ? caller->psz_object_type : "main", @@ -1550,4 +1530,27 @@ void vlc_refcheck (vlc_object_t *obj) if (++errors == 100) fprintf (stderr, "Too many reference errors!\n"); } + +static void held_objects_destroy (void *data) +{ + VLC_UNUSED( data ); + held_list_t *hl = vlc_threadvar_get (&held_objects); + vlc_object_t *caller = vlc_threadobj (); + + while (hl != NULL) + { + held_list_t *buf = hl->next; + vlc_object_t *obj = hl->obj; + + fprintf (stderr, "The %s %s thread object leaked a reference to...\n" + "the %s %s object.\n", + caller && caller->psz_object_name + ? caller->psz_object_name : "unnamed", + caller ? caller->psz_object_type : "main", + obj->psz_object_name ? obj->psz_object_name : "unnamed", + obj->psz_object_type); + free (hl); + hl = buf; + } +} #endif