osf1 man page for cfg_subsys_unconfig

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)