NAME    [Toc]    [Back]

       cfg_subsys_config - configure a subsystem

SYNOPSIS    [Toc]    [Back]

       #include <cfg.h>

       cfg_status_t cfg_subsys_config(
               cfg_handle_t *handle,
               caddr_t subsys );

LIBRARY    [Toc]    [Back]

       Configuration Management Library (libcfg.a)

PARAMETERS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       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 database.
       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 configuring.

RETURN VALUES    [Toc]    [Back]

       Upon  successful  completion,  cfg_subsys_config() 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_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.

SEE ALSO    [Toc]    [Back]

       Commands: cfgmgr(8), sysconfig(8)

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



                                             cfg_subsys_config(3)