![]() |
![]() |
![]() |
Grilo Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <grilo.h> GrlLogDomain; enum GrlLogLevel; #define GRL_LOG (domain, level, ...) #define GRL_LOG_DOMAIN (domain) extern GrlLogDomain *GRL_LOG_DOMAIN_DEFAULT; #define GRL_LOG_DOMAIN_EXTERN (domain) #define GRL_LOG_DOMAIN_FREE (domain) #define GRL_LOG_DOMAIN_INIT (domain, name) #define GRL_LOG_DOMAIN_STATIC (domain) #define GRL_DEBUG (...) #define GRL_ERROR (...) #define GRL_INFO (...) #define GRL_MESSAGE (...) #define GRL_WARNING (...) void grl_log (GrlLogDomain *domain
,GrlLogLevel level
,const gchar *strloc
,const gchar *format
,...
); void grl_log_configure (const gchar *config
); void grl_log_domain_free (GrlLogDomain *domain
); GrlLogDomain * grl_log_domain_new (const gchar *name
);
typedef enum { GRL_LOG_LEVEL_NONE, GRL_LOG_LEVEL_ERROR, GRL_LOG_LEVEL_WARNING, GRL_LOG_LEVEL_MESSAGE, GRL_LOG_LEVEL_INFO, GRL_LOG_LEVEL_DEBUG, GRL_LOG_LEVEL_LAST } GrlLogLevel;
Grilo log levels. Defines the level of verbosity selected in Grilo.
#define GRL_LOG(domain, level, ...)
Outputs a debugging message. This is the most general macro for outputting debugging messages. You will probably want to use one of the ones described below.
|
the log domain to use |
|
the severity of the message |
|
A printf-style message to output |
#define GRL_LOG_DOMAIN(domain) GrlLogDomain *domain = NULL
Defines a GrlLogDomain variable.
|
the log domain |
#define GRL_LOG_DOMAIN_EXTERN(domain) extern GrlLogDomain *domain
Declares a GrlLogDomain variable as extern. Use in header files.
|
the log domain |
#define GRL_LOG_DOMAIN_FREE(domain)
Free a previously allocated GrlLogDomain.
|
the log domain to free. |
#define GRL_LOG_DOMAIN_INIT(domain, name)
Creates a new GrlLogDomain with the given name.
|
the log domain to initialize. |
|
the name of the log domain. |
#define GRL_LOG_DOMAIN_STATIC(domain) static GrlLogDomain *domain = NULL
Defines a static GrlLogDomain variable.
|
the log domain |
#define GRL_DEBUG(...)
Output a debugging message in the default log domain.
|
printf-style message to output |
#define GRL_ERROR(...)
Output an error message in the default log domain.
|
printf-style message to output |
#define GRL_INFO(...)
Output an informational message in the default log domain.
|
printf-style message to output |
#define GRL_MESSAGE(...)
Output a logging message in the default log domain.
|
printf-style message to output |
#define GRL_WARNING(...)
Output a warning message in the default log domain.
|
printf-style message to output |
void grl_log (GrlLogDomain *domain
,GrlLogLevel level
,const gchar *strloc
,const gchar *format
,...
);
Send a log message.
|
a domain |
|
log level |
|
string, usually line of code where function is invoked |
|
log message |
|
parameters to insert in the log message |
Since 0.1.7
void grl_log_configure (const gchar *config
);
Configure a set of log domains. The default configuration is to display warning and error messages only for all the log domains.
The configuration string follows the following grammar:
1 2 3 4 5 6 |
config-list: config | config ',' config-list config: domain ':' level domain: '*' | [a-zA-Z0-9]+ level: '*' | '-' | named-level | num-level named-level: "none" | "error" | "warning" | "message" | "info" | "debug" num-level: [0-5] |
examples:
"*:*": maximum verbosity for all the log domains
"*:-": don't print any message
"media-source:debug,metadata-source:debug": prints debug, info, message warning and error messages for the media-source and metadata-source log domains
|
A string describing the wanted log configuration |
Since 0.1.7
void grl_log_domain_free (GrlLogDomain *domain
);
Releases domain
.
|
a GrlLogDomain |
Since 0.1.7
GrlLogDomain * grl_log_domain_new (const gchar *name
);
|
The name for the new log domain |
Returns : |
The new log domain |
Since 0.1.7