HP-UX Reference (11i v2 07/12) - 2 System Calls (vol 5)

settune_txn(2) settune_txn(2)

[EINVAL] At least one transaction rule was violated and hence none of the changes were made.

[EINVAL] The changes within the transaction could not be applied immediately. One or more

of the tunables within the transaction either do not support pending values or the

STF_NEXTBOOT ﬂag was not set.

[EINVAL] The combination of ﬂags speciﬁed is invalid.

[EINVAL] The number of elements speciﬁed is zero.

[EINVAL] The size of a

ktune_context

structure as speciﬁed by struct_size is invalid.

[EINVAL] The number of elements speciﬁed is greater than the number of tunables available.

[EFAULT] err_buf or err_bufsize speciﬁes an address that is inaccessible.

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

[ENOMEM] Insufﬁcient memory to accommodate the changes within the transaction.

WARNING

The caller must have the

SYSATTR privilege to use this call.

It is possible to seriously degrade system performance, or even render a system unbootable, with incorrect

tunable settings. Use care when setting tunable values. Always have a known working kernel

conﬁguration saved as a backup; if the system fails to boot after a tunable change, boot from that backup

kernel conﬁguration. Keep good records of all tunable changes so that they can be reversed if they degrade

system performance. (Tunable changes made with settune_txn()

are automatically logged to sys-

log

If the tunables being changed through settune_txn(2) are used in expressions that set the values of other

tunables, those expressions will not be re-evaluated and those tunable values will not be updated. If

expression evaluation is desired, use kctune(1M) to set tunable values.

AUTHOR

settune_txn() was developed by Hewlett-Packard Company.