Bind a socket to a network if the network handle is set.

webrtc/base/asyncsocket.h

 /*
  *  Copyright 2004 The WebRTC Project Authors. All rights reserved.
  *
  *  Use of this source code is governed by a BSD-style license
  *  that can be found in the LICENSE file in the root of the source
  *  tree. An additional intellectual property rights grant can be found
  *  in the file PATENTS.  All contributing project authors may
  *  be found in the AUTHORS file in the root of the source tree.
  */
 
 #ifndef WEBRTC_BASE_ASYNCSOCKET_H_
 #define WEBRTC_BASE_ASYNCSOCKET_H_
 
 #include "webrtc/base/common.h"
 #include "webrtc/base/sigslot.h"
 #include "webrtc/base/socket.h"
 
 namespace rtc {
 
 // TODO: Remove Socket and rename AsyncSocket to Socket.
 
 // Provides the ability to perform socket I/O asynchronously.
 class AsyncSocket : public Socket {
  public:
   AsyncSocket();
   ~AsyncSocket() override;
 
   AsyncSocket* Accept(SocketAddress* paddr) override = 0;
 
+  virtual int BindToNetwork(NetworkHandle handle) = 0;

[pthatcher1, 2016/01/06 21:58:46]

Can you put a comment explaining when this should be called and what effect it
will have (Android needs it to specify the network it will be bound to).

Actually, now I think about it, I think we could avoid needing this at all.  See
my later comment for how.

[honghaiz3, 2016/01/12 20:36:41]

Acknowledged.

+
   // SignalReadEvent and SignalWriteEvent use multi_threaded_local to allow
   // access concurrently from different thread.
   // For example SignalReadEvent::connect will be called in AsyncUDPSocket ctor
   // but at the same time the SocketDispatcher maybe signaling the read event.
   // ready to read
   sigslot::signal1<AsyncSocket*,
                    sigslot::multi_threaded_local> SignalReadEvent;
   // ready to write
   sigslot::signal1<AsyncSocket*,
                    sigslot::multi_threaded_local> SignalWriteEvent;
@@ skipping 13 matching lines @@
   SocketAddress GetLocalAddress() const override;
   SocketAddress GetRemoteAddress() const override;
   int Bind(const SocketAddress& addr) override;
   int Connect(const SocketAddress& addr) override;
   int Send(const void* pv, size_t cb) override;
   int SendTo(const void* pv, size_t cb, const SocketAddress& addr) override;
   int Recv(void* pv, size_t cb) override;
   int RecvFrom(void* pv, size_t cb, SocketAddress* paddr) override;
   int Listen(int backlog) override;
   AsyncSocket* Accept(SocketAddress* paddr) override;
+  int BindToNetwork(NetworkHandle handle) override;
   int Close() override;
   int GetError() const override;
   void SetError(int error) override;
   ConnState GetState() const override;
   int EstimateMTU(uint16_t* mtu) override;
   int GetOption(Option opt, int* value) override;
   int SetOption(Option opt, int value) override;
 
  protected:
   virtual void OnConnectEvent(AsyncSocket* socket);
   virtual void OnReadEvent(AsyncSocket* socket);
   virtual void OnWriteEvent(AsyncSocket* socket);
   virtual void OnCloseEvent(AsyncSocket* socket, int err);
 
   AsyncSocket* socket_;
 };
 
 }  // namespace rtc
 
 #endif  // WEBRTC_BASE_ASYNCSOCKET_H_