Tracer API

Collaboration diagram for Tracer API:

Macros
#define	vlc_tracer_TraceWithTs(tracer, ts, ...)
#define	vlc_tracer_Trace(tracer, ...)
#define	VLC_TRACE_END    vlc_tracer_entry_FromString(NULL, NULL)
#define	VLC_TRACE(key, value)
#define	VLC_TRACE_TICK_NS(key, tick)

Functions
struct vlc_tracer *	vlc_tracer_Create (vlc_object_t *parent, const char *name)
	Create a tracer object.
void	vlc_tracer_Destroy (struct vlc_tracer *tracer)
	Destroy a tracer object.
void	vlc_tracer_TraceWithTs (struct vlc_tracer *tracer, vlc_tick_t ts, const struct vlc_tracer_trace *trace)
	Emit traces.
static struct vlc_tracer_entry	vlc_tracer_entry_FromInt (const char *key, int64_t value)
static struct vlc_tracer_entry	vlc_tracer_entry_FromUnsigned (const char *key, uint64_t value)
static struct vlc_tracer_entry	vlc_tracer_entry_FromDouble (const char *key, double value)
static struct vlc_tracer_entry	vlc_tracer_entry_FromString (const char *key, const char *value)

Detailed Description

Macro Definition Documentation

VLC_TRACE

#define VLC_TRACE	(		key,
			value )

Value:

        _Generic((value), \
        uint64_t: vlc_tracer_entry_FromUnsigned, \
        int64_t: vlc_tracer_entry_FromInt, \
        double: vlc_tracer_entry_FromDouble, \
        char *: vlc_tracer_entry_FromString, \
        const char *: vlc_tracer_entry_FromString) (key, value)

Referenced by EsOutVaControlLocked(), EsOutVaPrivControlLocked(), RenderPicture(), stream_HandleDrift(), TraceRender(), vlc_clock_master_update_coeff(), vlc_input_decoder_DecodeWithStatus(), vlc_tracer_TraceEvent(), vlc_tracer_TracePCR(), vlc_tracer_TraceStreamDTS(), and vlc_tracer_TraceStreamPTS().

VLC_TRACE_END

#define VLC_TRACE_END    vlc_tracer_entry_FromString(NULL, NULL)

Referenced by EsOutVaControlLocked(), EsOutVaPrivControlLocked(), RenderPicture(), stream_HandleDrift(), TraceRender(), vlc_clock_master_update_coeff(), vlc_input_decoder_DecodeWithStatus(), vlc_tracer_TraceEvent(), vlc_tracer_TracePCR(), vlc_tracer_TraceStreamDTS(), and vlc_tracer_TraceStreamPTS().

VLC_TRACE_TICK_NS

#define VLC_TRACE_TICK_NS	(		key,
			tick )

Value:

VLC_TRACE((key), NS_FROM_VLC_TICK((tick)))

Referenced by EsOutVaControlLocked(), EsOutVaPrivControlLocked(), RenderPicture(), stream_HandleDrift(), TraceRender(), vlc_clock_master_update_coeff(), vlc_tracer_TracePCR(), vlc_tracer_TraceStreamDTS(), and vlc_tracer_TraceStreamPTS().

vlc_tracer_Trace

#define vlc_tracer_Trace	(		tracer,
			... )

Value:

    vlc_tracer_TraceWithTs(tracer, vlc_tick_now(), __VA_ARGS__)

Referenced by EsOutVaControlLocked(), EsOutVaPrivControlLocked(), stream_HandleDrift(), TraceRender(), vlc_clock_master_update_coeff(), vlc_input_decoder_DecodeWithStatus(), vlc_tracer_TraceEvent(), vlc_tracer_TracePCR(), vlc_tracer_TraceStreamDTS(), and vlc_tracer_TraceStreamPTS().

vlc_tracer_TraceWithTs

#define vlc_tracer_TraceWithTs	(		tracer,
			ts,
			... )

Value:

    (vlc_tracer_TraceWithTs)(tracer, ts, &(const struct vlc_tracer_trace) { \
        .entries = (const struct vlc_tracer_entry[]) { \
            __VA_ARGS__ \
        } \
    })

Referenced by RenderPicture(), and TraceRender().

Function Documentation

vlc_tracer_Create()

struct vlc_tracer * vlc_tracer_Create	(	vlc_object_t *	parent,
		const char *	name )

Create a tracer object.

Note

This function is for advanced debugging/testing. Use vlc_object_get_tracer() to get the existing tracer.

Parameters

parent	parent object used to create the tracer
name	module to load or NULL for the default one

Returns

a valid tracer or NULL in case of error

References unlikely, vlc_module_load(), VLC_OBJECT, vlc_object_delete, vlc_object_logger, and vlc_tracer_load().

Referenced by libvlc_InternalInit().

vlc_tracer_Destroy()

void vlc_tracer_Destroy

(

struct vlc_tracer *

tracer

)

Destroy a tracer object.

References container_of, vlc_tracer_operations::destroy, vlc_tracer::ops, vlc_tracer_module::tracer, VLC_OBJECT, and vlc_object_delete.

Referenced by libvlc_InternalCleanup().

vlc_tracer_entry_FromDouble()

struct vlc_tracer_entry vlc_tracer_entry_FromDouble ( const char * key, double value )

inlinestatic

References vlc_tracer_entry::key, vlc_tracer_entry::value, VLC_TRACER_DOUBLE, and vlc_tracer_entry_FromDouble().

Referenced by vlc_tracer_entry_FromDouble().

vlc_tracer_entry_FromInt()

struct vlc_tracer_entry vlc_tracer_entry_FromInt ( const char * key, int64_t value )

inlinestatic

References vlc_tracer_value_t::integer, vlc_tracer_entry::key, vlc_tracer_entry::value, vlc_tracer_entry_FromInt(), and VLC_TRACER_INT.

Referenced by vlc_tracer_entry_FromInt().

vlc_tracer_entry_FromString()

struct vlc_tracer_entry vlc_tracer_entry_FromString ( const char * key, const char * value )

inlinestatic

References vlc_tracer_entry::key, vlc_tracer_value_t::string, vlc_tracer_entry::value, vlc_tracer_entry_FromString(), and VLC_TRACER_STRING.

Referenced by vlc_tracer_entry_FromString().

vlc_tracer_entry_FromUnsigned()

struct vlc_tracer_entry vlc_tracer_entry_FromUnsigned ( const char * key, uint64_t value )

inlinestatic

References vlc_tracer_entry::key, vlc_tracer_value_t::uinteger, vlc_tracer_entry::value, vlc_tracer_entry_FromUnsigned(), and VLC_TRACER_UINT.

Referenced by vlc_tracer_entry_FromUnsigned().

vlc_tracer_TraceWithTs()

void vlc_tracer_TraceWithTs	(	struct vlc_tracer *	tracer,
		vlc_tick_t	ts,
		const struct vlc_tracer_trace *	trace )

Emit traces.

Parameters

tracer	tracer emitting the traces
ts	timestamp of the current trace
trace	the trace to register with its list of key / value parameters. Key must be a not NULL string. Value has to be defined with one of the type defined in the vlc_tracer_entry union.

References container_of, vlc_tracer_module::opaque, vlc_tracer::ops, vlc_tracer_operations::trace, and vlc_tracer_module::tracer.