Log4g Reference Manual | ||||
---|---|---|---|---|
Top | Description |
Log4gDOMConfigurator; Log4gDOMConfiguratorClass; Log4gConfigurator * log4g_dom_configurator_new (void
); gboolean log4g_dom_configurator_configure (const gchar *uri
,GError **error
);
The DTD is specified in log4g.dtd. The Log4g DTD differs in some small ways from the official Log4j DTD.
Use "appender" everywhere instead of "appender-ref". Appenders may be declared inline to a logger. Appender references simply use a named "appender" tag and do not define a new appender.
Use "property" instead of "param". The keyword "property" was used instead of "param" to reflect the underlying GLib/GObject implementation.
The following configuration provides a cut-and-paste example:
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE log4g:configuration PUBLIC "-//GNOME//DTD LOG4G 1.0//EN" "http://www.gnome.org/log4g/1.0/log4g.dtd"> <log4g:configuration> <appender name="A1" type="Log4gConsoleAppender"> <layout type="Log4gPatternLayout"> <property name="conversion-pattern" value="%-4r [%t] %-5p %c %x - %m%n" /> </layout> </appender> <root> <level value="DEBUG" /> <appender name="A1" /> </root> </log4g:configuration>
In this example all events will be logged to the console appender (stdout by default) using the specified pattern layout.
You may enable internal log messages by setting the LOG4G_FLAGS environment variable to "debug". For example (Bash):
$ export LOG4G_FLAGS=debug
Alternatively you may set the "debug" attribute in the log4g:configuration element:
<log4g:configuration debug="true"> </log4g:configuration>
typedef struct { } Log4gDOMConfigurator;
The Log4gDOMConfigurator structure does not have any public members.
typedef struct { } Log4gDOMConfiguratorClass;
The Log4gDOMConfiguratorClass structure does not have any public members.
Log4gConfigurator * log4g_dom_configurator_new (void
);
Create a new DOM configurator.
Returns : |
A new DOM configurator object. |
Since 0.1
gboolean log4g_dom_configurator_configure (const gchar *uri
,GError **error
);
Configure Log4g by reading a log4g.dtd compliant XML configuration file.
|
A file or URI to load the configuration from. |
|
Returns any error messages. |
Returns : |
TRUE if the configuration was successful, FALSE otherwise.
|
Since 0.1