uname_eoverflow(5)uname_eoverflow(5)NAMEuname_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 trunca‐
tion 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 information
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-determinis‐
tic 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 func‐
tion 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 discre‐
tion 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 parame‐
ter 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 val‐
ues. For information about the effects of installation on tunable val‐
ues, 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 ALSOuname(2), expanded_node_host_names(5).
whitepaper, available on
Tunable Kernel Parameters uname_eoverflow(5)