cfg_unconfigure(9r) [osf1 man page]

cfg_unconfigure(9r)													       cfg_unconfigure(9r)

NAME

       cfg_unconfigure - General: Unconfigures a kernel subsystem

SYNOPSIS

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

ARGUMENTS

       Specifies the name of the subsystem to be unconfigured.

DESCRIPTION

       The  cfg_unconfigure  kernel  routine  is used to unconfigure a subsystem. If the subsystem is not configured into the kernel, this routine
       returns an error. If subsystem is sucessfully unconfigured, the state of the driver is marked as unconfigured.  An attempt is also made	to
       unload the subsystem's module from the kernel. A dynamically loadable kernel subsystem is subject to be unloaded.

RETURN VALUES

       This  routine  returns 32 bit status 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 subsystem 16 bits][Lower framework 16 bits]

       The subsystem status 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 and 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 unconfigured using the cfg_unconfigure kernel routine as follows:

	status = cfg_unconfigure(subsystem_name);

SEE ALSO

       Routines: cfg_subsys_unconfig(3), cfg_configure(9r), cfg_errno(9r), cfg_query(9r), cfg_reconfigure(9r), cfg_subsysop(9r),

       Other: errno(2),

															       cfg_unconfigure(9r)

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)