Manual Page Result
0
Command: cfg_disconnect | Section: 3 | Source: Digital UNIX | File: cfg_disconnect.3.gz
cfg_disconnect(3) Library Functions Manual cfg_disconnect(3)
NAME
cfg_disconnect - Remove the connection to a remote configuration man-
agement server
LIBRARY
Configuration Management Library (libcfg.a)
SYNOPSIS
#include <cfg.h> cfg_status_t cfg_disconnect(
cfg_handle_t *handle);
PARAMETERS
Structure identifying the means of communication between your applica-
tion and the configuration management server. Your application re-
ceives 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.
EXAMPLES
The following example illustrates the use of the cfg_disconnect() li-
brary 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 be-
tween 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 informa-
tion 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) delim off
cfg_disconnect(3)