Make it possible to keep the port allocator session running

webrtc/p2p/base/portallocator.h

Index: webrtc/p2p/base/portallocator.h
diff --git a/webrtc/p2p/base/portallocator.h b/webrtc/p2p/base/portallocator.h
index 6e3efa8c4144d69fdfbb71ba30c6c14c3c09b872..7c390761de24ebb13224d2c5c5be0ef1223bcc33 100644
--- a/webrtc/p2p/base/portallocator.h
+++ b/webrtc/p2p/base/portallocator.h
@@ -90,7 +90,10 @@ class PortAllocatorSession : public sigslot::has_slots<> {
 
   // Starts gathering STUN and Relay configurations.
   virtual void StartGettingPorts() = 0;
-  virtual void StopGettingPorts() = 0;
+  // If |keep_session_running| is true, stop all existing allocation
+  // sequences of the current session but keep the session running so that
+  // if it is needed, it may restart a new allocation sequence.
+  virtual void StopGettingPorts(bool keep_session_running) = 0;

[pthatcher1, 2015/09/26 00:56:43]

I think we should have two methods:

1. StopGettingPorts  // Stop forever
2. ClearGettingPorts  // Stop existing sequenes

Stop == Clear + running_ = false + maybe signal "done"


"Clear" could use a better name, though.

[honghaiz3, 2015/09/29 14:56:58]

Done.

   virtual bool IsGettingPorts() = 0;
 
   sigslot::signal2<PortAllocatorSession*, PortInterface*> SignalPortReady;