afw_trace.h

Go to the documentation of this file.

// See the 'COPYING' file in the project root for licensing information.
/*
 * Adaptive Framework Software Trace Header
 *
 * Copyright (c) 2010-2023 Clemson University
 *
 */
 
#ifndef __AFW_TRACE_H__
#define __AFW_TRACE_H__
 
#include "afw_interface.h"
 
AFW_BEGIN_DECLARES
 
#define AFW_TRACE_STATIC_TRACE_ID(label, trace_id) \
static const afw_interface_implementation_rti_t label = \
    {"afw_trace_id", __FILE__, trace_id};
 
 
#define afw_trace(trace_level, flag_index, instance, message, xctx) \
    if ((flag_index) < (xctx)->flags_count && (xctx)->flags[flag_index]) \
        afw_trace_write( \
            afw_log_priority_trace##trace_level, \
            ((instance) ? \
                &((const afw_instance_t *)instance)->inf->rti \
                : NULL), \
            AFW__FILE_LINE__, message, xctx)
 
 
#define afw_trace_fz(trace_level, flag_index, instance, xctx, format_z, ...) \
    if ((flag_index) < (xctx)->flags_count && (xctx)->flags[flag_index]) \
        afw_trace_write_fz( \
            afw_log_priority_trace##trace_level, \
            ((instance) ? \
                &((const afw_instance_t *)instance)->inf->rti \
                : NULL), \
            AFW__FILE_LINE__, xctx, format_z, __VA_ARGS__)
 
 
#define afw_trace_vz(trace_level, flag_index, instance, format_z, ap, xctx) \
    if ((flag_index) < (xctx)->flags_count && (xctx)->flags[flag_index]) \
        afw_trace_write_vz( \
            afw_log_priority_trace##trace_level, \
            ((instance) ? \
                &((const afw_instance_t *)instance)->inf->rti \
                : NULL), \
            AFW__FILE_LINE__, format_z, ap, xctx)
 
 
#define afw_trace_z(trace_level, flag_index, instance, message_z, xctx) \
    if ((flag_index) < (xctx)->flags_count && (xctx)->flags[flag_index]) \
        afw_trace_write_z( \
            afw_log_priority_trace##trace_level, \
            ((instance) ? \
                &((const afw_instance_t *)instance)->inf->rti \
                : NULL), \
            AFW__FILE_LINE__, message_z, xctx)
 
 
AFW_DECLARE(void)
afw_trace_write(
    afw_log_priority_t priority,
    const afw_interface_implementation_rti_t *rti,
    const afw_utf8_z_t *source_z,
    const afw_utf8_t *message,
    afw_xctx_t *xctx);
 
 
AFW_DECLARE(void)
afw_trace_write_fz(
    afw_log_priority_t priority,
    const afw_interface_implementation_rti_t *rti,
    const afw_utf8_z_t *source_z,
    afw_xctx_t *xctx,
    const afw_utf8_z_t *format_z,
    ...);
 
 
AFW_DECLARE(void)
afw_trace_write_vz(
    afw_log_priority_t priority,
    const afw_interface_implementation_rti_t *rti,
    const afw_utf8_z_t *source_z,
    const afw_utf8_z_t *format_z,
    va_list ap,
    afw_xctx_t *xctx);
 
 
AFW_DECLARE(void)
afw_trace_write_z(
    afw_log_priority_t priority,
    const afw_interface_implementation_rti_t *rti,
    const afw_utf8_z_t *source_z,
    const afw_utf8_z_t *message_z,
    afw_xctx_t *xctx);
 
 
AFW_END_DECLARES
 
#endif /* __AFW_TRACE_H__ */