uname_eoverflow(5) File Formats Manual uname_eoverflow(5)
NAME
uname_eoverflow - causes uname() system function to return [EOVERFLOW] if values do not fit in fields
VALUES
Failsafe
Default
Allowed Values
DESCRIPTION
The tunable controls whether programs calling the non-expanded version of will be alerted to the fact that the values did not fit in their
corresponding fields. When this tunable value is 0, the non-expanded version of will be silent about any truncation of returned values.
When this tunable value is 1, the caller will be alerted to the truncation with a non-zero return value and set to
Changing this tunable does not affect the current system values returned by
In a future version of HP-UX, the function will return no data when (or other errors) are reported. See the uname(2) manpage for informa-
tion on
Who Is Expected to Change This Tunable?
The system administrator may change this tunable when it is necessary to change program behavior in respect to errors.
Restrictions on Changing
This tunable is dynamic. Changes are effective for all subsequent calls to the non-expanded version of
When Should the Value of This Tunable Be Raised?
This tunable may be raised to 1 when applications need to be alerted to the error from
What are the Side Effects of Raising the Value?
Raising the tunable value to 1 causes the non-expanded version of the system function to return a non-zero status and the error if any
value cannot fit in its corresponding field of the non-expanded structure.
When Should the Value of This Tunable Be Lowered?
This tunable should be lowered to 0 when it is necessary to allow applications to proceed with truncated values. This may be the case
where the application aborts due to the error but will tolerate the truncated values; for example, because the values are not important to
its operation.
What are the Side Effects of Lowering the Value?
Lowering the tunable value to 0 causes the non-expanded version of the system function silently truncate any values which do not fit in the
non-expanded fields. It will not alert the caller with an error when such truncation occurs.
What Other Tunable Values Should Be Changed at the Same Time?
None.
WARNINGS
Setting this tunable to 0 (off) means that applications will not be alerted to truncated values returned by the non-expanded system call.
Applications using such truncated values may fail in a non-deterministic manner.
As of the HP-UX 11i Version 3 initial release, only the node name value returned by may be truncated as no other fields returned by that
function can take on values which exceed the non-expanded field sizes. However, later updates and releases may expand other values, and
their corresponding non-expanded fields may also be truncated (or cause the error to be reported. Such expansions will be optional at the
discretion of the system administrator. However, upgrading programs to use the expanded version of the system function will avoid future
issues.
For more information on usage see the whitepaper entitled
All HP-UX kernel tunable parameters are release specific. This parameter may be removed or have its meaning changed in future releases of
HP-UX.
Installation of optional kernel software, from HP or other vendors, may cause changes to tunable parameter values. After installation,
some tunable parameters may no longer be at the default or recommended values. For information about the effects of installation on tun-
able values, consult the documentation for the kernel software being installed. For information about optional kernel software that was
factory installed on your system, see at
AUTHOR
was developed by HP.
SEE ALSO
uname(2), expanded_node_host_names(5).
whitepaper, available on
Tunable Kernel Parameters uname_eoverflow(5)
