Use continual gathering to restore backup connections

webrtc/p2p/base/portinterface.h

 /*
  *  Copyright 2012 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.
  */
 
@@ skipping 60 matching lines @@
   virtual Connection* CreateConnection(
       const Candidate& remote_candidate, CandidateOrigin origin) = 0;
 
   // Functions on the underlying socket(s).
   virtual int SetOption(rtc::Socket::Option opt, int value) = 0;
   virtual int GetOption(rtc::Socket::Option opt, int* value) = 0;
   virtual int GetError() = 0;
 
   virtual const std::vector<Candidate>& Candidates() const = 0;
 
+  // A port is closed when it is not actively used. A closed port will not be
+  // used to create connections except when it receives stun requests from
+  // unknown addresses, although the connections on it may still be used.
+  virtual void Close() = 0;
+
   // Sends the given packet to the given address, provided that the address is
   // that of a connection or an address that has sent to us already.
   virtual int SendTo(const void* data, size_t size,
                      const rtc::SocketAddress& addr,
                      const rtc::PacketOptions& options, bool payload) = 0;
 
   // Indicates that we received a successful STUN binding request from an
   // address that doesn't correspond to any current connection.  To turn this
   // into a real connection, call CreateConnection.
   sigslot::signal6<PortInterface*, const rtc::SocketAddress&,
                    ProtocolType, IceMessage*, const std::string&,
                    bool> SignalUnknownAddress;
 
   // Sends a response message (normal or error) to the given request.  One of
   // these methods should be called as a response to SignalUnknownAddress.
   // NOTE: You MUST call CreateConnection BEFORE SendBindingResponse.
   virtual void SendBindingResponse(StunMessage* request,
                                    const rtc::SocketAddress& addr) = 0;
   virtual void SendBindingErrorResponse(
       StunMessage* request, const rtc::SocketAddress& addr,
       int error_code, const std::string& reason) = 0;
 
   // Signaled when this port decides to delete itself because it no longer has
   // any usefulness.
   sigslot::signal1<PortInterface*> SignalDestroyed;
 
-  // Signaled when the network used by this port becomes inactive.
-  sigslot::signal1<PortInterface*> SignalNetworkInactive;
+  // A closed port will not be used to create new connections except when
+  // receiving stun ping from unknown address.
+  sigslot::signal1<PortInterface*> SignalClosed;
 
   // Signaled when Port discovers ice role conflict with the peer.
   sigslot::signal1<PortInterface*> SignalRoleConflict;
 
   // Normally, packets arrive through a connection (or they result signaling of
   // unknown address).  Calling this method turns off delivery of packets
   // through their respective connection and instead delivers every packet
   // through this port.
   virtual void EnablePortPackets() = 0;
   sigslot::signal4<PortInterface*, const char*, size_t,
                    const rtc::SocketAddress&> SignalReadPacket;
 
   // Emitted each time a packet is sent on this port.
   sigslot::signal1<const rtc::SentPacket&> SignalSentPacket;
 
   virtual std::string ToString() const = 0;
 
+  virtual void FailAndDestroyConnections() = 0;
+
  protected:
   PortInterface() {}
 };
 
 }  // namespace cricket
 
 #endif  // WEBRTC_P2P_BASE_PORTINTERFACE_H_