cfg_disconnect(3)					     Library Functions Manual						 cfg_disconnect(3)

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

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