OLD | NEW |
| (Empty) |
1 /* | |
2 * Copyright (c) 2011 The Native Client Authors. All rights reserved. | |
3 * Use of this source code is governed by a BSD-style license that can be | |
4 * found in the LICENSE file. | |
5 */ | |
6 | |
7 #ifndef NATIVE_CLIENT_SRC_TRUSTED_SERVICE_RUNTIME_NAME_SERVICE_NAME_SERVICE_H_ | |
8 #define NATIVE_CLIENT_SRC_TRUSTED_SERVICE_RUNTIME_NAME_SERVICE_NAME_SERVICE_H_ | |
9 | |
10 #include "native_client/src/include/nacl_base.h" | |
11 #include "native_client/src/include/portability.h" | |
12 | |
13 /* Get NACL_NAME_SERVICE_CONNECTION_MAX. */ | |
14 #include "native_client/src/public/name_service.h" | |
15 | |
16 #include "native_client/src/trusted/desc/nacl_desc_base.h" | |
17 | |
18 #include "native_client/src/trusted/simple_service/nacl_simple_service.h" | |
19 #include "native_client/src/trusted/simple_service/nacl_simple_ltd_service.h" | |
20 | |
21 #include "native_client/src/trusted/threading/nacl_thread_interface.h" | |
22 | |
23 EXTERN_C_BEGIN | |
24 | |
25 /* | |
26 * NaClStartNameService should only be called once, and also serves | |
27 * as a module initializer. | |
28 * | |
29 * This function creates a bound socket / socket address pair, and | |
30 * spawns a thread that accepts connections on the bound socket and | |
31 * services requests on the resultant connections. A maximum number | |
32 * of connections is defined, since well-behaving programs should not | |
33 * need more than one (absent excessive opaque layering/abstractions) | |
34 * name service lookup connection. | |
35 * | |
36 * The socket address NaClDescConnCap is returned, to be entered into | |
37 * the NaClApp's open file table at a well-known location. | |
38 */ | |
39 | |
40 struct NaClNameServiceEntry; /* fwd */ | |
41 | |
42 struct NaClNameService { | |
43 struct NaClSimpleLtdService base NACL_IS_REFCOUNT_SUBCLASS; | |
44 | |
45 struct NaClMutex mu; | |
46 /* | |
47 * |mu| protects the service entries hanging off of |head|. | |
48 */ | |
49 struct NaClNameServiceEntry *head; | |
50 }; | |
51 | |
52 int NaClNameServiceCtor(struct NaClNameService *self, | |
53 NaClThreadIfFactoryFunction thread_factory_fn, | |
54 void *thread_factory_data); | |
55 | |
56 int NaClNameServiceCreateDescEntry( | |
57 struct NaClNameService *self, | |
58 char const *name, | |
59 int mode, | |
60 struct NaClDesc *new_desc); /* takes ownership of ref */ | |
61 | |
62 typedef int (*NaClNameServiceFactoryFn_t)(void *factory_state, | |
63 char const *name, | |
64 int flags, | |
65 struct NaClDesc **out); | |
66 | |
67 int NaClNameServiceCreateFactoryEntry( | |
68 struct NaClNameService *self, | |
69 char const *name, | |
70 /* | |
71 * If a |name| corresponding to a factory is overwritten, | |
72 * references to the factory and its state is just dropped/lost | |
73 * after invoking the factory with a NULL for the |out| argument; | |
74 * the factory function should decrement reference counts as | |
75 * appropriate and clean up when this occurs. | |
76 */ | |
77 NaClNameServiceFactoryFn_t factory_fn, | |
78 void *factory_state); | |
79 | |
80 int NaClNameServiceResolveName( | |
81 struct NaClNameService *self, | |
82 char const *name, | |
83 int flags, | |
84 struct NaClDesc **out); | |
85 | |
86 int NaClNameServiceDeleteName(struct NaClNameService *nnsp, | |
87 char const *name); | |
88 | |
89 size_t NaClNameServiceEnumerate(struct NaClNameService *nnsp, | |
90 char *dest, | |
91 size_t nbytes); | |
92 | |
93 struct NaClNameServiceVtbl { | |
94 struct NaClSimpleServiceVtbl vbase; | |
95 /* | |
96 * The following functions return 0 for success, and non-zero to | |
97 * indicate the reason for failure. The set of possible failures is | |
98 * in src/public/name_service.h. | |
99 * | |
100 * They don't really have to be virtual, but this makes it easier to | |
101 * subclass and modify later, should the need occur. | |
102 */ | |
103 int (*CreateDescEntry)( | |
104 struct NaClNameService *self, | |
105 char const *name, | |
106 int mode, | |
107 struct NaClDesc *new_desc); /* takes ownership of ref */ | |
108 int (*CreateFactoryEntry)( | |
109 struct NaClNameService *self, | |
110 char const *name, | |
111 NaClNameServiceFactoryFn_t factory_fn, | |
112 void *factory_state); | |
113 int (*ResolveName)( | |
114 struct NaClNameService *self, | |
115 char const *name, | |
116 int flags, | |
117 struct NaClDesc **out); | |
118 int (*DeleteName)( | |
119 struct NaClNameService *self, | |
120 char const *name); | |
121 }; | |
122 | |
123 extern struct NaClNameServiceVtbl kNaClNameServiceVtbl; | |
124 | |
125 void NaClNameServiceLaunch(struct NaClNameService *self); | |
126 | |
127 EXTERN_C_END | |
128 | |
129 #endif | |
130 /* NATIVE_CLIENT_SRC_TRUSTED_SERVICE_RUNTIME_NAME_SERVICE_NAME_SERVICE_H_ */ | |
OLD | NEW |