Index for Section 3

Alphabetical listing for C

Bottom of page

cfg_subsys_config(3)
NAME
  cfg_subsys_config - configure a subsystem

SYNOPSIS
  #include <cfg.h>

  cfg_status_t cfg_subsys_config(
	  cfg_handle_t *handle,
	  caddr_t subsys );

LIBRARY
  Configuration Management Library (libcfg.a)

PARAMETERS
  handle
      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.

  subsys
      Names the subsystem to be configured.

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 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
  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
  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
  Commands: cfgmgr(8), sysconfig(8)

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

Index for Section 3

Alphabetical listing for C

Top of page