cfg_subsysop(9r) [osf1 man page]
cfg_subsysop(9r) cfg_subsysop(9r) NAME
cfg_subsysop - Kernel routine used to perform subsystem-defined operations SYNOPSIS
#include <sys/sysconfig.h> ); cfg_status_t cfg_subsysop( char *subsys, cfg_op_t op, caddr_t indata, size_t insize, caddr_t outdata, size_t outsize ); ARGUMENTS
Name of the subsystem. Value of the operation code defined by the subsystem to be preformed. Subsystem codes are from 100 to 999. The input data to the subsystem's configure routine. This buffer is allocated by the caller. Its contents are filled in by the caller. The length of the data in bytes in the indata argument. The output data of the operation. This buffer is allocated by the caller, but its con- tents are filled in by the system's configure routine. The length in bytes of the output data in the output buffer. DESCRIPTION
The cfg_subsysop( ) routine performs a subsystem defined operation. The semantics of the operation are defined by the subsystem and imple- mented in the subsystem's configure routine. RETURN VALUES
This routine returns 32 bit status values of type cfg_status_t composed of subsystem status and framework status segments. The upper 16 bits is the subsystem status (CFG_STATUS_SUBSYS) and the lower 16 bits is the frame status (CFG_STATUS_FRAME). The return values are orga- nized as follows:[Upper subsystem 16 bits][Lower framework 16 bits] The subsystem status is returned by the subsystem's configure routine and can be any error in errno.h. The framework status is returned by the configuration framework and the possible values are defined in <sys/sysconfig.h> as CFG_FRAME_Exxx. A completely successful operation has ESUCCESS(0) returned in both status segments. See the cfg_errno(9r) and errno(2) reference pages for more details about error numbers and status. EXAMPLE
char indata[IN_SZ]; char outdata[OUT_SZ]; cfg_status_t retval; /***************************************************/ /* Call the cfg_subsysop routine */ retval = cfg_subsysop("lvm", CLEAN_UP, indata,IN_SZ, outdata, OUT_SZ); if (retval != CFG_SUCCESS) print_error(retval); SEE ALSO
Kernel Interfaces: cfg_reconfigure(9r), cfg_query(9r), cfg_unconfigure(9r), cfg_configure(9r), cfg_errno(9r) Tru64 UNIX: errno(2), cfg_subsys_op(3) cfg_subsysop(9r)
Check Out this Related Man Page
cfg_configure(9r) cfg_configure(9r) NAME
cfg_configure - General: Loads and configures a kernel subsystem SYNOPSIS
#include <sys/sysconfig.h>( ); cfg_status_t cfg_configure( char *subsys ); ARGUMENTS
Specifies the name of the subsystem to be configured. DESCRIPTION
The cfg_configure routine is used to configure a subsystem. If the subsystem is not loaded into the kernel, this routine loads the subsys- tem. 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 pointed to by 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 con- figuring. The mysubsystem.mod file must include two things: The subsystem's attribute table, named mysubsystem_attributes[] The subsystem's configure routine, named mysubsystem_configure() Refer to the /usr/examples/cfgmgr.c file for an example of a sample subsystem. RETURN VALUES
This routine returns 32-bit values composed of subsystem status and framework status segments. The upper 16 bits is the subsystem status (CFG_STATUS_SUBSYS) and the lower 16 bits is the frame status (CFG_STATUS_FRAME). The return values are organized as follows:[Upper subsys- tem 16 bits][Lower framework 16 bits] The subsystem staus is returned by the subsystem's configure routine and can be any error in errno.h. The framework status is returned by the configuration framework; the possible values are defined in <sys/sysconfig.h> as CFG_FRAME_Exxx. A successful operation has ESUCCESS(0) returned in both status segments. See the cfg_errno(9r) and errno(2) reference pages for more details about error numbers and status. EXAMPLE
A subsystem may be configured using the cfg_configure kernel routine as follows: status = cfg_configure(subsystem_name); SEE ALSO
Routines: cfg_subsys_config(3), cfg_query(9r), cfg_reconfigure(9r), cfg_subsysop(9r), cfg_unconfigure(9r) Other: errno(2) cfg_configure(9r)