|
|
United States-English | |
|
|
 |
|
HP-UX Reference > U
uname_eoverflow(5)Tunable Kernel ParametersHP-UX 11i Version 3: February 2007 |
|
|
NAMEuname_eoverflow — causes uname() system function to return [EOVERFLOW] if values do not fit in fields DESCRIPTIONThe uname_eoverflow tunable controls whether programs calling the non-expanded version of uname() 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 uname() 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 errno set to EOVERFLOW. Changing this tunable does not affect the current system values returned by uname(). In a future version of HP-UX, the uname() function will return no data when EOVERFLOW (or other errors) are reported. See the uname(2) manpage for information on uname(). 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 ChangingThis tunable is dynamic. Changes are effective for all subsequent calls to the non-expanded version of uname(). 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 uname(). What are the Side Effects of Raising the Value?Raising the tunable value to 1 causes the non-expanded version of the uname() system function to return a non-zero status and the EOVERFLOW 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. WARNINGSSetting this tunable to 0 (off) means that applications will not be alerted to truncated values returned by the non-expanded uname() 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 uname() 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 EOVERFLOW 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 uname() system function will avoid future issues. For more information on usage see the whitepaper entitled Node and Host Name Sizes on HP-UX: Using the Expanded Capabilities. 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 tunable values, consult the documentation for the kernel software being installed. For information about optional kernel software that was factory installed on your system, see HP-UX Release Notes at http://docs.hp.com. SEE ALSOuname(2), expanded_node_host_names(5). Node and Host Name Sizes on HP-UX: Using the Expanded Capabilities whitepaper, available on http://docs.hp.com. |
|||||||||||||||||||||||||||||||||||||||
 Printable version |
|
|
|
|
|
|||||||||||||||
|
|||||||||||||||
