object_wait_one - wait for signals on an object
#include <magenta/syscalls.h>
mx_status_t mx_object_wait_one(mx_handle_t handle,
mx_signals_t signals,
mx_time deadline,
mx_signals_t* observed);
object_wait_one() is a blocking syscall which causes the caller to wait until at least one of the specified signals has been observed on the object handle refers to or deadline passes.
Upon return, if non-NULL, observed is a bitmap of all of the signals which were observed asserted on that object while waiting.
The observed signals may not reflect the actual state of the object's signals if the state of the object was modified by another thread or process. (For example, a Channel ceases asserting MX_CHANNEL_READABLE once the last message in its queue is read).
The deadline parameter specifies a deadline with respect to MX_CLOCK_MONOTONIC. MX_TIME_INFINITE is a special value meaning wait forever.
object_wait_one() returns MX_OK if any of signals were observed on the object before deadline passes.
In the event of MX_ERR_TIMED_OUT, observed may reflect state changes that occurred after the deadline passed, but before the syscall returned.
For any other return value, observed is undefined.
MX_ERR_INVALID_ARGS observed is an invalid pointer.
MX_ERR_BAD_HANDLE handle is not a valid handle.
MX_ERR_ACCESS_DENIED handle does not have MX_RIGHT_READ and may not be waited upon.
MX_ERR_CANCELED handle was invalidated (e.g., closed) during the wait.
MX_ERR_TIMED_OUT The specified deadline passed before any of the specified signals are observed on handle.
MX_ERR_NOT_SUPPORTED handle is a handle that cannot be waited on (for example, a Port handle).