NAME    [Toc]    [Back]

       cfg_disconnect - remove the connection to a remote configuration
 management server

SYNOPSIS    [Toc]    [Back]

       #include <cfg.h>

       cfg_status_t cfg_disconnect(
               cfg_handle_t *handle );

LIBRARY    [Toc]    [Back]

       Configuration Management Library (libcfg.a)

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Commands: cfgmgr(8), sysconfig(8)

       Routines: cfg_connect(3), libcfg(3)



                                                cfg_disconnect(3)