From 3f7a61bd6e5efbadd4db3972efe51d1e218f368a Mon Sep 17 00:00:00 2001
From: Alex Willmer <alex@moreati.org.uk>
Date: Sun, 23 May 2021 14:39:03 +0100
Subject: [PATCH] Add RFC references for IP.Is<Property>() methods

These helped me to cross reference inet.af/netaddr, net.IP, and
github.com/mellowdrifter/bogons for #151.

Signed-off-by: Alex Willmer <alex@moreati.org.uk>
---
 netaddr.go | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/netaddr.go b/netaddr.go
index 4639205..fe1d8a5 100644
--- a/netaddr.go
+++ b/netaddr.go
@@ -537,9 +537,13 @@ func (ip IP) WithZone(zone string) IP {
 // IsLinkLocalUnicast reports whether ip is a link-local unicast address.
 // If ip is the zero value, it will return false.
 func (ip IP) IsLinkLocalUnicast() bool {
+	// Dynamic Configuration of IPv4 Link-Local Addresses
+	// https://datatracker.ietf.org/doc/html/rfc3927#section-2.1
 	if ip.Is4() {
 		return ip.v4(0) == 169 && ip.v4(1) == 254
 	}
+	// IP Version 6 Addressing Architecture (2.5.6 Link-Local IPv6 Unicast Addresses)
+	// https://datatracker.ietf.org/doc/html/rfc4291#section-2.5.6
 	if ip.Is6() {
 		return ip.v6u16(0) == 0xfe80
 	}
@@ -549,9 +553,13 @@ func (ip IP) IsLinkLocalUnicast() bool {
 // IsLoopback reports whether ip is a loopback address. If ip is the zero value,
 // it will return false.
 func (ip IP) IsLoopback() bool {
+	// Requirements for Internet Hosts -- Communication Layers (3.2.1.3 Addressing)
+	// https://datatracker.ietf.org/doc/html/rfc1122#section-3.2.1.3
 	if ip.Is4() {
 		return ip.v4(0) == 127
 	}
+	// IP Version 6 Addressing Architecture (2.5.3 The Loopback Address)
+	// https://datatracker.ietf.org/doc/html/rfc4291#section-2.5.3
 	if ip.Is6() {
 		return ip.addr.hi == 0 && ip.addr.lo == 1
 	}
@@ -561,6 +569,8 @@ func (ip IP) IsLoopback() bool {
 // IsMulticast reports whether ip is a multicast address. If ip is the zero
 // value, it will return false.
 func (ip IP) IsMulticast() bool {
+	// Host Extensions for IP Multicasting (4. HOST GROUP ADDRESSES)
+	// https://datatracker.ietf.org/doc/html/rfc1112#section-4
 	if ip.Is4() {
 		return ip.v4(0)&0xf0 == 0xe0
 	}
@@ -574,6 +584,8 @@ func (ip IP) IsMulticast() bool {
 // multicast address. If ip is the zero value or an IPv4 address, it will return
 // false.
 func (ip IP) IsInterfaceLocalMulticast() bool {
+	// IPv6 Addressing Architecture (2.7.1. Pre-Defined Multicast Addresses)
+	// https://datatracker.ietf.org/doc/html/rfc4291#section-2.7.1
 	if ip.Is6() {
 		return ip.v6u16(0)&0xff0f == 0xff01
 	}
@@ -583,9 +595,13 @@ func (ip IP) IsInterfaceLocalMulticast() bool {
 // IsLinkLocalMulticast reports whether ip is a link-local multicast address.
 // If ip is the zero value, it will return false.
 func (ip IP) IsLinkLocalMulticast() bool {
+	// IPv4 Multicast Guidelines (4. Local Network Control Block (224.0.0/24))
+	// https://datatracker.ietf.org/doc/html/rfc5771#section-4
 	if ip.Is4() {
 		return ip.v4(0) == 224 && ip.v4(1) == 0 && ip.v4(2) == 0
 	}
+	// IPv6 Addressing Architecture (2.7.1. Pre-Defined Multicast Addresses)
+	// https://datatracker.ietf.org/doc/html/rfc4291#section-2.7.1
 	if ip.Is6() {
 		return ip.v6u16(0)&0xff0f == 0xff02
 	}