Add different behavior to AwakableList for "persistent" vs "one-shot" awakables.

mojo/edk/system/dispatcher.h

 // Copyright 2013 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 MOJO_EDK_SYSTEM_DISPATCHER_H_
 #define MOJO_EDK_SYSTEM_DISPATCHER_H_
 
 #include <stddef.h>
 #include <stdint.h>
 
@@ skipping 175 matching lines @@
   // returns a default-constructed |HandleSignalsState|, i.e., no signals
   // satisfied or satisfiable.) Note: The state is subject to change from other
   // threads.
   HandleSignalsState GetHandleSignalsState() const;
 
   // Adds an awakable to this dispatcher, which will be woken up when this
   // object changes state to satisfy |signals| with context |context|. It will
   // also be woken up when it becomes impossible for the object to ever satisfy
   // |signals| with a suitable error status.
   //
-  // If |force| is true, the awakable will be added even if |signals| is already
-  // satisfied or is never-satisfiable (if it is possible that some other change
-  // will cause it to become satisfiable again).
+  // If |persistent| is true, the awakable will be added even if |signals| is
+  // already satisfied or is never-satisfiable (if it is possible that some
+  // other change will cause it to become satisfiable again).
   //
   // If |signals_state| is non-null, |*signals_state| will be set to the current
   // handle signals state.
   //
   // Any awakable that's added must either eventually be removed (using
   // |RemoveAwakable()|, below). If an awakable's |Awake()| is called (by this
   // dispatcher) and it returns false, that is equivalent to |RemoveAwakable()|
   // being called (with |match_context| true) for that awakable and the context
   // passed to |Awake()|.
   //
   // Returns:
   //  - |MOJO_RESULT_OK| if the awakable was added;
   //  - |MOJO_RESULT_ALREADY_EXISTS| if |signals| is already satisfied (if
-  //    |force| is true, the awakable will still be added);
+  //    |persistent| is true, the awakable will still be added);
   //  - |MOJO_RESULT_INVALID_ARGUMENT| if the dispatcher has been closed; and
   //  - |MOJO_RESULT_FAILED_PRECONDITION| if it is not (or no longer) possible
-  //    that |signals| will ever be satisfied(if |force| is true, the awakable
-  //    will still be added).
+  //    that |signals| will ever be satisfied(if |persistent| is true, the
+  //    awakable will still be added).
   MojoResult AddAwakable(Awakable* awakable,
                          uint64_t context,
-                         bool force,
+                         bool persistent,
                          MojoHandleSignals signals,
                          HandleSignalsState* signals_state);
   // Removes an awakable from this dispatcher. This will remove all instances
   // matching the awakable pointer and, if |match_context| is true, the context
   // (if |match_context| is false, |context| is ignored). It is valid to call
   // this multiple times for the same |awakable| on the same object.) If
   // |signals_state| is non-null, |*signals_state| will be set to the current
   // handle signals state.
   void RemoveAwakable(bool match_context,
                       Awakable* awakable,
@@ skipping 163 matching lines @@
       uint64_t cookie);
   virtual MojoResult WaitSetRemoveImpl(uint64_t cookie);
   virtual MojoResult WaitSetWaitImpl(MojoDeadline deadline,
                                      UserPointer<uint32_t> num_results,
                                      UserPointer<MojoWaitSetResult> results,
                                      UserPointer<uint32_t> max_results);
   virtual HandleSignalsState GetHandleSignalsStateImplNoLock() const
       MOJO_SHARED_LOCKS_REQUIRED(mutex_);
   virtual MojoResult AddAwakableImplNoLock(Awakable* awakable,
                                            uint64_t context,
-                                           bool force,
+                                           bool persistent,
                                            MojoHandleSignals signals,
                                            HandleSignalsState* signals_state)
       MOJO_EXCLUSIVE_LOCKS_REQUIRED(mutex_);
   virtual void RemoveAwakableImplNoLock(bool match_context,
                                         Awakable* awakable,
                                         uint64_t context,
                                         HandleSignalsState* signals_state)
       MOJO_EXCLUSIVE_LOCKS_REQUIRED(mutex_);
 
   // These implement the API used to serialize dispatchers to a |Channel|
@@ skipping 100 matching lines @@
 
 // So logging macros and |DCHECK_EQ()|, etc. work.
 inline std::ostream& operator<<(std::ostream& out, Dispatcher::Type type) {
   return out << static_cast<int>(type);
 }
 
 }  // namespace system
 }  // namespace mojo
 
 #endif  // MOJO_EDK_SYSTEM_DISPATCHER_H_