Index

Package: Policy_DB

Description

package Alog.Policy_DB is
Logging policy database package. This DB stores logging policies. Policies in the database are used inside the framework for logging decisions.

Constants & Global variables

Alog_Default_Level (Alog.Log_Level)

Alog_Default_Level : constant Log_Level := Info;
Framework default loglevel.

No_Ident_Loglevel

No_Ident_Loglevel : exception;
Will be raised if loglevel is not found for a requested identifier.

Subprograms & Entries

Set_Default_Loglevel

procedure Set_Default_Loglevel 
(Level: Log_Level);
Set given loglevel as default loglevel.

Get_Default_Loglevel

function Get_Default_Loglevel return Log_Level;
Return current default loglevel.

Set_Loglevel

procedure Set_Loglevel 
(Identifier: String;
Level: Log_Level);
Set given loglevel for specified identifier string. If the identifier is already present the loglevel is updated. Identifier strings are case-sensitive. Use wildcards to specify a loglevel for a range of identifiers. Identifier hierarchies are separated by dots, the wildcard is '*'. The following example sets a Debug loglevel for all log-identifiers in Foo.Bar (including Foo.Bar). Example: Foo.Bar.* = Debug Direct matches take precedence over wildcard matches. In the following example the loglevel for identifier 'Foo.Bar' is explicitly set to Info. Example: Foo.Bar = Info Foo.Bar.* = Debug

Set_Loglevel

procedure Set_Loglevel 
(Identifiers: Maps.Wildcard_Level_Map);
Apply loglevels for identifiers stored in map.

Get_Loglevel

function Get_Loglevel 
(Identifier: String) return Log_Level;
Return loglevel for given identifier string. Raises No_Ident_Loglevel exception if no entry for given identifier is found (exact match only, no wildcard lookup).

Lookup

function Lookup 
(Identifier: String) return Log_Level;
Return loglevel for given identifier string. Returns the closest match, if no associated loglevel is found the default loglevel is returned.

Reset

procedure Reset;
Reset the logging policy database to the initial state.

Accept_Src

function Accept_Src 
(Identifier: String := "";
Level: Log_Level) return Boolean;
Returns True if the given loglevel is accepted for a source identifier. If no identifier is given, the loglevel is verified against the default loglevel.

Accept_Dst

function Accept_Dst 
(Identifier: String;
Level: Log_Level) return Boolean;
Returns True if the given loglevel is accepted for a destination identifier. If no match for the given identifier is found True is returned.