![]() |
libsigrok
0.2.2
sigrok hardware access and backend library
|
Controlling the libsigrok message logging functionality. More...
Functions | |
int | sr_log_loglevel_set (int loglevel) |
Set the libsigrok loglevel. More... | |
int | sr_log_loglevel_get (void) |
Get the libsigrok loglevel. More... | |
int | sr_log_logdomain_set (const char *logdomain) |
Set the libsigrok logdomain string. More... | |
char * | sr_log_logdomain_get (void) |
Get the currently configured libsigrok logdomain. More... | |
int | sr_log_callback_set (sr_log_callback_t cb, void *cb_data) |
Set the libsigrok log callback to the specified function. More... | |
int | sr_log_callback_set_default (void) |
Set the libsigrok log callback to the default built-in one. More... | |
Controlling the libsigrok message logging functionality.
int sr_log_callback_set | ( | sr_log_callback_t | cb, |
void * | cb_data | ||
) |
Set the libsigrok log callback to the specified function.
cb | Function pointer to the log callback function to use. Must not be NULL. |
cb_data | Pointer to private data to be passed on. This can be used by the caller to pass arbitrary data to the log functions. This pointer is only stored or passed on by libsigrok, and is never used or interpreted in any way. The pointer is allowed to be NULL if the caller doesn't need/want to pass any data. |
Definition at line 166 of file log.c.
References sr_err, SR_ERR_ARG, and SR_OK.
int sr_log_callback_set_default | ( | void | ) |
char* sr_log_logdomain_get | ( | void | ) |
int sr_log_logdomain_set | ( | const char * | logdomain | ) |
Set the libsigrok logdomain string.
logdomain | The string to use as logdomain for libsigrok log messages from now on. Must not be NULL. The maximum length of the string is 30 characters (this does not include the trailing NUL-byte). Longer strings are silently truncated. In order to not use a logdomain, pass an empty string. The function makes its own copy of the input string, i.e. the caller does not need to keep it around. |
Definition at line 122 of file log.c.
References LOGDOMAIN_MAXLEN, sr_dbg, sr_err, SR_ERR_ARG, and SR_OK.
int sr_log_loglevel_get | ( | void | ) |
int sr_log_loglevel_set | ( | int | loglevel | ) |
Set the libsigrok loglevel.
This influences the amount of log messages (debug messages, error messages, and so on) libsigrok will output. Using SR_LOG_NONE disables all messages.
Note that this function itself will also output log messages. After the loglevel has changed, it will output a debug message with SR_LOG_DBG for example. Whether this message is shown depends on the (new) loglevel.
loglevel | The loglevel to set (SR_LOG_NONE, SR_LOG_ERR, SR_LOG_WARN, SR_LOG_INFO, SR_LOG_DBG, or SR_LOG_SPEW). |
Definition at line 80 of file log.c.
References sr_dbg, sr_err, SR_ERR_ARG, SR_LOG_SPEW, and SR_OK.