1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109
|
------------------------------------------------------------------------------
-- GtkAda - Ada95 binding for Gtk+/Gnome --
-- --
-- Copyright (C) 2003-2018, 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;
|