From 509cd1b7df863694058f9374e2992a36e40d5bc1 Mon Sep 17 00:00:00 2001
From: Tommaso Pecorella <tommaso.pecorella@unifi.it>
Date: Sat, 21 Nov 2015 17:59:27 +0100
Subject: [PATCH] Deprecate Ipv6Address::IsAllHostsMulticast()

---
 RELEASE_NOTES                    | 2 ++
 src/network/utils/ipv6-address.h | 6 +++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES b/RELEASE_NOTES
index d5c3eb748..0c084fbba 100644
--- a/RELEASE_NOTES
+++ b/RELEASE_NOTES
@@ -34,6 +34,8 @@ New user-visible features
 - (internet) L4 protocols (e.g., TCP, UDP, ICMP, etc.) can be demultiplexed by IP
   according to the incoming interface. In other words, it is now possible to
   use specialized L4 protocols according to the interface.
+- (internet) Ipv6Address::IsAllHostsMulticast() is now deprecated. FF02::3 is not
+  in the official reserved IPv6 multicast address list.
 
 Bugs fixed
 ----------
diff --git a/src/network/utils/ipv6-address.h b/src/network/utils/ipv6-address.h
index 2631545f6..4332c6970 100644
--- a/src/network/utils/ipv6-address.h
+++ b/src/network/utils/ipv6-address.h
@@ -29,6 +29,7 @@
 #include "ns3/attribute-helper.h"
 #include "ns3/address.h"
 #include "ns3/ipv4-address.h"
+#include "ns3/deprecated.h"
 
 namespace ns3 { 
 
@@ -223,9 +224,12 @@ public:
 
   /**
    * \brief If the IPv6 address is "all hosts multicast" (ff02::3/8).
+   *
+   * This function is deprecated because the address has been removed from RFCs.
+   *
    * \return true if "all hosts multicast", false otherwise
    */
-  bool IsAllHostsMulticast () const;
+  bool IsAllHostsMulticast () const NS_DEPRECATED;
 
   /**
    * \brief If the IPv6 address is a link-local address (fe80::/64).