NAME    [Toc]    [Back]

       cfg_unconfigure - General: Unconfigures a kernel subsystem

SYNOPSIS    [Toc]    [Back]

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

               char *subsys );

ARGUMENTS    [Toc]    [Back]

       Specifies the name of the subsystem to be unconfigured.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       A  subsystem may be unconfigured using the cfg_unconfigure
       kernel routine as follows:

        status = cfg_unconfigure(subsystem_name);

SEE ALSO    [Toc]    [Back]

       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)