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

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

subsysNames 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, "lvm");
if (retval != CFG_SUCCESS)
   print_error(retval);

In this example, the cfg_subsys_unconfig() routine attempts to unconfigure the lvm 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 information 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)