summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDan Albert <danalbert@google.com>2024-05-02 23:11:20 +0000
committerDan Albert <danalbert@google.com>2024-05-02 23:12:06 +0000
commit26620a62ebf3dd901f5d33e65c57c98414a11df9 (patch)
tree7aec32740e2ec65fb9499c8255c3202bf8427f96
parentdc9c4118732034f71aa275843d4c09ee78536829 (diff)
downloadnative-26620a62ebf3dd901f5d33e65c57c98414a11df9.tar.gz
Define the error conditions for ALooper_pollOnce.
"Unrecoverable internal errors" here means that ALOOPER_POLL_ERROR will be returned if the internal epoll_wait call fails with something other than EINTR. I could say that explicitly, but I think the important info for the caller is "you're doomed, just abort". Bug: None Test: None Change-Id: I869f29122500ee8c71390cae1c28108a63088a77
-rw-r--r--include/android/looper.h5
1 files changed, 3 insertions, 2 deletions
diff --git a/include/android/looper.h b/include/android/looper.h
index dba2e89942..d80a3660a6 100644
--- a/include/android/looper.h
+++ b/include/android/looper.h
@@ -193,8 +193,9 @@ typedef int (*ALooper_callbackFunc)(int fd, int events, void* data);
* Returns ALOOPER_POLL_TIMEOUT if there was no data before the given timeout
* expired. The poll may also have been explicitly woken by ALooper_wake.
*
- * Returns ALOOPER_POLL_ERROR if an error occurred. The poll may also have been
- * explicitly woken by ALooper_wake.
+ * Returns ALOOPER_POLL_ERROR if the calling thread has no associated Looper or
+ * for unrecoverable internal errors. The poll may also have been explicitly
+ * woken by ALooper_wake.
*
* Returns a value >= 0 containing an identifier (the same identifier `ident`
* passed to ALooper_addFd()) if its file descriptor has data and it has no