1door_return(3C) Standard C Library Functions door_return(3C)
2
3
4
6 door_return - return from a door invocation
7
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
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
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
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
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
67 door_call(3C),attributes(5)
68
69
70
71SunOS 5.11 22 Mar 2005 door_return(3C)