settune_txn.2 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

settune_txn(2) settune_txn(2)

• None of the changes within a transaction succeed or all of the changes within a transaction succeed.

There are no in-betweens.

• No duplicates are allowed within a transaction, where duplicates are deﬁned as more than one change

to a tunable.

• There are no restrictions on the order in which the tunables need to be speciﬁed within a transaction.

Some parameters represent limits on resources that can be consumed by individual processes. In general,

changes to these parameters do not affect processes that are running at the time the change is made; they

affect only new programs started (with

exec() or an equivalent) after that time. Some speciﬁc parame-

ters may be exceptions to this general rule; see the man pages for those parameters for details.

The

tuneinfo2() call can give information about whether or not changes to a parameter are allowed,

or will require a reboot, or can be tuned automatically. Some individual parameters may have speciﬁc

notes regarding their behavior when changed; see the man pages for those parameters for details.

Security Restrictions

The actions associated with this system call require the

SYSATTR privilege. Processes owned by the

superuser have this privilege. Processes owned by other users may have this privilege, depending on sys-

tem conﬁguration. See privileges (5) for more information about privileged access on systems that support

ﬁne-grained privileges.

RETURN VALUES

STR_OK The values of the parameters have been changed and the new values are effective

immediately.

STR_ERROR The function did not complete successfully. None of the changes were applied.

The detailed error messages are in the buffer err_buf .

If the buffer size returned in err_bufsize is greater than the size of err_buf , there

were more error messages than have been returned. To get the remaining errors,

increase the size of the buffer and try again.

STR_WARN The function completed successfully, but there were warning messages generated.

These warning messages are in the buffer, err_buf .

If the buffer size returned in err_bufsize is greater than the size of err_buf , some

warning messages were generated which did not ﬁt into the buffer.

ERRORS

When the function returns

STR_ERROR the global variable errno will be set to one of the following

values:

[ENOENT] One or more of the speciﬁed tunables does not exist.

[EPERM] The caller does not have the

SYSATTR privilege.

[EBADVER] The version parameter is not valid.

[EINVAL] One or more of the speciﬁed values within the transaction are not within the

acceptable range of values for the corresponding parameters.

[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.

[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.

2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010