Content-type: text/html Man page of cfg_subsys_config

cfg_subsys_config

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

NAME

cfg_subsys_config - Configure a subsystem  

LIBRARY

Configuration Management Library (libcfg.a)  

SYNOPSIS

#include <cfg.h> cfg_status_t cfg_subsys_config(
        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 configured.  

DESCRIPTION

To initially configure a subsystem into the kernel, call the cfg_subsys_config() routine. If the subsystem is not loaded into the kernel, this routine loads the subsystem. The routine then configures the subsystem using the attribute settings from the /etc/sysconfigtab database. If no attributes are set in the database, the default values defined in the subsystem code are used.

Each subsystem is contained in a module file named subsystem-name.mod. For example, a subsystem named mysubsystem is contained in the mysubsystem.mod module file. This module file must exist in the /subsys, /var/subsys, or /sys/BINARY directory on the system you are configuring.  

EXAMPLES

The following example illustrates the use of the cfg_subsys_config() routine:

cfg_status_t retval; cfg_handle_t handle;

retval = cfg_subsys_config(&handle, "lvm");

if (retval != CFG_SUCCESS)
   print_error(retval);

In this example, the cfg_subsys_config() routine attempts to configure the lvm subsystem. If an error is returned, the corresponding error message is displayed to the application user.  

RETURN VALUES

Upon successful completion, cfg_subsys_config() 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_reconfig(3), cfg_subsys_unconfig(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:42:01 GMT, October 02, 2010