cfg_subsys_config(3) [osf1 man page]

cfg_subsys_config(3)					     Library Functions Manual					      cfg_subsys_config(3)

NAME

       cfg_subsys_config - Configure a subsystem

LIBRARY

       Configuration Management Library (libcfg.a)

SYNOPSIS

       #include <cfg.h> cfg_status_t cfg_subsys_config(
	       cfg_handle_t *handle,
	       caddr_t subsys);

PARAMETERS

       Structure  identifying  the  means  of communication between your application and the configuration management server.  For local requests,
       pass NULL in this parameter.  For remote requests, pass the value returned from the cfg_connect routine.  Names the subsystem to be config-
       ured.

DESCRIPTION

       To  initially configure a subsystem into the kernel, call the cfg_subsys_config() routine.  If the subsystem is not loaded into the kernel,
       this routine loads the subsystem.  The routine then configures the subsystem using the attribute settings from the /etc/sysconfigtab  data-
       base.  If no attributes are set in the database, the default values defined in the subsystem code are used.

       Each  subsystem	is  contained  in  a  module file named subsystem-name.mod. For example, a subsystem named mysubsystem is contained in the
       mysubsystem.mod module file.  This module file must exist in the /subsys, /var/subsys, or /sys/BINARY directory on the system you are  con-
       figuring.

EXAMPLES

       The following example illustrates the use of the cfg_subsys_config() routine:

       cfg_status_t	       retval; cfg_handle_t	       handle;

       retval = cfg_subsys_config(&handle, "vfs");

       if (retval != CFG_SUCCESS)
	  print_error(retval);

       In this example, the cfg_subsys_config() routine attempts to configure the vfs subsystem.  If an error is returned, the corresponding error
       message is displayed to the application user.

RETURN VALUES

       Upon successful completion, cfg_subsys_config() returns CFG_SUCCESS.  Other return values indicate that an error has occurred.  For  infor-
       mation about handling return values from routines in the configuration management library, see libcfg(3).

RELATED INFORMATION

       Commands: cfgmgr(8), sysconfig(8)

       Routines: cfg_subsys_reconfig(3), cfg_subsys_unconfig(3), libcfg(3) delim off

															      cfg_subsys_config(3)

cfg_connect(3)						     Library Functions Manual						    cfg_connect(3)

NAME

       cfg_connect - Connect to the configuration management server on a remote host

LIBRARY

       Configuration Management Library (libcfg.a)

SYNOPSIS

       #include <cfg.h> cfg_status_t cfg_connect(
	       caddr_t host,
	       cfg_handle_t *handle,
	       unsigned int flags);

PARAMETERS

       Specifies  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.

DESCRIPTION

       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 need not establish a connection to the configuration management server, so you do not need to call  the  cfg_con-
       nect() routine.

EXAMPLES

       The 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 VALUES

       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 libcfg(3).

RELATED INFORMATION

       Commands: cfgmgr(8), sysconfig(8)

       Routines: cfg_disconnect(3), libcfg(3) delim off

																    cfg_connect(3)