A fix is available
APAR status
Closed as unreproducible in next release.
Error description
A new ioctl() command is introduced that will retrieve TCPIP's local interface configuration for IPv6. The functionality of the SiocGifConf ioctl() command for IPv4 is not present in IPv6 so information about the home IP addresses that are configured for IPv6 can not be retrieved by an application.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All C/C++ users of the ioctl() function * * who wish to exploit the SIOCGIFCONF6 * * ioctl request to retrieve the IPv6 * * interface list and interface state, * * in support of APAR OA13217. * **************************************************************** * PROBLEM DESCRIPTION: This APAR is provided in support of * * OA13217. * **************************************************************** * RECOMMENDATION: * **************************************************************** This APAR is provided in support of APAR OA13217.
Problem conclusion
Temporary fix
Comments
The sys/ioctl.h header file is updated in support of APAR OA13217. The C/C++ Run-Time Library Reference publication has been updated with the following information (SA22-7821-XX): ioctl() -- Control Device The following additional ioctl() command can be used with sockets: SIOCGIFCONF6 Gets the name, address, and other information about the IPv6 network interfaces that are configured. This is similar to the SIOCGIFCONF command for IPv4. A struct __net_ifconf6header_s is passed as the argument of the the ioctl. This structure specifies the buffer where the configuration information is to be written and is returned with the number of entries and entry length of each struct __net_ifconf6entry_s that was written to the output buffer. These structures are defined in <sys/ioctl.h>. If __nif6h_buflen and __nif6h_buffer are both zero, a query function is performed and the header is returned with: __nif6h_version: the maximum supported version note: if the version number is supplied (nonzero), the entry length returned will be for the specified version (if it is supported) __nif6h_entries: the total number of entries that would be output __nif6h_entrylen: the length of each individual entry If a call to get information fails with either: errno=ERANGE, or errno=EINVAL and __nif6h_version has changed the call was converted into a query function and the header has been filled in as described above. In these cases, the content of the output buffer is undefined. If Common INET is configured and multiple TCP/IP stacks are attached to the socket, the output from each stack that is enabled for IPv6 will be concatenated in the output buffer and the header will contain the total number of entries returned from all the stacks. The version returned with the query function will be the highest version supported by all the stacks. This ioctl can be issued on an AF_INET or AF_INET6 socket. errno Description EAFNOSUPPORT No IPv6 enabled TCP/IP stacks are active. EINVAL The input version number is not supported. ERANGE The buffer is too small to contain all of the IPv6 network interface entries.
APAR Information
APAR number
PK22885
Reported component name
LE C LIBRARY
Reported component ID
568819805
Reported release
730
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2006-04-05
Closed date
2006-05-23
Last modified date
2006-06-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK14723
Modules/Macros
EDC4H048
SA227821XX |
Fix information
Fixed component name
LE C LIBRARY
Fixed component ID
568819805
Applicable component levels
R730 PSY UK14723
UP06/06/01 P F605
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCVSBD","label":"Runtime"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"730","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"730","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":null,"label":null},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"730","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 June 2006