Manual Page Result
0
Command: cfg_subsys_unconfig | Section: 3 | Source: Digital UNIX | File: cfg_subsys_unconfig.3.gz
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 applica-
tion 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 unconfig-
ured.
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 uncon-
figure 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 informa-
tion 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)