IBM Support

PK22885: NEW FUNCTION: SIOCGIFCONF6 - GET INTERFACE CONFIGURATION FOR IPV6

A fix is available

Subscribe

You can track all active APARs for this component.

 

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:

    PK12351

  • APAR is sysrouted TO one or more of the following:

    UK14723

Modules/Macros

  • EDC4H048
    

Publications Referenced
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":""},{"Business Unit":{"code":"BU048","label":"IBM Software"}, "Product":{"code":"SG19M","label":"APARs - z/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"730","Edition":""},{"Business Unit":{"code":"BU048","label":"IBM Software"}, "Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"730","Edition":""}]

Document Information

Modified date:
03 June 2006