Index for Section 3

Alphabetical listing for C

Bottom of page

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
  handle    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 information 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)

Index for Section 3

Alphabetical listing for C

Top of page