l4_ipc_send_deceiting -- deceite send operation

1 Synopsis

#include <l4/sys/ipc.h>

static inline int
l4_ipc_send_deceiting(l4_ipc_deceit_ids_t ids , const void *snd_msg , l4_umword_t snd_dword0 , l4_umword_t snd_dword1 l4_timeout_t timeout , l4_msgdope_t *result );

2 Description

A chief can specify a virtual sender id in ids which the recipient should get instead of the chief's id. Recall that deceiting is secure since only direction-preserving deceit is possible. If the specified virtual sender id does not fulfill this constraint, the call works like l4_ipc_send().

3 Arguments

ids
Structure containg true and virtual sender id.
*snd_msg
Pointer to a Send Descriptor. It can contain the following values:

<mem>
Ipc includes sending a message to the destination specified by dest. *snd_msg must point to a valid message. The first two 32-bit words of the message have to be given separately in snd_dword0 and snd_dword1.
0
Ipc includes sending a message to the destination specified by dest. The message consists solely of the two 32-bit words snd_dword0 and snd_dword1.
snd_dword0
The first dword to be transmitted.
snd_dword1
The second dword to be transmitted.
timeout
This 32-bit word specifies all 4 timouts, the quadruple (snd, rcv, snd pf, rcv pf). For a detailed description see the L4 Reference Manual.
result
The message dope describing the result of the Ipc.

4 Return Values

The following return values are possible:

0
No error occured. The optional send operation was successful, and if a receive operation was also specified, a message was also received correctly.
L4_IPC_ENOT_EXISTENT
Non-existing destination or source.
L4_IPC_RETIMEOUT
Timeout during receive operation.
L4_IPC_SETIMEOUT
Timeout during send operation.
L4_IPC_RECANCELED
Receive operation cancelled by another thread.
L4_IPC_SECANCELED
Send operation cancelled by another thread.
L4_IPC_REMAPFAILED
Map failed due to a shortage of page tables during receive operation.
L4_IPC_SEMAPFAILED
Map failed due to a shortage of page tables during send operation.
L4_IPC_RESNDPFTO
Send pagefault timeout.
L4_IPC_SERCVPFTO
Receive pagefault timeout.
L4_IPC_REABORTED
Receive operation aborted by another thread.
L4_IPC_SEABORTED
Send operation aborted by another thread.
L4_IPC_REMSGCUT
Received message cut. Potential reasons are:

(a)
The recipient's mword buffer is too small.
(b)
The recipient does not accept enough strings.
(c)
At least one of the recipient's string buffers is too small.

5 See Also

l4_ipc , l4_ipc_receive , l4_ipc_reply_and_wait , l4_ipc_reply_deceiting_and_wait , l4_ipc_send , l4_ipc_call , l4_ipc_wait
Ich