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_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)