*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> cfg_configure (9r)              



NAME    [Toc]    [Back]

       cfg_configure  -  General:  Loads  and configures a kernel

SYNOPSIS    [Toc]    [Back]

       #include <sys/sysconfig.h>( ); cfg_status_t cfg_configure(
               char *subsys );

ARGUMENTS    [Toc]    [Back]

       Specifies the name of the subsystem to be configured.

DESCRIPTION    [Toc]    [Back]

       The  cfg_configure  routine is used to configure a subsystem.
 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 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 configuring.

       The mysubsystem.mod file must include two things:

       The   subsystem's   attribute   table,   named   mysubsystem_attributes[]
 The subsystem's configure routine,  named

       Refer to the /usr/examples/cfgmgr.c file for an example of
       a sample subsystem.

RETURN VALUES    [Toc]    [Back]

       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  subsystem   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    [Toc]    [Back]

       A subsystem may be configured using the cfg_configure kernel
 routine as follows:

        status = cfg_configure(subsystem_name);

SEE ALSO    [Toc]    [Back]

       Routines: cfg_subsys_config(3), cfg_query(9r),  cfg_reconfigure(9r), cfg_subsysop(9r), cfg_unconfigure(9r)

       Other: errno(2)

[ Back ]
 Similar pages
Name OS Title
cfg_unconfigure Tru64 General: Unconfigures a kernel subsystem
cfg_reconfigure Tru64 General: Reconfigures the attribute values for a kernel subsystem
atmconfig Tru64 Configures the ATM subsystem
atmifmp Tru64 Configures the ATM subsystem for switching IP traffic only
cfg_query Tru64 General: Determines the values of selected subsystem attributes
sys_attrs_ipc Tru64 attributes for the ipc kernel subsystem
sysconfig Tru64 Maintains the kernel subsystem configuration
sys_attrs_vfs Tru64 system attributes for the vfs kernel subsystem
sys_attrs_cm Tru64 system attributes for the cm kernel subsystem
sys_attrs_vm Tru64 system attributes for the vm kernel subsystem
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service