cfg_configure(9r)														 cfg_configure(9r)

NAME

       cfg_configure - General: Loads and configures a kernel subsystem

SYNOPSIS

       #include <sys/sysconfig.h>( ); cfg_status_t cfg_configure(
	       char *subsys );

ARGUMENTS

       Specifies the name of the subsystem to be configured.

DESCRIPTION

       The  cfg_configure routine is used to configure a subsystem. If the subsystem is not loaded into the kernel, this routine loads the subsys-
       tem. 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 pointed to by 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.

       The mysubsystem.mod file must include two things:

       The subsystem's attribute table, named mysubsystem_attributes[] The subsystem's configure routine, named mysubsystem_configure()

       Refer to the /usr/examples/cfgmgr.c file for an example of a sample subsystem.

RETURN VALUES

       This  routine  returns  32-bit values composed of subsystem status and framework status segments. The upper 16 bits is the subsystem status
       (CFG_STATUS_SUBSYS) and the lower 16 bits is the frame status (CFG_STATUS_FRAME). The return values are organized as follows:[Upper subsys-
       tem 16 bits][Lower framework 16 bits]

       The  subsystem  staus is returned by the subsystem's configure routine and can be any error in errno.h. The framework status is returned by
       the configuration framework; the possible values are defined in <sys/sysconfig.h> as CFG_FRAME_Exxx. A successful  operation  has  ESUCCESS(0) returned in both status segments.

       See the cfg_errno(9r) and errno(2) reference pages for more details about error numbers and status.

EXAMPLE

       A subsystem may be configured using the cfg_configure kernel routine as follows:

	status = cfg_configure(subsystem_name);

SEE ALSO

       Routines: cfg_subsys_config(3), cfg_query(9r), cfg_reconfigure(9r), cfg_subsysop(9r), cfg_unconfigure(9r)

       Other: errno(2)

																 cfg_configure(9r)