Standard C Library Functions door_return(3C)
NAME
door_return - return from a door invocation
SYNOPSIS
cc -mt [ flag... ] file... [ library... ]
#include
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 associateddoor_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 bydata_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 theDOOR_RELEASE attribute, and blocks waiting for the next door
invocation.RETURN VALUES
Upon successful completion, door_return() does not return to
the calling 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 attri-
butes:SunOS 5.11 Last change: 22 Mar 2005 1
Standard C Library Functions door_return(3C)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Architecture | all ||_____________________________|_____________________________|
| Availability | SUNWcs ||_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | Safe |
|_____________________________|_____________________________|
SEE ALSO
door_call(3C),attributes(5)
SunOS 5.11 Last change: 22 Mar 2005 2