cfg_disconnect(3)cfg_disconnect(3)NAMEcfg_disconnect - remove the connection to a remote configuration man‐
agement 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 manage‐
ment 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 manage‐
ment 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)cfg_disconnect(3)