paho.mqtt.c icon indicating copy to clipboard operation
paho.mqtt.c copied to clipboard

Published 20 hours ago • verified publisher icon eclipse

Update getaddrinfo options to support IPv6 hostname resolution

Open cwardcode opened this issue 9 months ago • 3 comments

Updated the hints struct to pass the AI_ADDRCONFIG flag to the ai_flags property, addressing issue #1396.

Description:

This ensures hostnames are translated to the correct IP address based on the system’s network configuration, improving compatibility across different environments.

According to the getaddrinfo(3) manual:

     ai_flags       The ai_flags field to which the hints parameter points shall be set to zero or be the bitwise-inclusive OR of one or more of the values AI_ADDRCONFIG, AI_ALL, AI_CANONNAME, AI_NUMERICHOST, AI_NUMERICSERV, AI_PASSIVE, AI_V4MAPPED,
                    AI_V4MAPPED_CFG, and AI_DEFAULT.

                    AI_ADDRCONFIG   If the AI_ADDRCONFIG bit is set, IPv4 addresses shall be returned only if an IPv4 address is configured on the local system, and IPv6 addresses shall be returned only if an IPv6 address is configured on the local
                                    system.

Cross-Platform Considerations:

This change has been tested on Linux, where it allows seamless connections to dual-stack endpoint brokers regardless of whether the device is configured for IPv4, IPv6, or both. While behavior may vary slightly across operating systems, AI_ADDRCONFIG is widely supported, including macOS and Linux variants. On Windows, AI_ADDRCONFIG is also respected on Windows Vista and later.

Testing & Verification:

  • Verified via the Linux platform
  • Successfully connected to a dual-stack endpoint from an IPv6-only device.
  • Confirmed proper resolution and connectivity when only IPv4 is available.
  • Verified no regressions, with all existing tests passing.

This update enhances network flexibility while maintaining full backward compatibility.

cwardcode avatar Feb 19 '25 15:02 cwardcode

How much difference will this make? Does it help you?

icraggs avatar Feb 20 '25 14:02 icraggs

Yes actually. With this change I can now connect to AWS’s IoT endpoint in an IPv6-only environment, whereas without the AI_ADDRCONFIG, I cannot.

cwardcode avatar Feb 20 '25 15:02 cwardcode

@icraggs,

I see that this is targeted for 1.3.15 / https://github.com/eclipse-paho/paho.mqtt.c/milestone/22. Do you know when that is likely to release?

dls314 avatar Mar 31 '25 13:03 dls314