NAME

cfg_disconnect − Remove the connection to a remote configuration management server

LIBRARY

Configuration Management Library (libcfg.a)

SYNOPSIS

#include <cfg.h>
cfg_status_t cfg_disconnect(
        cfg_handle_t ∗handle);

PARAMETERS

handleStructure identifying the means of communication between your application and the configuration management server.  Your application receives this structure when it calls the cfg_connect() routine. 

DESCRIPTION

Once your application is finished using a remote configuration management server, it should call the cfg_disconnect() routine. This routine closes sockets and stops execution of the configuration management server. 

EXAMPLES

The following example illustrates the use of the cfg_disconnect() library routine:

cfg_status_t            retval;
cfg_handle_t            handle;
retval = cfg_disconnect(&handle);
if (retval != CFG_SUCCESS)
   print_error(retval);

In this example, the cfg_disconnect() routine ends communication between the application and the configuration manager server.  The server stops executing. 

RETURN VALUES

Upon successful completion, cfg_disconnect() returns CFG_SUCCESS.  Other return values indicate that an error has occurred.  For information about handling return values from routines in the configuration management library, see libcfg(3). 

RELATED INFORMATION

Commands: cfgmgr(8), sysconfig(8)

Routines: cfg_connect(3), libcfg(3)