1door_return(3C)          Standard C Library Functions          door_return(3C)
2
3
4

NAME

6       door_return - return from a door invocation
7

SYNOPSIS

9       cc -mt [ flag... ] file... [ library... ]
10       #include <door.h>
11
12       int door_return(char *data_ptr, size_t data_size, door_desc_t *desc_ptr,
13            uint_t num_desc);
14
15

DESCRIPTION

17       The  door_return()  function returns from a door invocation. It returns
18       control to the thread that issued the associated door_call() and blocks
19       waiting  for  the  next door invocation. See door_call(3C). Results, if
20       any, from the door invocation are passed back  to  the  client  in  the
21       buffers  pointed  to by data_ptr and desc_ptr. If there is not a client
22       associated with the door_return(),  the  calling  thread  discards  the
23       results,   releases   any  passed  descriptors  with  the  DOOR_RELEASE
24       attribute, and blocks waiting for the next door invocation.
25

RETURN VALUES

27       Upon successful completion, door_return() does not return to the  call‐
28       ing process. Otherwise, door_return() returns −1 to the calling process
29       and sets errno to indicate the error.
30

ERRORS

32       The  door_return() function fails and returns to  the  calling  process
33       if:
34
35       E2BIG     Arguments were too big for client.
36
37
38       EFAULT    The address of data_ptr or desc_ptr is invalid.
39
40
41       EINVAL    Invalid  door_return()  arguments  were passed or a thread is
42                 bound to a door that no longer exists.
43
44
45       EMFILE    The client has too many open descriptors.
46
47

ATTRIBUTES

49       See attributes(5) for descriptions of the following attributes:
50
51
52
53
54       ┌─────────────────────────────┬─────────────────────────────┐
55       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
56       ├─────────────────────────────┼─────────────────────────────┤
57       │Architecture                 │all                          │
58       ├─────────────────────────────┼─────────────────────────────┤
59       │Availability                 │SUNWcsu                      │
60       ├─────────────────────────────┼─────────────────────────────┤
61       │Interface Stability          │Stable                       │
62       ├─────────────────────────────┼─────────────────────────────┤
63       │MT-Level                     │Safe                         │
64       └─────────────────────────────┴─────────────────────────────┘
65

SEE ALSO

67       door_call(3C),attributes(5)
68
69
70
71SunOS 5.11                        22 Mar 2005                  door_return(3C)
Impressum