Index: mojo/public/c/environment/async_waiter.h |
diff --git a/mojo/public/c/environment/async_waiter.h b/mojo/public/c/environment/async_waiter.h |
deleted file mode 100644 |
index b5a1f7523fe6b329981050bdc76f2e6d35eb517a..0000000000000000000000000000000000000000 |
--- a/mojo/public/c/environment/async_waiter.h |
+++ /dev/null |
@@ -1,65 +0,0 @@ |
-// Copyright 2014 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_PUBLIC_C_ENVIRONMENT_ASYNC_WAITER_H_ |
-#define MOJO_PUBLIC_C_ENVIRONMENT_ASYNC_WAITER_H_ |
- |
-#include "mojo/public/c/system/types.h" |
- |
-typedef uintptr_t MojoAsyncWaitID; |
- |
-typedef void (*MojoAsyncWaitCallback)(void* closure, MojoResult result); |
- |
-// Functions for asynchronously waiting (and cancelling asynchronous waits) on a |
-// handle. |
-// |
-// Thread-safety: |
-// - |CancelWait(wait_id)| may only be called on the same thread as the |
-// |AsyncWait()| that provided |wait_id| was called on. |
-// - A given |MojoAsyncWaiter|'s functions may only be called on the thread(s) |
-// that it is defined to be valid on (typically including the thread on |
-// which the |MojoAsyncWaiter| was provided). E.g., a library may require |
-// initialization with a single |MojoAsyncWaiter| and stipulate that it only |
-// be used on threads on which that |MojoAsyncWaiter| is valid. |
-// - If a |MojoAsyncWaiter| is valid on multiple threads, then its functions |
-// must be thread-safe (subject to the first restriction above). |
-struct MojoAsyncWaiter { |
- // Arranges for |callback| to be called on the current thread at some future |
- // when |handle| satisfies |signals| or it is known that it will never satisfy |
- // |signals| (with the same behavior as |MojoWait()|). |
- // |
- // |callback| will not be called in the nested context of |AsyncWait()|, but |
- // only, e.g., from some run loop. |callback| is provided with the |closure| |
- // argument as well as the result of the wait. For each call to |AsyncWait()|, |
- // |callback| will be called at most once. |
- // |
- // |handle| must not be closed or transferred (via |MojoWriteMessage()|; this |
- // is equivalent to closing the handle) until either the callback has been |
- // executed or the async wait has been cancelled using the returned (nonzero) |
- // |MojoAsyncWaitID| (see |CancelWait()|). Otherwise, an invalid (or, worse, |
- // re-used) handle may be waited on by the implementation of this |
- // |MojoAsyncWaiter|. |
- // |
- // Note that once the callback has been called, the returned |MojoAsyncWaitID| |
- // becomes invalid. |
- MojoAsyncWaitID (*AsyncWait)(MojoHandle handle, |
- MojoHandleSignals signals, |
- MojoDeadline deadline, |
- MojoAsyncWaitCallback callback, |
- void* closure); |
- |
- // Cancels an outstanding async wait (specified by |wait_id|) initiated by |
- // |AsyncWait()|. This may only be called from the same thread on which the |
- // corresponding |AsyncWait()| was called, and may only be called if the |
- // callback to |AsyncWait()| has not been called. |
- // |
- // Once this has been called, the callback provided to |AsyncWait()| will not |
- // be called. Moreover, it is then immediately safe to close or transfer the |
- // handle provided to |AsyncWait()|. (I.e., the implementation of this |
- // |MojoAsyncWaiter| will no longer wait on, or do anything else with, the |
- // handle.) |
- void (*CancelWait)(MojoAsyncWaitID wait_id); |
-}; |
- |
-#endif // MOJO_PUBLIC_C_ENVIRONMENT_ASYNC_WAITER_H_ |