gettune.2 (2010 09)

gettune(2) gettune(2)

NAME

gettune - get the value of a kernel tunable parameter

SYNOPSIS

#include <sys/dyntune.h>

int gettune(const char *tunable,

uint64_t *value);

DESCRIPTION

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

This function returns zero for success, or -1 for an error.

ERRORS

If this function returns -1 to indicate an error, the global variable

errno will be set to one of the follow-

ing values, to indicate the error that occurred:

[ENOENT] The speciﬁed tunable parameter does not exist.

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

[EFAULT] tunable or value speciﬁes an address that is inaccessible.

WARNINGS

Some tunables have signed integer values. For these tunables, the caller must cast the returned value to

int64_t type before using it. To ﬁnd out which tunables have signed integer values, use the

tuneinfo2 (2) system call, or consult the tunable parameter man pages.

AUTHOR

gettune() was developed by Hewlett-Packard Company.

PAGE 1
gettune(2) gettune(2) NAME gettune - get the value of a kernel tunable parameter SYNOPSIS #include int gettune(const char *tunable, uint64_t *value); DESCRIPTION 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 This function returns zero for success, or -1 for an error.
PAGE 2
(Notes) A (Notes) gA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010