libnetconf2 2.0.24
NETCONF server and client library in C.
Loading...
Searching...
No Matches
Client

NETCONF client functionality. More...

Collaboration diagram for Client:

Modules

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

Functions

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.
 
ly_module_imp_clb nc_client_get_schema_callback (void **user_data)
 Get callback function used to get missing schemas.
 
const char * nc_client_get_schema_searchpath (void)
 Get schema searchpath that was set by nc_client_set_schema_searchpath().
 
void * nc_client_get_thread_context (void)
 Get thread-specific client context for sharing with some other thread using nc_client_set_thread_context().
 
void nc_client_init (void)
 Initialize libssh and/or libssl/libcrypto for use in the client.
 
int nc_client_set_schema_callback (ly_module_imp_clb clb, void *user_data)
 Set callback function to get missing schemas.
 
int nc_client_set_schema_searchpath (const char *path)
 Set location where libnetconf tries to search for YANG/YIN schemas.
 
void nc_client_set_thread_context (void *context)
 Use the provided thread-specific client's context in the current thread.
 

Detailed Description

NETCONF client functionality.

Function Documentation

◆ nc_client_destroy()

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.

◆ nc_client_get_schema_callback()

ly_module_imp_clb nc_client_get_schema_callback ( void **  user_data)

Get callback function used to get missing schemas.

Parameters
[out]user_dataOptionally 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.

◆ nc_client_get_schema_searchpath()

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.

◆ 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.

◆ nc_client_init()

void nc_client_init ( void  )

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

◆ nc_client_set_schema_callback()

int nc_client_set_schema_callback ( ly_module_imp_clb  clb,
void *  user_data 
)

Set callback function to get missing schemas.

Parameters
[in]clbCallback responsible for returning the missing model.
[in]user_dataArbitrary data that will always be passed to the callback clb.
Returns
0 on success, 1 on (memory allocation) failure.

◆ nc_client_set_schema_searchpath()

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]pathDirectory where to search for YANG/YIN schemas.
Returns
0 on success, 1 on (memory allocation) failure.

◆ nc_client_set_thread_context()

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]contextClient's thread-specific context provided by nc_client_get_thread_context().