![]() |
![]() |
![]() |
telepathy-logger Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#define TPL_CONF_ERROR enum TplConfError; TplConf * tpl_conf_dup (void); GConfClient * tpl_conf_get_gconf_client (TplConf *self); gboolean tpl_conf_is_globally_enabled (TplConf *self, GError **error); gboolean tpl_conf_is_account_ignored (TplConf *self, const gchar *account_path, GError **error); GSList * tpl_conf_get_accounts_ignorelist (TplConf *self, GError **error); void tpl_conf_globally_enable (TplConf *self, gboolean enable, GError **error); void tpl_conf_set_accounts_ignorelist (TplConf *self, GSList *newlist, GError **error);
typedef enum { /* generic error */ TPL_CONF_ERROR_FAILED, /* GCONF KEY ERROR */ TPL_CONF_ERROR_GCONF_KEY } TplConfError;
TplConf * tpl_conf_dup (void);
Convenience function to obtain a TPL Configuration object, which is a singleton.
Returns : |
a TplConf signleton instance with its reference counter incremented. Remember to unref the counter. |
GConfClient * tpl_conf_get_gconf_client (TplConf *self);
You probably won't need to and anyway you shoudln't access directly the GConf client. In case you *really* need, remember to ref/unref properly.
|
TplConf instance |
Returns : |
an GConfClient instance, owned by the TplConfInstance. |
gboolean tpl_conf_is_globally_enabled (TplConf *self, GError **error);
Wether TPL is globally enabled or not. If it's not globally enabled, no
signals will be logged at all.
To enable/disable a single account use tpl_conf_set_accounts_ignorelist()
gboolean tpl_conf_is_account_ignored (TplConf *self, const gchar *account_path, GError **error);
Wether account_path
is enabled or disable (aka ignored).
GSList * tpl_conf_get_accounts_ignorelist (TplConf *self, GError **error);
The list of ignored accounts. If an account is ignored, no signals for this account will be logged.
void tpl_conf_globally_enable (TplConf *self, gboolean enable, GError **error);
Globally enables or disables logging for TPL. If it's globally disabled, no signals will be logged at all. Note that this will change the global TPL configuration, affecting all the TPL instances, including the TPL logging process and all the clients using libtelepathy-logger.
|
a TplConf instance |
|
wether to globally enable or globally disable logging. |
|
memory adress where to store a GError, in case of error, or NULL
to ignore error reporting.
|
void tpl_conf_set_accounts_ignorelist (TplConf *self, GSList *newlist, GError **error);
Globally disables logging for newlist
account's path. If an account is
disabled, no signals for such account will be logged.
Note that this will change the global TPL configuration, affecting all the TPL instances, including the TPL logging process and all the clients using libtelepathy-logger.
|
a TplConf instance |
|
a new GList containing account's object paths (gchar *) to be ignored |
|
memory adress where to store a GError, in case of error, or NULL
to ignore error reporting.
|