diff options
| author | Volker Hilsheimer <volker.hilsheimer@qt.io> | 2019-04-24 17:44:30 +0200 |
|---|---|---|
| committer | Volker Hilsheimer <volker.hilsheimer@qt.io> | 2019-04-25 22:24:08 +0000 |
| commit | a8a05b00fc8401e518c70b5deffc383d1081ede3 (patch) | |
| tree | 95565f1e23fe76c1be295ef909abea2da305efa0 /src/network | |
| parent | 913dd26c92f406e3da83ed83701ce47e659bcc48 (diff) | |
Document that QHostInfo does not guarantee to return all IP addresses
Using getaddrinfo, which implements RFC 6724, implies that addresses
that are not needed will be trimmed. In particular, IPv6 addresses are
often not returned.
Also move the implementation detail documentation down in the text, it's
a detail with little relevance for the usage of the class, but makes for
a good opener regarding this behavior.
Change-Id: I516a64f0b39a6a06621a63c1d5236544b7758049
Fixes: QTBUG-31865
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
Diffstat (limited to 'src/network')
| -rw-r--r-- | src/network/kernel/qhostinfo.cpp | 11 |
1 files changed, 8 insertions, 3 deletions
diff --git a/src/network/kernel/qhostinfo.cpp b/src/network/kernel/qhostinfo.cpp index 0973d0dd52..4d451dfdb7 100644 --- a/src/network/kernel/qhostinfo.cpp +++ b/src/network/kernel/qhostinfo.cpp @@ -137,8 +137,7 @@ void emit_results_ready(const QHostInfo &hostInfo, const QObject *receiver, \inmodule QtNetwork \ingroup network - QHostInfo uses the lookup mechanisms provided by the operating - system to find the IP address(es) associated with a host name, + QHostInfo finds the IP address(es) associated with a host name, or the host name associated with an IP address. The class provides two static convenience functions: one that works asynchronously and emits a signal once the host is found, @@ -173,6 +172,11 @@ void emit_results_ready(const QHostInfo &hostInfo, const QObject *receiver, To retrieve the name of the local host, use the static QHostInfo::localHostName() function. + QHostInfo uses the mechanisms provided by the operating system + to perform the lookup. As per {https://tools.ietf.org/html/rfc6724}{RFC 6724} + there is no guarantee that all IP addresses registered for a domain or + host will be returned. + \note Since Qt 4.6.1 QHostInfo is using multiple threads for DNS lookup instead of one dedicated DNS thread. This improves performance, but also changes the order of signal emissions when using lookupHost() @@ -180,7 +184,8 @@ void emit_results_ready(const QHostInfo &hostInfo, const QObject *receiver, \note Since Qt 4.6.3 QHostInfo is using a small internal 60 second DNS cache for performance improvements. - \sa QAbstractSocket, {http://www.rfc-editor.org/rfc/rfc3492.txt}{RFC 3492} + \sa QAbstractSocket, {http://www.rfc-editor.org/rfc/rfc3492.txt}{RFC 3492}, + {https://tools.ietf.org/html/rfc6724}{RFC 6724} */ static int nextId() |