NAME
dacs_mutex_accept
- Receive a share on a mutual exclusion variable from a remote process.
SYNOPSIS
DACS_ERR_T
dacs_mutex_accept ( de_id_t src_de, dacs_process_id_t src_pid,
dacs_mutex_t *mutex )
| Call parameters |
|
| src_de |
The source DE which is sharing the mutex handle. |
| src_pid |
The source PID which is sharing the mutex handle. |
| Return parameter |
|
| *mutex |
A pointer to the handle of the accepted mutex. |
DESCRIPTION
The dacs_mutex_accept service
receives a mutual exclusion variable from a remote process. The service blocks
until the remote process shares the mutex with a call to dacs_mutex_share().
RETURN VALUE
The
dacs_mutex_accept service
returns an error indicator defined as:
- DACS_SUCCESS: normal return.
- DACS_ERR_INVALID_ADDR: the pointer is invalid.
- DACS_ERR_INVALID_DE: the specified DE is either invalid
or not reserved.
- DACS_ERR_INVALID_PID: the specified PID does not refer
to an active process.
- DACS_ERR_INVALID_TARGET: this operation is not allowed
for the target process.