Client

NETCONF client functionality. More...

Modules
	Client Messages
	Functions to create NETCONF RPCs (or actions) and process replies received from the server.
	Client Session
	Client-side NETCONF session manipulation.
	Client SSH
	Client-side settings for SSH connections.
	Client TLS
	Client-side settings for TLS connections.
	Client-side Call Home
	Call Home functionality for client-side applications.

Functions
int	nc_client_set_schema_searchpath (const char *path)
	Set location where libnetconf tries to search for YANG/YIN schemas. More...
const char *	nc_client_get_schema_searchpath (void)
	Get schema searchpath that was set by nc_client_set_schema_searchpath(). More...
int	nc_client_set_schema_callback (ly_module_imp_clb clb, void *user_data)
	Set callback function to get missing schemas. More...
ly_module_imp_clb	nc_client_get_schema_callback (void **user_data)
	Get callback function used to get missing schemas. More...
void	nc_client_set_thread_context (void *context)
	Use the provided thread-specific client's context in the current thread. More...
void *	nc_client_get_thread_context (void)
	Get thread-specific client context for sharing with some other thread using nc_client_set_thread_context(). More...
void	nc_client_init (void)
	Initialize libssh and/or libssl/libcrypto for use in the client. More...
void	nc_client_destroy (void)
	Destroy all libssh and/or libssl/libcrypto dynamic memory and the client options, for both SSH and TLS, and for Call Home too. More...

Detailed Description

NETCONF client functionality.

Function Documentation

int nc_client_set_schema_searchpath

(

const char *

path

)

Set location where libnetconf tries to search for YANG/YIN schemas.

The location is searched when connecting to a NETCONF server and building YANG context for further processing of the NETCONF messages and data.

The searchpath is also used to store schemas retreived via <get-schema> operation - if the schema is not found in searchpath neither via schema callback provided via nc_client_set_schema_callback() and server supports the NETCONF <get-schema> operation, the schema is retrieved this way and stored into the searchpath (if specified).

Parameters

[in]

path

Directory where to search for YANG/YIN schemas.

Returns

0 on success, 1 on (memory allocation) failure.

const char* nc_client_get_schema_searchpath

(

void

)

Get schema searchpath that was set by nc_client_set_schema_searchpath().

Returns

Schema searchpath directory, NULL if not set.

int nc_client_set_schema_callback	(	ly_module_imp_clb	clb,
		void *	user_data
	)

Set callback function to get missing schemas.

Parameters

[in]	clb	Callback responsible for returning the missing model.
[in]	user_data	Arbitrary data that will always be passed to the callback clb.

Returns

0 on success, 1 on (memory allocation) failure.

ly_module_imp_clb nc_client_get_schema_callback

(

void **

user_data

)

Get callback function used to get missing schemas.

Parameters

[out]

user_data

Optionally return the private data set with the callback. Note that the caller is responsible for freeing the private data, so before changing the callback, private data used for the previous callback should be freed.

Returns

Pointer to the set callback, NULL if no such callback was set.

void nc_client_set_thread_context

(

void *

context

)

Use the provided thread-specific client's context in the current thread.

Note that from this point the context is shared with the thread from which the context was taken and any nc_client_*set* functions and functions creating connection in these threads should be protected from the concurrent execution.

Context contains schema searchpath/callback, call home binds, TLS and SSH authentication data (username, keys, various certificates and callbacks).

Parameters

[in]

context

Client's thread-specific context provided by nc_client_get_thread_context().

void* nc_client_get_thread_context

(

void

)

Get thread-specific client context for sharing with some other thread using nc_client_set_thread_context().

Returns

Pointer to the client's context of the current thread.

void nc_client_init

(

void

)

Initialize libssh and/or libssl/libcrypto for use in the client.

void nc_client_destroy

(

void

)

Destroy all libssh and/or libssl/libcrypto dynamic memory and the client options, for both SSH and TLS, and for Call Home too.