HP-UX Reference (11i v1 00/12) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

441

442

443

444

445

446

447

448

449

450

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man2/!!!intro.2

________________________________________________________________

___ ___

tuneinfo(2) tuneinfo(2)

TIF_MINVALID The ti_minimum ﬁeld contains a minimum allowed value for this parame-

ter.

TIF_MAXVALID The ti_maximum ﬁeld contains a maximum allowed value for this parame-

ter.

RETURN VALUE

If tuneinfo() is successful, it returns the number of tunable parameters for which information is avail-

able. (This number may exceed the supplied count parameter if the supplied buffer is too small to hold all

tunable information.) If the function is not successful, it returns -1.

ERRORS

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 speciﬁed tunable parameter does not exist.

[EFAULT] tunable or buf contains an address that is inaccessible.

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

[EINVAL] The size of a tuneinfo_t structure is incorrect.

EXAMPLES

/* To get information about a specific tunable parameter: */

tuneinfo_t info;

int ret;

ret = tuneinfo(swapmem_on, &info, sizeof(info), 1);

if (ret < 0) ...

/* To get information about all tunable parameters: */

tuneinfo_t *all;

int num_tunes;

int ret;

num_tunes = tuneinfo(NULL, NULL, sizeof(tuneinfo_t), 0);

if (num_tunes < 0) ...

all = (tuneinfo_t *)malloc(num_tunes * sizeof(tuneinfo_t));

ret = tuneinfo(NULL, all, sizeof(tuneinfo_t), num_tunes);

if (ret < 0) ...

AUTHOR

tuneinfo() was developed by Hewlett-Packard Company.