|
|
SCO 5.6 File truncation
|
|
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)
