Query: cfg_connect
OS: osf1
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
cfg_connect(3) Library Functions Manual cfg_connect(3)NAMEcfg_connect - Connect to the configuration management server on a remote hostLIBRARYConfiguration Management Library (libcfg.a)SYNOPSIS#include <cfg.h> cfg_status_t cfg_connect( caddr_t host, cfg_handle_t *handle, unsigned int flags);PARAMETERSSpecifies the name of the host system to be configured. Returns a connection handle that you use in other calls to the configuration man- agement library. This handle is a structure that identifies the means of communication between your application and the configuration man- agement server. Specifies options to the connection. Currently, one option is supported. CFG_FLAG_VERBOSE requests that the system dis- play 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.DESCRIPTIONBefore 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 need not establish a connection to the configuration management server, so you do not need to call the cfg_con- nect() routine.EXAMPLESThe following example illustrates the use of the cfg_connect() library routine: cfg_status_t retval; cfg_handle_t handle; retval = cfg_connect("madmax", &handle, 0); if (retval != CFG_SUCCESS) print_error(retval); 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, see libcfg(3).)RETURN VALUESUpon 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 libcfg(3).RELATED INFORMATIONCommands: cfgmgr(8), sysconfig(8) Routines: cfg_disconnect(3), libcfg(3) delim off cfg_connect(3)
Related Man Pages |
---|
cfg_subsys_config(3) - osf1 |
cfg_subsys_defaults(3) - osf1 |
cfg_subsys_query_all(3) - osf1 |
cfg_subsys_query(3) - osf1 |
libcfg(3) - osf1 |
Similar Topics in the Unix Linux Community |
---|
Configuration management tool in SCO UNIXWARE 7.1.3 |
RHQ 0.1 (Default branch) |
AIX licensing management |
Alfresco 3a.1032 (Default branch) |
application Crashes on memset ?? any suggestions |