AwakableList: For persistent awakables, make Add() call Awake() with reason INITIALIZE.

mojo/edk/system/awakable_list.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_AWAKABLE_LIST_H_
 #define MOJO_EDK_SYSTEM_AWAKABLE_LIST_H_
 
 #include <stdint.h>
 
 #include <vector>
@@ skipping 27 matching lines @@
 
   // Adds an awakable, identified by its pointer and its context.
   //
   // An awakable may either be persistent or one-shot (non-persistent).
   //   - A one-shot's |Awake()| will be called at most once per |Add()|, and
   //     will only be called if a watched signal goes from unsatisfied to
   //     satisfied (|Awake()| will be called with reason
   //     |Awakable::AwakeReason::SATISFIED|), all watched signals become
   //     never-satisfiable (|Awakable::AwakeReason::UNSATISFIABLE|), or
   //     |CancelAndRemoveAll()| is called (|Awakable::AwakeReason::CANCELLED|).
-  //   - A persistent awakable's |Awake()| will be called for all state changes
-  //     on watched signals (with reason |Awakable::AwakeReason::CHANGED|) until
-  //     |CancelAndRemoveAll()| is called (at which point its |Awake()| will be
-  //     called a final time with reason |Awakable::AwakeReason::CANCELLED|).
+  //   - A persistent awakable's |Awake()| will be called inside |Add()| (under
+  //     any mutex protecting the |AwakableList()| -- this is similar to
+  //     |OnStateChange()|) (with reason |Awakable::AwakeReason::INITIALIZE|),
+  //     and then subsequently for all state changes on watched signals
+  //     (|Awakable::AwakeReason::CHANGED|) until |CancelAndRemoveAll()| is
+  //     called (at which point its |Awake()| will be called a final time with
+  //     reason |Awakable::AwakeReason::CANCELLED|).
   void Add(Awakable* awakable,
            uint64_t context,
            bool persistent,
-           MojoHandleSignals signals);
+           MojoHandleSignals signals,
+           const HandleSignalsState& current_state);
 
   // Removes all awakables matching the given pointer and, if |match_context| is
   // true, the given context.
   void Remove(bool match_context, Awakable* awakable, uint64_t context);
 
  private:
   struct AwakeInfo {
     AwakeInfo(Awakable* awakable,
               uint64_t context,
               bool persistent,
@@ skipping 12 matching lines @@
 
   AwakeInfoList awakables_;
 
   MOJO_DISALLOW_COPY_AND_ASSIGN(AwakableList);
 };
 
 }  // namespace system
 }  // namespace mojo
 
 #endif  // MOJO_EDK_SYSTEM_AWAKABLE_LIST_H_