Content-type: text/html Man page of cfg_subsys_unconfig

cfg_subsys_unconfig

Section: C Library Functions (3)
Index Return to Main Contents
 

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, "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) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
EXAMPLES
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:31 GMT, October 02, 2010