NAME
dacs_mutex_share
- Share a mutual exclusion variable with a remote process.
SYNOPSIS
DACS_ERR_T
dacs_mutex_share ( de_id_t dst_de, dacs_process_id_t dst_pid,
dacs_mutex_t mutex )
| Call parameters |
|
| dst_de |
The target DE for the share. |
| dst_pid |
The target process for the share. |
| mutex |
The handle of the mutex that is to be shared. |
DESCRIPTION
The dacs_mutex_share service
shares the specified mutual exclusion variable between the current process
and the remote process specified by dst_de and dst_pid.
This service blocks the caller, waiting for the remote process to call dacs_mutex_accept() to
accept the mutex.
RETURN VALUE
The
dacs_mutex_share service
returns an error indicator defined as:
- DACS_SUCCESS: normal return; sharing succeeded.
- 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.
- DACS_ERR_INVALID_HANDLE: the specified mutex handle is
not valid.