door_return(3X)

NAME

door_return − return from a door invocation

SYNOPSIS

#include <door.h>
int door_return(void ∗data_ptr, size_t data_size,

door_desc_t ∗desc_ptr, size_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(3X). 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 and blocks waiting for the next door invocation.

RETURN VALUES

Upon successful completion, door_return() does not return to the calling process. Upon failure, 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 one or more of the following are true:

EINVAL Invalid door_return() arguments were passed.

EFAULT The address of data_ptr or desc_ptr is invalid.

Museum