Multicast socket API

net/udp/udp_socket_libevent.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_UDP_UDP_SOCKET_LIBEVENT_H_
 #define NET_UDP_UDP_SOCKET_LIBEVENT_H_
 
+#include "base/hash_tables.h"
 #include "base/memory/ref_counted.h"
 #include "base/memory/scoped_ptr.h"
 #include "base/message_loop.h"
 #include "base/threading/non_thread_safe.h"
 #include "net/base/completion_callback.h"
 #include "net/base/net_export.h"
 #include "net/base/rand_callback.h"
 #include "net/base/io_buffer.h"
 #include "net/base/ip_endpoint.h"
 #include "net/base/net_log.h"
@@ skipping 87 matching lines @@
 
   // Sets corresponding flags in |socket_options_| to allow the socket
   // to share the local address to which the socket will be bound with
   // other processes. Should be called before Bind().
   void AllowAddressReuse();
 
   // Sets corresponding flags in |socket_options_| to allow sending
   // and receiving packets to and from broadcast addresses. Should be
   // called before Bind().
   void AllowBroadcast();
 

[scheib, 2013/04/02 18:25:17]

We should have tests in the /net/ directory. Probably they should have enough
coverage to land the additions to net first, then follow up with extensions
support using it.

+  // Join the multicast group.
+  // |group_address| is the group address to join, could be either
+  // IPv4 or IPv6 address.
+  int JoinGroup(const net::IPAddressNumber& group_address) const;
+
+  // Join the multicast group.

[scheib, 2013/04/02 18:25:17]

Leave ...

[Bei Zhang, 2013/04/05 00:38:59]

Done.

+  // |group_address| is the group address to join, could be either
+  // IPv4 or IPv6 address. If the socket hasn't joined the group,
+  // it will be ignored.
+  // It's optional to leave the multicast group before destroying
+  // the socket. It will be done by the OS.
+  int LeaveGroup(const net::IPAddressNumber& group_address) const;
+
+  // Set the time-to-live option for udp packets sent to the multicast

[scheib, 2013/04/02 18:25:17]

What unit is this int? seconds? ms?

[Bei Zhang, 2013/04/05 00:38:59]

This is measured by hops. So it's a unitless.

On 2013/04/02 18:25:17, scheib wrote:

+  // group address. Initially this value is 1. Cannot be negative or
+  // more than 255.
+  int SetMulticastTimeToLive(int timeToLive);
+
+  // Set the loopback flag for udp socket. If this flag is true, the host
+  // will receive package sent to the joined group from itself.
+  // Initially this value is true.
+  int SetMulticastLoopbackMode(bool loopback);
+
  private:
   static const int kInvalidSocket = -1;
 
   enum SocketOptions {
     SOCKET_OPTION_REUSE_ADDRESS = 1 << 0,
     SOCKET_OPTION_BROADCAST     = 1 << 1
   };
 
   class ReadWatcher : public MessageLoopForIO::Watcher {
    public:
@@ skipping 55 matching lines @@
   int InternalRecvFrom(IOBuffer* buf, int buf_len, IPEndPoint* address);
   int InternalSendTo(IOBuffer* buf, int buf_len, const IPEndPoint* address);
 
   // Applies |socket_options_| to |socket_|. Should be called before
   // Bind().
   int SetSocketOptions();
   int DoBind(const IPEndPoint& address);
   int RandomBind(const IPEndPoint& address);
 
   int socket_;
+  int sock_addr_family_;
 
   // Bitwise-or'd combination of SocketOptions. Specifies the set of
   // options that should be applied to |socket_| before Bind().
   int socket_options_;
 
   // How to do source port binding, used only when UDPSocket is part of
   // UDPClientSocket, since UDPServerSocket provides Bind.
   DatagramSocket::BindType bind_type_;
 
   // PRNG function for generating port numbers.
@@ skipping 29 matching lines @@
   CompletionCallback write_callback_;
 
   BoundNetLog net_log_;
 
   DISALLOW_COPY_AND_ASSIGN(UDPSocketLibevent);
 };
 
 }  // namespace net
 
 #endif  // NET_UDP_UDP_SOCKET_LIBEVENT_H_