------------------------------------------------------------------------------
-- GtkAda - Ada95 binding for Gtk+/Gnome --
-- --
-- Copyright (C) 2003-2014, AdaCore --
-- --
-- This library is free software; you can redistribute it and/or modify it --
-- under terms of the GNU General Public License as published by the Free --
-- Software Foundation; either version 3, or (at your option) any later --
-- version. This library is distributed in the hope that it will be useful, --
-- but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHAN- --
-- TABILITY or FITNESS FOR A PARTICULAR PURPOSE. --
-- --
-- As a special exception under Section 7 of GPL version 3, you are granted --
-- additional permissions described in the GCC Runtime Library Exception, --
-- version 3.1, as published by the Free Software Foundation. --
-- --
-- You should have received a copy of the GNU General Public License and --
-- a copy of the GCC Runtime Library Exception along with this program; --
-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
-- <http://www.gnu.org/licenses/>. --
-- --
------------------------------------------------------------------------------
-- <description>
-- This package provides low level routines for enabling, disabling
-- and modifying the way log messages are handled in glib/gdk/gtk.
-- </description>
-- <group>Glib, the general-purpose library</group>
package Glib.Messages is
pragma Preelaborate;
type Log_Level_Flags is mod 2 ** 32;
-- log levels and flags.
---------------
-- log flags --
---------------
Log_Flag_Recursion : constant Log_Level_Flags := 2 ** 0;
Log_Flag_Fatal : constant Log_Level_Flags := 2 ** 1;
----------------
-- log levels --
----------------
Log_Level_Error : constant Log_Level_Flags := 2 ** 2;
-- always fatal
Log_Level_Critical : constant Log_Level_Flags := 2 ** 3;
Log_Level_Warning : constant Log_Level_Flags := 2 ** 4;
Log_Level_Message : constant Log_Level_Flags := 2 ** 5;
Log_Level_Info : constant Log_Level_Flags := 2 ** 6;
Log_Level_Debug : constant Log_Level_Flags := 2 ** 7;
Log_Level_Mask : constant Log_Level_Flags :=
not (Log_Flag_Recursion or Log_Flag_Fatal);
Log_Fatal_Mask : constant Log_Level_Flags :=
Log_Flag_Recursion or Log_Level_Error;
-- log levels that are considered fatal by default
type Log_Function is access procedure
(Log_Domain : String;
Log_Level : Log_Level_Flags;
Message : UTF8_String);
type Log_Handler_Id is new Guint;
-- Logging mechanism
function Log_Set_Handler
(Log_Domain : String;
Log_Levels : Log_Level_Flags;
Log_Func : Log_Function) return Log_Handler_Id;
-- Set a log function for the given log levels, and return its id.
procedure Log_Remove_Handler
(Log_Domain : String;
Handler_Id : Log_Handler_Id);
-- Unset a given handler.
procedure Log_Default_Handler
(Log_Domain : String;
Log_Levels : Log_Level_Flags;
Message : UTF8_String);
-- The default log handler.
-- Can be called e.g. within a user defined log handler.
procedure Log
(Log_Domain : String;
Log_Levels : Log_Level_Flags;
Message : UTF8_String);
-- Log a message through the glib logging facility.
function Log_Set_Fatal_Mask
(Log_Domain : String;
Fatal_Mask : Log_Level_Flags) return Log_Level_Flags;
-- Set the level at which messages are considered fatal for a given domain.
function Log_Set_Always_Fatal
(Fatal_Mask : Log_Level_Flags) return Log_Level_Flags;
-- Set the level at which messages are considered fatal for any domain.
private
pragma Import (C, Log_Set_Always_Fatal, "g_log_set_always_fatal");
end Glib.Messages;