.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_register_trace_handler" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_register_trace_handler - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro.h>

void al_register_trace_handler(void (*handler)(char const *))
\f[R]
.fi
.SH DESCRIPTION
.PP
Register a callback which is called whenever Allegro writes something to
its log files.
The default logging to allegro.log is disabled while this callback is
active.
Pass NULL to revert to the default logging.
.PP
This function may be called prior to al_install_system.
.PP
See the example allegro5.cfg for documentation on how to configure the
used debug channels, logging levels and trace format.
.SH SINCE
.PP
5.1.5