dg_csf_class_info(2) — DG/UX R4.11



dg_csf_class_info(2)              SDK R4.11             dg_csf_class_info(2)


NAME
       dgcsfclassinfo - get information about a scheduling class

SYNOPSIS
       #include <sys/dgcsfinfo.h>

       int  dgcsfclassinfo (long selector,
            char *classname,
            long *keyptr,
            void *bufferptr,
            long version);

   where:
       selector  One of three conditions (DG_CSF_CLASS_INFO_SELECTOR_CLASS,
                 DG_CSF_CLASS_INFO_SELECTOR_ALL_CLASSES, or
                 DG_CSF_CLASS_INFO_SELECTOR_ALL_INSTANCES) for determining
                 which class to report information about.

       classname
                 The class name qualifier for the
                 DG_CSF_CLASS_INFO_SELECTOR_CLASS or
                 DG_CSF_CLASS_INFO_SELECTOR_ALL_INSTANCES selector.

       keyptr   On the first call, a pointer to a variable containing the
                 value DG_CSF_CLASS_INFO_INITIAL_KEY; on return, a handle
                 that should be used on subsequent calls to the system call.

       bufferptr
                 For the DG_CSF_CLASS_INFO_SELECTOR_CLASS and
                 DG_CSF_CLASS_INFO_SELECTOR_ALL_CLASSES selector a pointer
                 to buffer of structure dgcsfclassinfo.  For the
                 DG_CSF_CLASS_INFO_SELECTOR_ALL_INSTANCES selector a pointer
                 to a buffer of structure dgcsfinstanceinfo.

       version   The version of the structure being used.  To use the most
                 recent version, for the DG_CSF_CLASS_INFO_SELECTOR_CLASS
                 and DG_CSF_CLASS_INFO_SELECTOR_ALL_CLASSES selector should
                 be set to DG_CSF_CLASS_INFO_CURRENT_VERSION; for the
                 DG_CSF_CLASS_INFO_SELECTOR_ALL_INSTANCES selector should be
                 set to DG_CSF_INSTANCE_INFO_CURRENT_VERSION.

DESCRIPTION
       Use dgcsfclassinfo to get information about all scheduling
       classes, a particular class, or information about all instances of a
       scheduling class based on the selector.  Searching continues until
       more information is available (return value (1)), or until
       information for all of the classes or instances of a class is
       returned (return value (0)).  Only one search is made for all of the
       classes or all of the instances for a class.  The next class or class
       instance information to return information about is determined based
       on the value pointed to by keyptr.

RETURN VALUE
       1      Successful search, but not done.  The buffer was filled with
              information.  keyptr is given a handle which subsequent calls
              to this routine will use to continue the search.

       0      Successful completion, that is, no more classes or class
              instances.  The contents of buffer are undefined.

       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EINVAL  Selector is invalid.

       EINVAL  Version is invalid.

       EINVAL  classname does not exist for the
               DG_CSF_CLASS_INFO_SELECTOR_ALL_INSTANCES selector..

       EFAULT  bufferptr , keyptr, or classname points to an invalid
               address.

       ENOPKG  Clusters is not configured for the node.

SEE ALSO
       dgcsfinfo(2), dgcsfctl(2).


Licensed material--property of copyright holder(s)
Museum
