DOOR_RETURN(3C)DOOR_RETURN(3C)NAME
door_return - return from a door invocation
SYNOPSIS
cc -mt [ flag... ] file... [ library... ]
#include <door.h>
int door_return(char *data_ptr, size_t data_size, door_desc_t *desc_ptr,
uint_t num_desc);
DESCRIPTION
The door_return() function returns from a door invocation. It returns
control to the thread that issued the associated door_call() and blocks
waiting for the next door invocation. See door_call(3C). Results, if
any, from the door invocation are passed back to the client in the
buffers pointed to by data_ptr and desc_ptr. If there is not a client
associated with the door_return(), the calling thread discards the
results, releases any passed descriptors with the DOOR_RELEASE
attribute, and blocks waiting for the next door invocation.
RETURN VALUES
Upon successful completion, door_return() does not return to the call‐
ing process. Otherwise, door_return() returns −1 to the calling process
and sets errno to indicate the error.
ERRORS
The door_return() function fails and returns to the calling process
if:
E2BIG
Arguments were too big for client.
EFAULT
The address of data_ptr or desc_ptr is invalid.
EINVAL
Invalid door_return() arguments were passed or a thread is
bound to a door that no longer exists.
EMFILE
The client has too many open descriptors.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Architecture │ all │
├────────────────────┼─────────────────┤
│Interface Stability │ Stable │
├────────────────────┼─────────────────┤
│MT-Level │ Safe │
└────────────────────┴─────────────────┘
SEE ALSOdoor_call(3C),attributes(5)
Mar 22, 2005 DOOR_RETURN(3C)