NAME    [Toc]    [Back]

       cfg_subsysop  -  Kernel routine used to perform subsystemdefined
 operations

SYNOPSIS    [Toc]    [Back]

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

       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  contents are filled in by the system's configure
       routine.  The length in bytes of the output  data  in  the
       output buffer.

DESCRIPTION    [Toc]    [Back]

       The  cfg_subsysop(  ) routine performs a subsystem defined
       operation. The semantics of the operation are  defined  by
       the subsystem and implemented in the subsystem's configure
       routine.

RETURN VALUES    [Toc]    [Back]

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

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

       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)