NAME    [Toc]    [Back]

       cfg_subsys_unconfig - unconfigure a subsystem

SYNOPSIS    [Toc]    [Back]

       #include <cfg.h>

       cfg_status_t cfg_subsys_unconfig(
               cfg_handle_t *handle,
               caddr_t subsys );

LIBRARY    [Toc]    [Back]

       Configuration Management Library (libcfg.a)

PARAMETERS    [Toc]    [Back]

       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 unconfigured.

DESCRIPTION    [Toc]    [Back]

       When  a  subsystem is not needed, you can use the cfg_subsys_unconfig()
 routine to unconfigure  the  subsystem.  If
       the subsystem is loadable, it is unloaded from the kernel.
       When a subsystem  is  unloaded,  the  memory  it  occupies
       becomes available for other uses.

RETURN VALUES    [Toc]    [Back]

       Upon  successful completion, cfg_subsys_unconfig() 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    [Toc]    [Back]

       The  following example illustrates the use of the cfg_subsys_unconfig()
 library routine:

       cfg_status_t                   retval;        cfg_handle_t
       handle;

       retval = cfg_subsys_unconfig(&handle, "presto");

       if (retval != CFG_SUCCESS)
          print_error(retval);

       In   this   example,   the  cfg_subsys_unconfig()  routine
       attempts to unconfigure the presto subsystem. If an  error
       is returned, the application displays an error message.

SEE ALSO    [Toc]    [Back]

       Commands: cfgmgr(8), sysconfig(8)

       Routines: cfg_subsys_config(3), libcfg(3)



                                           cfg_subsys_unconfig(3)