Manual Page Result
0
Command: cfg_subsys_config | Section: 3 | Source: Digital UNIX | File: cfg_subsys_config.3.gz
cfg_subsys_config(3) Library Functions Manual cfg_subsys_config(3)
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 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 configured.
DESCRIPTION
To initially configure a subsystem into the kernel, call the cfg_sub-
sys_config() routine. If the subsystem is not loaded into the kernel,
this routine loads the subsystem. The routine then configures the sub-
system using the attribute settings from the /etc/sysconfigtab data-
base. If no attributes are set in the database, the default values de-
fined 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 mysub-
system.mod module file. This module file must exist in the /subsys,
/var/subsys, or /sys/BINARY directory on the system you are configur-
ing.
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 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_reconfig(3), cfg_subsys_unconfig(3), libcfg(3) de-
lim off
cfg_subsys_config(3)