Resolve RFC 6761 localhost names to loopback

net/base/net_util.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef NET_BASE_NET_UTIL_H_
 #define NET_BASE_NET_UTIL_H_
 
 #include "build/build_config.h"
 
 #if defined(OS_WIN)
@@ skipping 24 matching lines @@
 class Time;
 }
 
 namespace url {
 struct CanonHostInfo;
 struct Parsed;
 }
 
 namespace net {
 
+class AddressList;
+
 // This is a "forward declaration" to avoid including ip_address_number.h
 // Keep this in sync.
 typedef std::vector<unsigned char> IPAddressNumber;
 
 // Used by FormatUrl to specify handling of certain parts of the url.
 typedef uint32_t FormatUrlType;
 typedef uint32_t FormatUrlTypes;
 
 #if defined(OS_WIN)
 // Bluetooth address size. Windows Bluetooth is supported via winsock.
@@ skipping 292 matching lines @@
 // Maps the given AddressFamily to either AF_INET, AF_INET6 or AF_UNSPEC.
 NET_EXPORT_PRIVATE int ConvertAddressFamily(AddressFamily address_family);
 
 // Retuns the port field of the |sockaddr|.
 const uint16_t* GetPortFieldFromSockaddr(const struct sockaddr* address,
                                          socklen_t address_len);
 // Returns the value of port in |sockaddr| (in host byte ordering).
 NET_EXPORT_PRIVATE int GetPortFromSockaddr(const struct sockaddr* address,
                                            socklen_t address_len);
 
+// Resolves a localhost name (such as "localhost" or "localhost6") into
+// IP endpoints with the given port. Returns true if |host| is one of
+// the names that indicate a loopback and false otherwise. Special IPv6

[Ryan Sleevi, 2015/06/12 01:00:04]

Documentation: You seem to mix localhost with loopback here in the description,
without quantifying the distinction.

Without poking in the implementation, it seems you use them interchangably -
perhaps align on one (with the function name, it would seem 'local hostname' is
probably the preferred term)

[estark, 2015/06/12 05:59:46]

Done.

+// names (e.g. "localhost6") will resolve to an IPv6 address only,
+// whereas other names will resolve to both IPv4 and IPv6.
+NET_EXPORT_PRIVATE bool ResolveLocalHostname(const std::string& host,
+                                             uint16_t port,
+                                             AddressList* address_list);
+
 // Returns true if |host| is one of the names (e.g. "localhost") or IP
 // addresses (IPv4 127.0.0.0/8 or IPv6 ::1) that indicate a loopback.
 //
 // Note that this function does not check for IP addresses other than
 // the above, although other IP addresses may point to the local
 // machine.
 NET_EXPORT_PRIVATE bool IsLocalhost(const std::string& host);
 
 NET_EXPORT_PRIVATE bool IsLocalhostTLD(const std::string& host);
 
@@ skipping 45 matching lines @@
   DSCP_CS5  = 40,  // Video
   DSCP_EF   = 46,  // Voice
   DSCP_CS6  = 48,  // Voice
   DSCP_CS7  = 56,  // Control messages
   DSCP_LAST = DSCP_CS7
 };
 
 }  // namespace net
 
 #endif  // NET_BASE_NET_UTIL_H_