]> git.sesse.net Git - vlc/blob - src/misc/stats.c
* Improve timers (Refs:#473)
[vlc] / src / misc / stats.c
1 /*****************************************************************************
2  * stats.c: Statistics handling
3  *****************************************************************************
4  * Copyright (C) 2006 the VideoLAN team
5  * $Id$
6  *
7  * Authors: ClĂ©ment Stenac <zorglub@videolan.org>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22  *****************************************************************************/
23
24 /*****************************************************************************
25  * Preamble
26  *****************************************************************************/
27 #include <stdio.h>                                               /* required */
28
29 #include <vlc/vlc.h>
30 #include <vlc_input.h>
31
32 /*****************************************************************************
33  * Local prototypes
34  *****************************************************************************/
35 static counter_t *GetCounter( stats_handler_t *p_handler, int i_object_id,
36                               const char *psz_name );
37 static int stats_CounterUpdate( stats_handler_t *p_handler,
38                                 counter_t *p_counter,
39                                 vlc_value_t val );
40 static stats_handler_t* stats_HandlerCreate( vlc_object_t *p_this );
41 static stats_handler_t *stats_HandlerGet( vlc_object_t *p_this );
42
43 static void TimerDump( vlc_object_t *p_this, counter_t *p_counter, vlc_bool_t);
44
45 /*****************************************************************************
46  * Exported functions
47  *****************************************************************************/
48
49 /**
50  * Cleanup statistics handler stuff
51  * \param p_stats the handler to clean
52  * \return nothing
53  */
54 void stats_HandlerDestroy( stats_handler_t *p_stats )
55 {
56     int i;
57     for ( i =  p_stats->i_counters - 1 ; i >= 0 ; i-- )
58     {
59         int j;
60         counter_t * p_counter = p_stats->pp_counters[i];
61
62         for( j = p_counter->i_samples -1; j >= 0 ; j-- )
63         {
64             counter_sample_t *p_sample = p_counter->pp_samples[j];
65             REMOVE_ELEM( p_counter->pp_samples, p_counter->i_samples, j );
66             free( p_sample );
67         }
68         free( p_counter->psz_name );
69         REMOVE_ELEM( p_stats->pp_counters, p_stats->i_counters, i );
70         free( p_counter );
71     }
72 }
73
74 /**
75  * Create a statistics counter
76  * \param p_this the object for which to create the counter
77  * \param psz_name the name
78  * \param i_type the type of stored data. One of VLC_VAR_STRING,
79  * VLC_VAR_INTEGER, VLC_VAR_FLOAT
80  * \param i_compute_type the aggregation type. One of STATS_LAST (always
81  * keep the last value), STATS_COUNTER (increment by the passed value),
82  * STATS_MAX (keep the maximum passed value), STATS_MIN, or STATS_DERIVATIVE
83  * (keep a time derivative of the value)
84  */
85 int __stats_Create( vlc_object_t *p_this, const char *psz_name, int i_type,
86                     int i_compute_type )
87 {
88     counter_t *p_counter;
89     stats_handler_t *p_handler;
90
91     if( p_this->p_libvlc->b_stats == VLC_FALSE )
92     {
93         return VLC_EGENERIC;
94     }
95     p_handler = stats_HandlerGet( p_this );
96     if( !p_handler ) return VLC_ENOMEM;
97
98     vlc_mutex_lock( &p_handler->object_lock );
99
100     p_counter = (counter_t*) malloc( sizeof( counter_t ) ) ;
101
102     p_counter->psz_name = strdup( psz_name );
103     p_counter->i_source_object = p_this->i_object_id;
104     p_counter->i_compute_type = i_compute_type;
105     p_counter->i_type = i_type;
106     p_counter->i_samples = 0;
107     p_counter->pp_samples = NULL;
108
109     p_counter->update_interval = 0;
110     p_counter->last_update = 0;
111
112     INSERT_ELEM( p_handler->pp_counters,
113                  p_handler->i_counters,
114                  p_handler->i_counters,
115                  p_counter );
116
117     vlc_mutex_unlock( &p_handler->object_lock );
118
119     return VLC_SUCCESS;
120 }
121
122 /** Update a counter element with new values
123  * \param p_this the object in which to update
124  * \param psz_name the name
125  * \param val the vlc_value union containing the new value to aggregate. For
126  * more information on how data is aggregated, \see __stats_Create
127  */
128 int __stats_Update( vlc_object_t *p_this, const char *psz_name,
129                     vlc_value_t val )
130 {
131     int i_ret;
132     counter_t *p_counter;
133
134     /* Get stats handler singleton */
135     stats_handler_t *p_handler;
136     if( p_this->p_libvlc->b_stats == VLC_FALSE )
137     {
138         return VLC_EGENERIC;
139     }
140     p_handler = stats_HandlerGet( p_this );
141     if( !p_handler ) return VLC_ENOMEM;
142
143     vlc_mutex_lock( &p_handler->object_lock );
144     /* Look for existing element */
145     p_counter = GetCounter( p_handler, p_this->i_object_id,
146                             psz_name );
147     if( !p_counter )
148     {
149         vlc_mutex_unlock( &p_handler->object_lock );
150         vlc_object_release( p_handler );
151         return VLC_ENOOBJ;
152     }
153
154     i_ret = stats_CounterUpdate( p_handler, p_counter, val );
155     vlc_mutex_unlock( &p_handler->object_lock );
156
157     return i_ret;
158 }
159
160 /** Get the aggregated value for a counter
161  * \param p_this an object
162  * \param i_object_id the object id from which we want the data
163  * \param psz_name the name of the couner
164  * \param val a pointer to an initialized vlc_value union. It will contain the
165  * retrieved value
166  * \return an error code
167  */
168 int __stats_Get( vlc_object_t *p_this, int i_object_id,
169                  const char *psz_name, vlc_value_t *val )
170 {
171     counter_t *p_counter;
172
173     /* Get stats handler singleton */
174     stats_handler_t *p_handler;
175     if( p_this->p_libvlc->b_stats == VLC_FALSE )
176     {
177         return VLC_EGENERIC;
178     }
179     p_handler = stats_HandlerGet( p_this );
180     if( !p_handler ) return VLC_ENOMEM;
181     vlc_mutex_lock( &p_handler->object_lock );
182
183     /* Look for existing element */
184     p_counter = GetCounter( p_handler, i_object_id,
185                             psz_name );
186     if( !p_counter )
187     {
188         vlc_mutex_unlock( &p_handler->object_lock );
189         vlc_object_release( p_handler );
190         val->i_int = val->f_float = 0.0;
191         return VLC_ENOOBJ;
192     }
193
194     if( p_counter->i_samples == 0 )
195     {
196         vlc_mutex_unlock( &p_handler->object_lock );
197         val->i_int = val->f_float = 0.0;
198         return VLC_EGENERIC;
199     }
200
201     switch( p_counter->i_compute_type )
202     {
203     case STATS_LAST:
204     case STATS_MIN:
205     case STATS_MAX:
206     case STATS_COUNTER:
207         *val = p_counter->pp_samples[0]->value;
208         break;
209     case STATS_DERIVATIVE:
210         /* Not ready yet */
211         if( p_counter->i_samples < 2 )
212         {
213             vlc_mutex_unlock( &p_handler->object_lock );
214             val->i_int = 0; val->f_float = 0.0;
215             return VLC_EGENERIC;
216         }
217         if( p_counter->i_type == VLC_VAR_INTEGER )
218         {
219             float f = ( p_counter->pp_samples[0]->value.i_int -
220                         p_counter->pp_samples[1]->value.i_int ) /
221                     (float)(  p_counter->pp_samples[0]->date -
222                               p_counter->pp_samples[1]->date );
223             val->i_int = (int)f;
224         }
225         else
226         {
227             float f = (float)( p_counter->pp_samples[0]->value.f_float -
228                                p_counter->pp_samples[1]->value.f_float ) /
229                       (float)( p_counter->pp_samples[0]->date -
230                                p_counter->pp_samples[1]->date );
231             val->f_float = f;
232         }
233         break;
234     }
235     vlc_object_release( p_handler );
236
237     vlc_mutex_unlock( &p_handler->object_lock );
238     return VLC_SUCCESS;;
239 }
240
241 /** Get a statistics counter structure. This allows for low-level modifications
242  * \param p_this a parent object
243  * \param i_object_id the object from which to retrieve data
244  * \param psz_name the name
245  * \return the counter, or NULL if not found (or handler not created yet)
246  */
247 counter_t *__stats_CounterGet( vlc_object_t *p_this, int i_object_id,
248                                const char *psz_name )
249 {
250     counter_t *p_counter;
251
252     stats_handler_t *p_handler;
253     if( p_this->p_libvlc->b_stats == VLC_FALSE )
254     {
255         return NULL;
256     }
257     p_handler = stats_HandlerGet( p_this );
258     if( !p_handler ) return NULL;
259
260     vlc_mutex_lock( &p_handler->object_lock );
261
262     /* Look for existing element */
263     p_counter = GetCounter( p_handler, i_object_id,
264                             psz_name );
265     vlc_mutex_unlock( &p_handler->object_lock );
266     vlc_object_release( p_handler );
267
268     return p_counter;
269 }
270
271
272 void stats_ComputeInputStats( input_thread_t *p_input,
273                               input_stats_t *p_stats )
274 {
275     vlc_object_t *p_obj;
276     vlc_list_t *p_list;
277     int i_index;
278     vlc_mutex_lock( &p_stats->lock );
279
280     /* Input */
281     stats_GetInteger( p_input, p_input->i_object_id, "read_packets",
282                        &p_stats->i_read_packets );
283     stats_GetInteger( p_input, p_input->i_object_id, "read_bytes",
284                        &p_stats->i_read_bytes );
285     stats_GetFloat( p_input, p_input->i_object_id, "input_bitrate",
286                        &p_stats->f_input_bitrate );
287
288     stats_GetInteger( p_input, p_input->i_object_id, "demux_read",
289                       &p_stats->i_demux_read_bytes );
290     stats_GetFloat( p_input, p_input->i_object_id, "demux_bitrate",
291                       &p_stats->f_demux_bitrate );
292
293     stats_GetInteger( p_input, p_input->i_object_id, "decoded_video",
294                       &p_stats->i_decoded_video );
295     stats_GetInteger( p_input, p_input->i_object_id, "decoded_audio",
296                       &p_stats->i_decoded_audio );
297
298     /* Sout */
299     stats_GetInteger( p_input, p_input->i_object_id, "sout_sent_packets",
300                       &p_stats->i_sent_packets );
301     stats_GetInteger( p_input, p_input->i_object_id, "sout_sent_bytes",
302                       &p_stats->i_sent_bytes );
303     stats_GetFloat  ( p_input, p_input->i_object_id, "sout_send_bitrate",
304                       &p_stats->f_send_bitrate );
305
306     /* Aout - We store in p_input because aout is shared */
307     stats_GetInteger( p_input, p_input->i_object_id, "played_abuffers",
308                       &p_stats->i_played_abuffers );
309     stats_GetInteger( p_input, p_input->i_object_id, "lost_abuffers",
310                       &p_stats->i_lost_abuffers );
311
312     /* Vouts - FIXME: Store all in input */
313     p_list = vlc_list_find( p_input, VLC_OBJECT_VOUT, FIND_CHILD );
314     if( p_list )
315     {
316         p_stats->i_displayed_pictures  = 0 ;
317         p_stats->i_lost_pictures = 0;
318         for( i_index = 0; i_index < p_list->i_count ; i_index ++ )
319         {
320             int i_displayed = 0, i_lost = 0;
321             p_obj = (vlc_object_t *)p_list->p_values[i_index].p_object;
322             stats_GetInteger( p_obj, p_obj->i_object_id, "displayed_pictures",
323                               &i_displayed );
324             stats_GetInteger( p_obj, p_obj->i_object_id, "lost_pictures",
325                               &i_lost );
326             p_stats->i_displayed_pictures += i_displayed;
327             p_stats->i_lost_pictures += i_lost;
328          }
329         vlc_list_release( p_list );
330     }
331
332     vlc_mutex_unlock( &p_stats->lock );
333 }
334
335
336 void stats_ReinitInputStats( input_stats_t *p_stats )
337 {
338     p_stats->i_read_packets = p_stats->i_read_bytes =
339     p_stats->f_input_bitrate = p_stats->f_average_input_bitrate =
340     p_stats->i_demux_read_packets = p_stats->i_demux_read_bytes =
341     p_stats->f_demux_bitrate = p_stats->f_average_demux_bitrate =
342     p_stats->i_displayed_pictures = p_stats->i_lost_pictures =
343     p_stats->i_played_abuffers = p_stats->i_lost_abuffers =
344     p_stats->i_decoded_video = p_stats->i_decoded_audio =
345     p_stats->i_sent_bytes = p_stats->i_sent_packets = p_stats->f_send_bitrate
346      = 0;
347 }
348
349 void stats_DumpInputStats( input_stats_t *p_stats  )
350 {
351     vlc_mutex_lock( &p_stats->lock );
352     /* f_bitrate is in bytes / microsecond
353      * *1000 => bytes / millisecond => kbytes / seconds */
354     fprintf( stderr, "Input : %i (%i bytes) - %f kB/s - Demux : %i (%i bytes) - %f kB/s\n"
355                      " - Vout : %i/%i - Aout : %i/%i - Vout : %f\n",
356                     p_stats->i_read_packets, p_stats->i_read_bytes,
357                     p_stats->f_input_bitrate * 1000,
358                     p_stats->i_demux_read_packets, p_stats->i_demux_read_bytes,
359                     p_stats->f_demux_bitrate * 1000,
360                     p_stats->i_displayed_pictures, p_stats->i_lost_pictures,
361                     p_stats->i_played_abuffers, p_stats->i_lost_abuffers,
362                     p_stats->f_send_bitrate );
363     vlc_mutex_unlock( &p_stats->lock );
364 }
365
366 void __stats_ComputeGlobalStats( vlc_object_t *p_obj,
367                                 global_stats_t *p_stats )
368 {
369     vlc_list_t *p_list;
370     int i_index;
371     vlc_mutex_lock( &p_stats->lock );
372
373     p_list = vlc_list_find( p_obj, VLC_OBJECT_INPUT, FIND_CHILD );
374     if( p_list )
375     {
376         for( i_index = 0; i_index < p_list->i_count ; i_index ++ )
377         {
378             float f_in = 0, f_out = 0;
379             p_obj = (vlc_object_t *)p_list->p_values[i_index].p_object;
380             stats_GetFloat( p_obj, p_obj->i_object_id, "input_bitrate",
381                             &f_in );
382             stats_GetFloat( p_obj, p_obj->i_object_id, "sout_send_bitrate",
383                             &f_out );
384             p_stats->f_input_bitrate += f_in;
385             p_stats->f_output_bitrate += f_out;
386         }
387         vlc_list_release( p_list );
388     }
389
390     vlc_mutex_unlock( &p_stats->lock );
391 }
392
393 void stats_ReinitGlobalStats( global_stats_t *p_stats )
394 {
395     p_stats->f_input_bitrate = p_stats->f_output_bitrate = 0.0;
396 }
397
398
399 void __stats_TimerStart( vlc_object_t *p_obj, const char *psz_name )
400 {
401     counter_t *p_counter = stats_CounterGet( p_obj,
402                                              p_obj->p_vlc->i_object_id,
403                                              psz_name );
404     if( !p_counter )
405     {
406         counter_sample_t *p_sample;
407         stats_Create( p_obj->p_vlc, psz_name, VLC_VAR_TIME, STATS_TIMER );
408         p_counter = stats_CounterGet( p_obj,  p_obj->p_vlc->i_object_id,
409                                       psz_name );
410         if( !p_counter ) return;
411         /* 1st sample : if started: start_date, else last_time, b_started */
412         p_sample = (counter_sample_t *)malloc( sizeof( counter_sample_t ) );
413         INSERT_ELEM( p_counter->pp_samples, p_counter->i_samples,
414                      p_counter->i_samples, p_sample );
415         p_sample->date = 0; p_sample->value.b_bool = 0;
416         /* 2nd sample : global_time, i_samples */
417         p_sample = (counter_sample_t *)malloc( sizeof( counter_sample_t ) );
418         INSERT_ELEM( p_counter->pp_samples, p_counter->i_samples,
419                      p_counter->i_samples, p_sample );
420         p_sample->date = 0; p_sample->value.i_int = 0;
421     }
422     if( p_counter->pp_samples[0]->value.b_bool == VLC_TRUE )
423     {
424         msg_Warn( p_obj, "timer %s was already started !", psz_name );
425         return;
426     }
427     p_counter->pp_samples[0]->value.b_bool = VLC_TRUE;
428     p_counter->pp_samples[0]->date = mdate();
429 }
430
431 void __stats_TimerStop( vlc_object_t *p_obj, const char *psz_name )
432 {
433     counter_t *p_counter = stats_CounterGet( p_obj,
434                                               p_obj->p_vlc->i_object_id,
435                                              psz_name );
436     if( !p_counter || p_counter->i_samples != 2 )
437     {
438         msg_Err( p_obj, "timer %s does not exist", psz_name );
439         return;
440     }
441     p_counter->pp_samples[0]->value.b_bool = VLC_FALSE;
442     p_counter->pp_samples[1]->value.i_int += 1;
443     p_counter->pp_samples[0]->date = mdate() - p_counter->pp_samples[0]->date;
444     p_counter->pp_samples[1]->date += p_counter->pp_samples[0]->date;
445 }
446
447 void __stats_TimerDump( vlc_object_t *p_obj, const char *psz_name )
448 {
449     counter_t *p_counter = stats_CounterGet( p_obj,
450                                              p_obj->p_vlc->i_object_id,
451                                              psz_name );
452     TimerDump( p_obj, p_counter, VLC_TRUE );
453 }
454
455
456 void __stats_TimersDumpAll( vlc_object_t *p_obj )
457 {
458     int i;
459     stats_handler_t *p_handler = stats_HandlerGet( p_obj );
460     if( !p_handler ) return;
461
462     vlc_mutex_lock( &p_handler->object_lock );
463     for ( i = 0 ; i< p_handler->i_counters; i++ )
464     {
465         if( p_handler->pp_counters[i]->i_compute_type == STATS_TIMER )
466         {
467             TimerDump( p_obj, p_handler->pp_counters[i], VLC_FALSE );
468         }
469     }
470     vlc_mutex_unlock( &p_handler->object_lock );
471 }
472
473
474 /********************************************************************
475  * Following functions are local
476  ********************************************************************/
477
478 /**
479  * Update a statistics counter, according to its type
480  * If needed, perform a bit of computation (derivative, mostly)
481  * This function must be entered with stats handler lock
482  * \param p_handler stats handler singleton
483  * \param p_counter the counter to update
484  * \param val the "new" value
485  * \return an error code
486  */
487 static int stats_CounterUpdate( stats_handler_t *p_handler,
488                                 counter_t *p_counter,
489                                 vlc_value_t val )
490 {
491     switch( p_counter->i_compute_type )
492     {
493     case STATS_LAST:
494     case STATS_MIN:
495     case STATS_MAX:
496         if( p_counter->i_samples > 1)
497         {
498             msg_Err( p_handler, "LAST counter has several samples !" );
499             return VLC_EGENERIC;
500         }
501         if( p_counter->i_type != VLC_VAR_FLOAT &&
502             p_counter->i_type != VLC_VAR_INTEGER &&
503             p_counter->i_compute_type != STATS_LAST )
504         {
505             msg_Err( p_handler, "Unable to compute MIN or MAX for this type");
506             return VLC_EGENERIC;
507         }
508
509         if( p_counter->i_samples == 0 )
510         {
511             counter_sample_t *p_new = (counter_sample_t*)malloc(
512                                                sizeof( counter_sample_t ) );
513             p_new->value.psz_string = NULL;
514
515             INSERT_ELEM( p_counter->pp_samples, p_counter->i_samples,
516                          p_counter->i_samples, p_new );
517         }
518         if( p_counter->i_samples == 1 )
519         {
520             /* Update if : LAST or (MAX and bigger) or (MIN and bigger) */
521             if( p_counter->i_compute_type == STATS_LAST ||
522                 ( p_counter->i_compute_type == STATS_MAX &&
523                    ( ( p_counter->i_type == VLC_VAR_INTEGER &&
524                        p_counter->pp_samples[0]->value.i_int > val.i_int ) ||
525                      ( p_counter->i_type == VLC_VAR_FLOAT &&
526                        p_counter->pp_samples[0]->value.f_float > val.f_float )
527                    ) ) ||
528                 ( p_counter->i_compute_type == STATS_MIN &&
529                    ( ( p_counter->i_type == VLC_VAR_INTEGER &&
530                        p_counter->pp_samples[0]->value.i_int < val.i_int ) ||
531                      ( p_counter->i_type == VLC_VAR_FLOAT &&
532                        p_counter->pp_samples[0]->value.f_float < val.f_float )
533                    ) ) )
534             {
535                 if( p_counter->i_type == VLC_VAR_STRING &&
536                     p_counter->pp_samples[0]->value.psz_string )
537                 {
538                     free( p_counter->pp_samples[0]->value.psz_string );
539                 }
540                 p_counter->pp_samples[0]->value = val;
541             }
542         }
543         break;
544     case STATS_DERIVATIVE:
545     {
546         counter_sample_t *p_new, *p_old;
547         if( mdate() - p_counter->last_update < p_counter->update_interval )
548         {
549             return VLC_EGENERIC;
550         }
551         p_counter->last_update = mdate();
552         if( p_counter->i_type != VLC_VAR_FLOAT &&
553             p_counter->i_type != VLC_VAR_INTEGER )
554         {
555             msg_Err( p_handler, "Unable to compute DERIVATIVE for this type");
556             return VLC_EGENERIC;
557         }
558         /* Insert the new one at the beginning */
559         p_new = (counter_sample_t*)malloc( sizeof( counter_sample_t ) );
560         p_new->value = val;
561         p_new->date = p_counter->last_update;
562         INSERT_ELEM( p_counter->pp_samples, p_counter->i_samples,
563                      0, p_new );
564
565         if( p_counter->i_samples == 3 )
566         {
567             p_old = p_counter->pp_samples[2];
568             REMOVE_ELEM( p_counter->pp_samples, p_counter->i_samples, 2 );
569             free( p_old );
570         }
571         break;
572     }
573     case STATS_COUNTER:
574         if( p_counter->i_samples > 1)
575         {
576             msg_Err( p_handler, "LAST counter has several samples !" );
577             return VLC_EGENERIC;
578         }
579         if( p_counter->i_samples == 0 )
580         {
581             counter_sample_t *p_new = (counter_sample_t*)malloc(
582                                                sizeof( counter_sample_t ) );
583             p_new->value.psz_string = NULL;
584
585             INSERT_ELEM( p_counter->pp_samples, p_counter->i_samples,
586                          p_counter->i_samples, p_new );
587         }
588         if( p_counter->i_samples == 1 )
589         {
590             switch( p_counter->i_type )
591             {
592             case VLC_VAR_INTEGER:
593             case VLC_VAR_FLOAT:
594                 p_counter->pp_samples[0]->value.i_int += val.i_int;
595                 break;
596             default:
597                 msg_Err( p_handler, "Trying to increment invalid variable %s",
598                          p_counter->psz_name );
599                 return VLC_EGENERIC;
600             }
601         }
602         break;
603     }
604     return VLC_SUCCESS;
605 }
606
607 static counter_t *GetCounter( stats_handler_t *p_handler, int i_object_id,
608                               const char *psz_name )
609 {
610     int i;
611    for( i = 0; i< p_handler->i_counters; i++ )
612     {
613         counter_t *p_counter = p_handler->pp_counters[i];
614         if( p_counter->i_source_object == i_object_id &&
615             !strcmp( p_counter->psz_name, psz_name ) )
616         {
617             return p_counter;
618         }
619     }
620     return NULL;
621 }
622
623
624 static stats_handler_t *stats_HandlerGet( vlc_object_t *p_this )
625 {
626     stats_handler_t *p_handler = (stats_handler_t*)
627                           vlc_object_find( p_this->p_vlc, VLC_OBJECT_STATS,
628                                            FIND_ANYWHERE );
629     if( !p_handler )
630     {
631         p_handler = stats_HandlerCreate( p_this );
632         if( !p_handler )
633         {
634             return NULL;
635         }
636         vlc_object_yield( p_handler );
637     }
638     return p_handler;
639 }
640
641 /**
642  * Initialize statistics handler
643  *
644  * This function initializes the global statistics handler singleton,
645  * \param p_this the parent VLC object
646  */
647 static stats_handler_t* stats_HandlerCreate( vlc_object_t *p_this )
648 {
649     stats_handler_t *p_handler;
650
651     msg_Dbg( p_this, "creating statistics handler" );
652
653     p_handler = (stats_handler_t*) vlc_object_create( p_this,
654                                                       VLC_OBJECT_STATS );
655
656     if( !p_handler )
657     {
658         msg_Err( p_this, "out of memory" );
659         return NULL;
660     }
661     p_handler->i_counters = 0;
662     p_handler->pp_counters = NULL;
663
664     /// \bug is it p_vlc or p_libvlc ?
665     vlc_object_attach( p_handler, p_this->p_vlc );
666
667     return p_handler;
668 }
669
670 static void TimerDump( vlc_object_t *p_obj, counter_t *p_counter,
671                        vlc_bool_t b_total )
672 {
673     mtime_t last, total;
674     int i_total;
675     if( !p_counter || p_counter->i_samples != 2 )
676     {
677         msg_Err( p_obj, "timer %s does not exist", p_counter->psz_name );
678         return;
679     }
680     i_total = p_counter->pp_samples[1]->value.i_int;
681     total = p_counter->pp_samples[1]->date;
682     if( p_counter->pp_samples[0]->value.b_bool == VLC_TRUE )
683     {
684         last = mdate() - p_counter->pp_samples[0]->date;
685         i_total += 1;
686         total += last;
687     }
688     else
689     {
690         last = p_counter->pp_samples[0]->date;
691     }
692     if( b_total )
693     {
694         msg_Dbg( p_obj,
695              "TIMER %s : %.3f ms - Total %.3f ms / %i intvls (Avg %.3f ms)",
696              p_counter->psz_name, (float)last/1000, (float)total/1000, i_total,
697              (float)(total)/(1000*(float)i_total ) );
698     }
699     else
700     {
701         msg_Dbg( p_obj,
702              "TIMER %s : Total %.3f ms / %i intvls (Avg %.3f ms)",
703              p_counter->psz_name, (float)total/1000, i_total,
704              (float)(total)/(1000*(float)i_total ) );
705     }
706 }