.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "Glib::Log 3"
.TH Glib::Log 3 2025-07-13 "perl v5.42.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Glib::Log \-  A flexible logging mechanism
.SH METHODS
.IX Header "METHODS"
.SS "scalar = Glib::Log\->\fBset_always_fatal\fP ($fatal_mask)"
.IX Subsection "scalar = Glib::Log->set_always_fatal ($fatal_mask)"
.IP \(bu 4
\&\f(CW$fatal_mask\fR (scalar)
.ie n .SS "Glib\->\fBcritical\fP ($domain, $message)"
.el .SS "Glib\->\fBcritical\fP ($domain, \f(CW$message\fP)"
.IX Subsection "Glib->critical ($domain, $message)"
.IP \(bu 4
\&\f(CW$domain\fR (string or undef)
.IP \(bu 4
\&\f(CW$message\fR (string)
.ie n .SS "Glib\->\fBdebug\fP ($domain, $message)"
.el .SS "Glib\->\fBdebug\fP ($domain, \f(CW$message\fP)"
.IX Subsection "Glib->debug ($domain, $message)"
.IP \(bu 4
\&\f(CW$domain\fR (string or undef)
.IP \(bu 4
\&\f(CW$message\fR (string)
.ie n .SS "Glib::Log::default_handler ($log_domain, $log_level, $message, ...)"
.el .SS "Glib::Log::default_handler ($log_domain, \f(CW$log_level\fP, \f(CW$message\fP, ...)"
.IX Subsection "Glib::Log::default_handler ($log_domain, $log_level, $message, ...)"
.IP \(bu 4
\&\f(CW$log_domain\fR (string)
.IP \(bu 4
\&\f(CW$log_level\fR (scalar)
.IP \(bu 4
\&\f(CW$message\fR (string)
.IP \(bu 4
\&... (list) possible "userdata" argument ignored
.PP
The arguments are the same as taken by the function for set_handler or
set_default_handler.
.ie n .SS "prev_log_func = Glib::Log\->\fBset_default_handler\fP ($log_func, $user_data)"
.el .SS "prev_log_func = Glib::Log\->\fBset_default_handler\fP ($log_func, \f(CW$user_data\fP)"
.IX Subsection "prev_log_func = Glib::Log->set_default_handler ($log_func, $user_data)"
.IP \(bu 4
\&\f(CW$log_func\fR (subroutine) handler function or undef
.IP \(bu 4
\&\f(CW$user_data\fR (scalar)
.PP
Install log_func as the default log handler.  log_func is called for
anything which doesn\*(Aqt otherwise have a handler (either
Glib::Log\->set_handler, or the Glib::xsapi
gperl_handle_logs_for),
.PP
.Vb 1
\&    &$log_func ($log_domain, $log_levels, $message, $user_data)
.Ve
.PP
where \f(CW$log_domain\fR is a string, and \f(CW$log_levels\fR is a
Glib::LogLevelFlags of level and flags being reported.
.PP
If log_func is \e&Glib::Log::default_handler or undef then Glib\*(Aqs
default handler is set.
.PP
The return value from \f(CW\*(C`set_default_handler\*(C'\fR is the previous handler.
This is \e&Glib::Log::default_handler for Glib\*(Aqs default, otherwise a
Perl function previously installed.  If the handler is some other
non\-Perl function then currently the return is undef, but perhaps that
will change to some wrapped thing, except that without associated
userdata there\*(Aqs very little which could be done with it (it couldn\*(Aqt
be reinstalled later without its userdata).
.PP
Since: glib 2.6
.ie n .SS "Glib\->\fBerror\fP ($domain, $message)"
.el .SS "Glib\->\fBerror\fP ($domain, \f(CW$message\fP)"
.IX Subsection "Glib->error ($domain, $message)"
.IP \(bu 4
\&\f(CW$domain\fR (string or undef)
.IP \(bu 4
\&\f(CW$message\fR (string)
.ie n .SS "scalar = Glib::Log\->\fBset_fatal_mask\fP ($log_domain, $fatal_mask)"
.el .SS "scalar = Glib::Log\->\fBset_fatal_mask\fP ($log_domain, \f(CW$fatal_mask\fP)"
.IX Subsection "scalar = Glib::Log->set_fatal_mask ($log_domain, $fatal_mask)"
.IP \(bu 4
\&\f(CW$log_domain\fR (string)
.IP \(bu 4
\&\f(CW$fatal_mask\fR (scalar)
.ie n .SS "integer = Glib::Log\->\fBset_handler\fP ($log_domain, $log_levels, $log_func, $user_data=undef)"
.el .SS "integer = Glib::Log\->\fBset_handler\fP ($log_domain, \f(CW$log_levels\fP, \f(CW$log_func\fP, \f(CW$user_data\fP=undef)"
.IX Subsection "integer = Glib::Log->set_handler ($log_domain, $log_levels, $log_func, $user_data=undef)"
.IP \(bu 4
\&\f(CW$log_domain\fR (string or undef) name of the domain to handle with this callback.
.IP \(bu 4
\&\f(CW$log_levels\fR (Glib::LogLevelFlags) log levels to handle with this callback
.IP \(bu 4
\&\f(CW$log_func\fR (subroutine) handler function
.IP \(bu 4
\&\f(CW$user_data\fR (scalar)
.PP
\&\f(CW$log_func\fR will be called as
.PP
.Vb 1
\&    &$log_func ($log_domain, $log_levels, $message, $user_data);
.Ve
.PP
where \f(CW$log_domain\fR is the name requested and \f(CW$log_levels\fR is a
Glib::LogLevelFlags of level and flags being reported.
.ie n .SS "Glib\->\fBinfo\fP ($domain, $message)"
.el .SS "Glib\->\fBinfo\fP ($domain, \f(CW$message\fP)"
.IX Subsection "Glib->info ($domain, $message)"
.IP \(bu 4
\&\f(CW$domain\fR (string or undef)
.IP \(bu 4
\&\f(CW$message\fR (string)
.ie n .SS "Glib\->\fBlog\fP ($log_domain, $log_level, $message)"
.el .SS "Glib\->\fBlog\fP ($log_domain, \f(CW$log_level\fP, \f(CW$message\fP)"
.IX Subsection "Glib->log ($log_domain, $log_level, $message)"
.IP \(bu 4
\&\f(CW$log_domain\fR (string or undef)
.IP \(bu 4
\&\f(CW$log_level\fR (scalar)
.IP \(bu 4
\&\f(CW$message\fR (string)
.ie n .SS "Glib\->\fBmessage\fP ($domain, $message)"
.el .SS "Glib\->\fBmessage\fP ($domain, \f(CW$message\fP)"
.IX Subsection "Glib->message ($domain, $message)"
.IP \(bu 4
\&\f(CW$domain\fR (string or undef)
.IP \(bu 4
\&\f(CW$message\fR (string)
.ie n .SS "Glib::Log\->\fBremove_handler\fP ($log_domain, $handler_id)"
.el .SS "Glib::Log\->\fBremove_handler\fP ($log_domain, \f(CW$handler_id\fP)"
.IX Subsection "Glib::Log->remove_handler ($log_domain, $handler_id)"
.IP \(bu 4
\&\f(CW$log_domain\fR (string or undef)
.IP \(bu 4
\&\f(CW$handler_id\fR (integer) as returned by \f(CW\*(C`set_handler\*(C'\fR
.ie n .SS "Glib\->\fBwarning\fP ($domain, $message)"
.el .SS "Glib\->\fBwarning\fP ($domain, \f(CW$message\fP)"
.IX Subsection "Glib->warning ($domain, $message)"
.IP \(bu 4
\&\f(CW$domain\fR (string or undef)
.IP \(bu 4
\&\f(CW$message\fR (string)
.SH "ENUMS AND FLAGS"
.IX Header "ENUMS AND FLAGS"
.SS "flags Glib::LogLevelFlags"
.IX Subsection "flags Glib::LogLevelFlags"
.IP \(bu 4
\&\*(Aqrecursion\*(Aq / \*(AqG_LOG_FLAG_RECURSION\*(Aq
.IP \(bu 4
\&\*(Aqfatal\*(Aq / \*(AqG_LOG_FLAG_FATAL\*(Aq
.IP \(bu 4
\&\*(Aqerror\*(Aq / \*(AqG_LOG_LEVEL_ERROR\*(Aq
.IP \(bu 4
\&\*(Aqcritical\*(Aq / \*(AqG_LOG_LEVEL_CRITICAL\*(Aq
.IP \(bu 4
\&\*(Aqwarning\*(Aq / \*(AqG_LOG_LEVEL_WARNING\*(Aq
.IP \(bu 4
\&\*(Aqmessage\*(Aq / \*(AqG_LOG_LEVEL_MESSAGE\*(Aq
.IP \(bu 4
\&\*(Aqinfo\*(Aq / \*(AqG_LOG_LEVEL_INFO\*(Aq
.IP \(bu 4
\&\*(Aqdebug\*(Aq / \*(AqG_LOG_LEVEL_DEBUG\*(Aq
.IP \(bu 4
\&\*(Aqfatal\-mask\*(Aq / \*(AqG_LOG_FATAL_MASK\*(Aq
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Glib
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2003\-2011 by the gtk2\-perl team.
.PP
This software is licensed under the LGPL.  See Glib for a full notice.