Typedefs
typedef enum sr_error_e	sr_error_t
	Sysrepo error codes. More...

typedef void(*	sr_log_cb )(sr_log_level_t level, const char *message)
	Sets callback that will be called when a log entry would be populated. More...

Enumerations
enum	sr_error_e { SR_ERR_OK = 0, SR_ERR_INVAL_ARG, SR_ERR_LY, SR_ERR_SYS, SR_ERR_NOMEM, SR_ERR_NOT_FOUND, SR_ERR_EXISTS, SR_ERR_INTERNAL, SR_ERR_UNSUPPORTED, SR_ERR_VALIDATION_FAILED, SR_ERR_OPERATION_FAILED, SR_ERR_UNAUTHORIZED, SR_ERR_LOCKED, SR_ERR_TIME_OUT, SR_ERR_CALLBACK_FAILED, SR_ERR_CALLBACK_SHELVE }
	Sysrepo error codes. More...

enum	sr_log_level_t { SR_LL_NONE = 0, SR_LL_ERR, SR_LL_WRN, SR_LL_INF, SR_LL_DBG }
	Log levels used to determine if message of certain severity should be printed. More...

Functions
const char *	sr_strerror (int err_code)
	Returns the error message corresponding to the error code. More...

void	sr_log_stderr (sr_log_level_t log_level)
	Enables / disables / changes log level (verbosity) of logging to standard error output. More...

sr_log_level_t	sr_log_get_stderr (void)
	Learn current standard error output log level. More...

void	sr_log_syslog (const char *app_name, sr_log_level_t log_level)
	Enables / disables / changes log level (verbosity) of logging to system log. More...

sr_log_level_t	sr_log_get_syslog (void)
	Learn current system log log level. More...

void	sr_log_set_cb (sr_log_cb log_callback)
	Sets callback that will be called when a log entry would be populated. Callback will be called for every message regardless of any log level. More...

Detailed Description

Typedef Documentation

typedef enum sr_error_e sr_error_t

Sysrepo error codes.

typedef void(* sr_log_cb)(sr_log_level_t level, const char *message)

Sets callback that will be called when a log entry would be populated.

Parameters

[in]	level	Verbosity level of the log entry.
[in]	message	Message of the log entry.

Definition at line 145 of file sysrepo.h.

Enumeration Type Documentation

enum sr_error_e

Sysrepo error codes.

Enumerator
SR_ERR_OK	No error.
SR_ERR_INVAL_ARG	Invalid argument.
SR_ERR_LY	Error generated by libyang.
SR_ERR_SYS	System function call failed.
SR_ERR_NOMEM	Not enough memory.
SR_ERR_NOT_FOUND	Item not found.
SR_ERR_EXISTS	Item already exists.
SR_ERR_INTERNAL	Other internal error.
SR_ERR_UNSUPPORTED	Unsupported operation requested.
SR_ERR_VALIDATION_FAILED	Validation of the changes failed.
SR_ERR_OPERATION_FAILED	An operation failed.
SR_ERR_UNAUTHORIZED	Operation not authorized.
SR_ERR_LOCKED	Requested resource is already locked.
SR_ERR_TIME_OUT	Time out has expired.
SR_ERR_CALLBACK_FAILED	User callback failure caused the operation to fail.
SR_ERR_CALLBACK_SHELVE	User callback has not processed the event and will do so on some future event processing.

Definition at line 52 of file sysrepo.h.

enum sr_log_level_t

Log levels used to determine if message of certain severity should be printed.

Enumerator
SR_LL_NONE	Do not print any messages.
SR_LL_ERR	Print only error messages.
SR_LL_WRN	Print error and warning messages.
SR_LL_INF	Besides errors and warnings, print some other informational messages.
SR_LL_DBG	Print all messages including some development debug messages.

Definition at line 83 of file sysrepo.h.

Function Documentation

const char* sr_strerror ( int err_code )

Returns the error message corresponding to the error code.

Parameters

[in] err_code Error code.

Returns: Error message (statically allocated, do not free).

void sr_log_stderr ( sr_log_level_t log_level )

Enables / disables / changes log level (verbosity) of logging to standard error output.

By default, logging to stderr is disabled. Setting log level to any value other than SR_LL_NONE enables the logging to stderr. Setting log level back to SR_LL_NONE disables the logging to stderr.

Note: Please note that this will overwrite your libyang logging settings. Also, only libyang errors are printed, if enabled.

Parameters

[in] log_level Requested log level (verbosity).

sr_log_level_t sr_log_get_stderr ( void )

Learn current standard error output log level.

Returns: stderr log level.

void sr_log_syslog	(	const char *	app_name,
		sr_log_level_t	log_level
	)

Enables / disables / changes log level (verbosity) of logging to system log.

By default, logging into syslog is disabled. Setting log level to any value other than SR_LL_NONE enables the logging into syslog. Setting log level back to SR_LL_NONE disables the logging into syslog.

Library messages are logged with LOG_USER facility and plugin (syrepo-plugind) messages are logged with LOG_DAEMON facility.

Note: Please note that enabling logging into syslog will overwrite your syslog connection settings (calls openlog), if you are connected to syslog already and also libyang logging settings.

Parameters

[in]	app_name	Name of the application. If not set, "sysrepo" will be used.
[in]	log_level	Requested log level (verbosity).

sr_log_level_t sr_log_get_syslog ( void )

Learn current system log log level.

Returns: syslog log level.

void sr_log_set_cb ( sr_log_cb log_callback )

Sets callback that will be called when a log entry would be populated. Callback will be called for every message regardless of any log level.

Parameters

[in] log_callback Callback to be called when a log entry would populated.

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

Enumeration Type Documentation

Function Documentation