NAME

cfg_disconnect − remove the connection to a remote configuration management server

SYNOPSIS

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

LIBRARY

Configuration Management Library (libcfg.a)

PARAMETERS

The handle structure identifies 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. 

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

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. 

SEE ALSO

Commands: cfgmgr(8), sysconfig(8)

Routines: cfg_connect(3), libcfg(3)