NAME
dacs_remote_mem_accept
- Accept a memory handle from a remote process.
SYNOPSIS
DACS_ERR_T
dacs_remote_mem_accept ( de_id_t src_de, dacs_process_id_t src_pid,
dacs_remote_mem_t *mem )
| Call parameters |
|
| src_de |
The source DE which is sharing the remote memory handle. |
| src_pid |
The source process which is sharing the remote memory
handle. |
| Return parameter |
|
| *mem |
A pointer to the accepted memory handle. |
DESCRIPTION
The dacs_remote_mem_accept service
blocks the caller until it receives a remote memory handle from an associated dacs_remote_mem_share() call.
The remote memory handle is filled in upon successful return.
RETURN VALUE
The
dacs_remote_mem_accept service
returns an error indicator defined as:
- DACS_SUCCESS: normal return.
- 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_ADDR: the pointer is invalid.
- DACS_ERR_NO_RESOURCE: unable to allocate the required
resources.