gettune(2)                                                       gettune(2)




 NAME    [Toc]    [Back]
      gettune - get the value of a kernel tunable parameter

 SYNOPSIS    [Toc]    [Back]
      #include <sys/dyntune.h>

      int gettune(const char *tunable,
                  uint64_t   *value);

 DESCRIPTION    [Toc]    [Back]
      This function retrieves the current value of the kernel tunable
      parameter named tunable.  The value is passed back through the
      supplied value pointer.  The value returned is the value for the
      tunable that is being used by the currently running kernel.

 RETURN VALUE    [Toc]    [Back]
      This function returns zero for success, or -1 for an error.

 ERRORS    [Toc]    [Back]
      If this function returns -1 to indicate an error, the global variable
      errno will be set to one of the following values, to indicate the
      error that occurred:

           [ENOENT]     The specified tunable parameter does not exist.

           [EIO]        The Kernel Registry Service was unavailable or
                        encountered an error.

           [EFAULT]     tunable or value specifies an address that is
                        inaccessible.

 WARNINGS    [Toc]    [Back]
      Some tunables have signed integer values.  For these tunables, the
      caller must cast the returned value to an int64_t type before using
      it.  To find out which tunables have signed integer values, use the
      tuneinfo2(2) system call, or consult the tunable parameter man pages.

 AUTHOR    [Toc]    [Back]
      gettune() was developed by Hewlett-Packard Company.

 SEE ALSO    [Toc]    [Back]
      settune(2), tuneinfo2(2), and the individual tunable parameter man
      pages in section 5.


 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003