cfg_configure(9r) [osf1 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)

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)