.\" Automatically generated by Pandoc 2.9.2.1
.\"
.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