listing for C
cfg_connect - connect to the configuration management server on a remote
unsigned int flags );
Configuration Management Library (libcfg.a)
Specifies the name of the host system to be configured.
Returns a connection handle that you use in other calls to the
configuration management library. This handle is a structure that
identifies the means of communication between your application and the
configuration management server.
Specifies flags to the connection. Currently, one option is supported.
CFG_FLAG_VERBOSE requests that the system display status information to
the application user during the processing of routines in the
configuration management library. This flag is normally used only for
debugging your application.
Before your application can perform operations on remote kernel subsystems,
it must call the cfg_connect() routine. This routine invokes the
configuration management server and establishes a socket connection between
the server and your application. The routine returns the handle parameter,
which identifies the socket connection between your application and the
remote configuration management server. You must pass the handle in calls
to other libcfg routines.
For local operations, you do not need to establish a connection to the
configuration management server, so you do not need to call the
Upon successful completion, cfg_connect() 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
The following example illustrates the use of the cfg_connect() library
retval = cfg_connect("madmax", &handle, 0);
if (retval != CFG_SUCCESS)
In this example, the cfg_connect() call attempts to establish a connection
between your application and the configuration management server on host
madmax. If successful, the call returns data describing how your
application will communicate with the configuration management server. If
the return value is not CFG_SUCCESS, the application calls the
print_error() routine, which displays an error message. (The print_error()
routine is not part of the libcfg library. For an example of this routine,
Commands: cfgmgr(8), sysconfig(8)
Routines: cfg_disconnect(3), libcfg(3)
listing for C