Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

door_return(3c) [opensolaris man page]

door_return(3C) 					   Standard C Library Functions 					   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 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 attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Architecture |all | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ |Interface Stability |Stable | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
door_call(3C),attributes(5) SunOS 5.11 22 Mar 2005 door_return(3C)

Check Out this Related Man Page

door_return(3DOOR)					      Door Library Functions						door_return(3DOOR)

NAME
door_return - return from a door invocation SYNOPSIS
cc -mt [ flag ... ] file ... -ldoor [ 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(3DOOR). 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 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 attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Architecture |all | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+ SEE ALSO
door_call(3DOOR),libdoor(3LIB), attributes(5) SunOS 5.10 5 Feb 2001 door_return(3DOOR)
Man Page