cfg_subsys_unconfig(3)					     Library Functions Manual					    cfg_subsys_unconfig(3)

NAME

       cfg_subsys_unconfig - Unconfigure a subsystem

LIBRARY

       Configuration Management Library (libcfg.a)

SYNOPSIS

       #include <cfg.h> cfg_status_t cfg_subsys_unconfig(
	       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
       unconfigured.

DESCRIPTION

       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.

EXAMPLES

       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.

RETURN VALUES

       Upon successful completion, cfg_subsys_unconfig() 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_config(3), libcfg(3) delim off

															    cfg_subsys_unconfig(3)