// Copyright 2018 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 PLATFORM_BASE_IP_ADDRESS_H_ #define PLATFORM_BASE_IP_ADDRESS_H_ #include #include #include #include #include #include "platform/base/error.h" namespace openscreen { class IPAddress { public: enum class Version { kV4, kV6, }; static constexpr IPAddress kAnyV4() { return IPAddress{0, 0, 0, 0}; } static constexpr IPAddress kAnyV6() { return IPAddress{0, 0, 0, 0, 0, 0, 0, 0}; } static constexpr IPAddress kV4LoopbackAddress() { return IPAddress{127, 0, 0, 1}; } static constexpr IPAddress kV6LoopbackAddress() { return IPAddress{0, 0, 0, 0, 0, 0, 0, 1}; } static constexpr size_t kV4Size = 4; static constexpr size_t kV6Size = 16; constexpr IPAddress() : version_(Version::kV4), bytes_({}) {} // |bytes| contains 4 octets for IPv4, or 8 hextets (16 bytes of big-endian // shorts) for IPv6. IPAddress(Version version, const uint8_t* bytes); // IPv4 constructors (IPAddress from 4 octets). explicit constexpr IPAddress(const std::array& bytes) : version_(Version::kV4), bytes_{{bytes[0], bytes[1], bytes[2], bytes[3]}} {} explicit constexpr IPAddress(const uint8_t (&b)[4]) : version_(Version::kV4), bytes_{{b[0], b[1], b[2], b[3]}} {} constexpr IPAddress(uint8_t b1, uint8_t b2, uint8_t b3, uint8_t b4) : version_(Version::kV4), bytes_{{b1, b2, b3, b4}} {} // IPv6 constructors (IPAddress from 8 hextets). explicit constexpr IPAddress(const std::array& hextets) : IPAddress(hextets[0], hextets[1], hextets[2], hextets[3], hextets[4], hextets[5], hextets[6], hextets[7]) {} explicit constexpr IPAddress(const uint16_t (&hextets)[8]) : IPAddress(hextets[0], hextets[1], hextets[2], hextets[3], hextets[4], hextets[5], hextets[6], hextets[7]) {} constexpr IPAddress(uint16_t h0, uint16_t h1, uint16_t h2, uint16_t h3, uint16_t h4, uint16_t h5, uint16_t h6, uint16_t h7) : version_(Version::kV6), bytes_{{ static_cast(h0 >> 8), static_cast(h0), static_cast(h1 >> 8), static_cast(h1), static_cast(h2 >> 8), static_cast(h2), static_cast(h3 >> 8), static_cast(h3), static_cast(h4 >> 8), static_cast(h4), static_cast(h5 >> 8), static_cast(h5), static_cast(h6 >> 8), static_cast(h6), static_cast(h7 >> 8), static_cast(h7), }} {} constexpr IPAddress(const IPAddress& o) noexcept = default; constexpr IPAddress(IPAddress&& o) noexcept = default; ~IPAddress() = default; constexpr IPAddress& operator=(const IPAddress& o) noexcept = default; constexpr IPAddress& operator=(IPAddress&& o) noexcept = default; bool operator==(const IPAddress& o) const; bool operator!=(const IPAddress& o) const; // IP address comparison rules are based on the following two principles: // 1. newer versions are greater, e.g. IPv6 > IPv4 // 2. higher numerical values are greater, e.g. 192.168.0.1 > 10.0.0.1 bool operator<(const IPAddress& other) const; bool operator>(const IPAddress& other) const { return other < *this; } bool operator<=(const IPAddress& other) const { return !(other < *this); } bool operator>=(const IPAddress& other) const { return !(*this < other); } explicit operator bool() const; Version version() const { return version_; } bool IsV4() const { return version_ == Version::kV4; } bool IsV6() const { return version_ == Version::kV6; } // These methods assume |x| is the appropriate size, but due to various // callers' casting needs we can't check them like the constructors above. // Callers should instead make any necessary checks themselves. void CopyToV4(uint8_t* x) const; void CopyToV6(uint8_t* x) const; // In some instances, we want direct access to the underlying byte storage, // in order to avoid making multiple copies. const uint8_t* bytes() const { return bytes_.data(); } // Parses a text representation of an IPv4 address (e.g. "192.168.0.1") or an // IPv6 address (e.g. "abcd::1234"). static ErrorOr Parse(const std::string& s); private: Version version_; std::array bytes_; }; struct IPEndpoint { public: IPAddress address; uint16_t port = 0; // Used with various socket types to indicate "any" address. static const IPEndpoint kAnyV4(); static const IPEndpoint kAnyV6(); explicit operator bool() const; // Parses a text representation of an IPv4/IPv6 address and port (e.g. // "192.168.0.1:8080" or "[abcd::1234]:8080"). static ErrorOr Parse(const std::string& s); std::string ToString() const; }; bool operator==(const IPEndpoint& a, const IPEndpoint& b); bool operator!=(const IPEndpoint& a, const IPEndpoint& b); bool operator<(const IPEndpoint& a, const IPEndpoint& b); inline bool operator>(const IPEndpoint& a, const IPEndpoint& b) { return b < a; } inline bool operator<=(const IPEndpoint& a, const IPEndpoint& b) { return !(a > b); } inline bool operator>=(const IPEndpoint& a, const IPEndpoint& b) { return !(a < b); } // Outputs a string of the form: // 123.234.34.56 // or fe80:0000:0000:0000:1234:5678:9abc:def0 std::ostream& operator<<(std::ostream& out, const IPAddress& address); // Outputs a string of the form: // 123.234.34.56:443 // or [fe80:0000:0000:0000:1234:5678:9abc:def0]:8080 std::ostream& operator<<(std::ostream& out, const IPEndpoint& endpoint); } // namespace openscreen #endif // PLATFORM_BASE_IP_ADDRESS_H_