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

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



NAME    [Toc]    [Back]

       cfg_reconfigure - General: Reconfigures the attribute values
 for a kernel subsystem

SYNOPSIS    [Toc]    [Back]

       #include <sys/sysconfig.h> );  cfg_status_t  cfg_reconfigure(

               char *subsys,
               cfg_attr_t *attributes,
               uint nattributes );

ARGUMENTS    [Toc]    [Back]

       Specifies  the  name  of the subsystem to be reconfigured.
       Specifies the name of  the  array  containing  a  list  of
       attribute  names and their new values. The array must have
       (nattributes  +  1)  cfg_attr_t   structures,   with   the
       attribute name of the last one being set to a null string.
       Specifies the number of attributes whose  values  you  are

DESCRIPTION    [Toc]    [Back]

       The cfg_reconfigure( ) routine is used to modify attribute
       values for a subsystem. The  modifications  made  by  this
       routine  take  effect immediately because they are made to
       the in-memory copy of the subsystem.  Neither  the  kernel
       nor  the  subsystem stores a copy of the modifications, so
       if the system is rebooted or the  subsystem  is  unconfigured,
  the  modifications  are lost. When the subsystem is
       again  configured  into  the  kernel,  the  value  of  its
       attributes   are   retrieved  from  the  /etc/sysconfigtab
       database and the subsystem code. To make permanent changes
       to attribute values, store the new attribute values in the
       /etc/sysconfigtab database. See the sysconfigtab(4) reference
 page for information about the database.

       When  your  application  calls the cfg_reconfigure( ) routine,
 it passes a list of attribute names and values.  The
       application  passes this information in an array of structures
 of  type  cfg_attr_t.  For  information  about  this
       structure,  see the cfg_subsys_reconfig(3) reference page.

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 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 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 reconfigured using the  cfg_reconfigure
       kernel routine as follows:

              cfg_attr_t              attributes[2];
              cfg_status_t            retval;
              int                     i;
              int                     nattributes;

              /*  Initialize  attribute  names  for  the  request

              strcpy (attributes[0].name, "maxmounts");
              attributes[0].type = CFG_ATTR_INTTYPE;
              attributes[0].attr.num.val = 30;
              nattributes = 1;
              attributes[1].name[0] = '\0';

              /*   Call the cfg_reconfigure() routine        */

              retval =  cfg_reconfigure("lvm",  attributes,  nattributes);

              if (retval != CFG_SUCCESS)
                  print_error (retval);

              else {

                   for (i=0; i<1; i++) {
                      printf("%s:", attributes[i].name);
                      if  (attributes[i].status  != CFG_ATTR_SUCCESS)
                          switch (attributes[i].status){
                           case CFG_ATTR_EEXISTS:
                             printf("unknown attribute\n");
                           case CFG_ATTR_EOP:
                             printf("attribute  does  not   allow
       this operation\n");
                             printf("unknown error\n");
                     }   else   printf("  successfully  reconfigured\n");


SEE ALSO    [Toc]    [Back]

       Routines:    cfg_subsys_reconfig(3),    cfg_configure(9r),
       cfg_errno(9r), cfg_query(9r), cfg_subsysop(9r), cfg_unconfigure(9r)

       Other: errno(2), sysconfigtab(4)

[ Back ]
 Similar pages
Name OS Title
cfg_subsys_reconfig Tru64 reconfigure attribute values for a subsystem
cfg_query Tru64 General: Determines the values of selected subsystem attributes
cfg_unconfigure Tru64 General: Unconfigures a kernel subsystem
cfg_configure Tru64 General: Loads and configures a kernel subsystem
cfg_subsys_attr_t Tru64 General: Contains attribute information for kernel modules
gconfig IRIX reconfigures the GL modes of the current window
sys_attrs_ipc Tru64 attributes for the ipc kernel subsystem
CSSM_UpdateContextAttributes Tru64 Update context attribute values (CDSA)
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