cfg_subsys_config(3)cfg_subsys_config(3)NAMEcfg_subsys_config - configure a subsystem
SYNOPSIS
#include <cfg.h>
cfg_status_t cfg_subsys_config(
cfg_handle_t *handle,
caddr_t subsys );
LIBRARY
Configuration Management Library (libcfg.a)
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
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 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.
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).
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, "vfs");
if (retval != CFG_SUCCESS)
print_error(retval);
In this example, the cfg_subsys_config() routine attempts to configure
the vfs subsystem. If an error is returned, the corresponding error
message is displayed to the application user.
SEE ALSO
Commands: cfgmgr(8), sysconfig(8)
Routines: cfg_subsys_reconfig(3), cfg_subsys_unconfig(3), libcfg(3)cfg_subsys_config(3)