NAME

cfg_subsys_unconfig − unconfigure a subsystem

SYNOPSIS

#include <cfg.h>
cfg_status_t cfg_subsys_unconfig(
        cfg_handle_t ∗handle,
        caddr_t subsys );

LIBRARY

Configuration Management Library (libcfg.a)

PARAMETERS

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

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

RETURN VALUES

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

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

Commands: cfgmgr(8), sysconfig(8)

Routines: cfg_subsys_config(3), libcfg(3)