L4Re - L4 Runtime Environment
object_registry
1 // vi:set ft=cpp: -*- Mode: C++ -*-
2 /*
3  * (c) 2008-2009 Adam Lackorzynski <adam@os.inf.tu-dresden.de>,
4  * Alexander Warg <warg@os.inf.tu-dresden.de>
5  * economic rights: Technische Universität Dresden (Germany)
6  *
7  * This file is part of TUD:OS and distributed under the terms of the
8  * GNU General Public License 2.
9  * Please see the COPYING-GPL-2 file for details.
10  *
11  * As a special exception, you may use this file as part of a free software
12  * library without restriction. Specifically, if other files instantiate
13  * templates or use macros or inline functions from this file, or you compile
14  * this file and link it with other files to produce an executable, this
15  * file does not by itself cause the resulting executable to be covered by
16  * the GNU General Public License. This exception does not however
17  * invalidate any other reasons why the executable file might be covered by
18  * the GNU General Public License.
19  */
20 
21 #pragma once
22 
23 #include <l4/re/util/cap_alloc>
24 #include <l4/re/util/unique_cap>
25 #include <l4/re/consts>
26 #include <l4/re/env>
27 
28 #include <l4/sys/cxx/ipc_server_loop>
29 #include <l4/sys/factory>
30 #include <l4/sys/task>
31 #include <l4/sys/thread>
32 #include <l4/sys/ipc_gate>
33 
34 #include <l4/cxx/exceptions>
35 
36 namespace L4Re { namespace Util {
37 
53  public L4::Basic_registry,
54  public L4::Registry_iface
55 {
60  struct Null_handler : L4::Epiface_t<Null_handler, L4::Kobject>
61  {};
62 
63 protected:
64  L4::Cap<L4::Thread> _server;
65  L4::Cap<L4::Factory> _factory;
67 
68 private:
69  Null_handler _null_handler;
70 
71 public:
77  explicit
79  : _server(L4Re::Env::env()->main_thread()),
80  _factory(L4Re::Env::env()->factory()),
81  _sif(sif)
82  {}
83 
93  L4::Cap<L4::Thread> server,
94  L4::Cap<L4::Factory> factory)
95  : _server(server), _factory(factory), _sif(sif)
96  {}
97 
98 private:
101 
103  _register_ep(L4::Epiface *o, L4::Cap<L4::Rcv_endpoint> ep,
104  Demand const &demand)
105  {
106  int err = _sif->alloc_buffer_demand(demand);
107  if (err < 0)
108  return L4::Cap<L4::Rcv_endpoint>(err | L4_INVALID_CAP_BIT);
109 
110  l4_umword_t id = l4_umword_t(o);
111  err = l4_error(ep->bind_thread(_server, id));
112  if (err < 0)
113  return L4::Cap<L4::Rcv_endpoint>(err | L4_INVALID_CAP_BIT);
114 
115  err = o->set_server(_sif, ep);
116  if (err < 0)
117  return L4::Cap<L4::Rcv_endpoint>(err | L4_INVALID_CAP_BIT);
118 
119  return ep;
120  }
121 
122  L4::Cap<void> _register_ep(L4::Epiface *o, char const *service,
123  Demand const &demand)
124  {
126  if (!cap.is_valid())
127  return cap;
128 
129  return _register_ep(o, cap, demand);
130  }
131 
132  L4::Cap<void> _register_gate(L4::Epiface *o, Demand const &demand)
133  {
134  int err = _sif->alloc_buffer_demand(demand);
135  if (err < 0)
136  return L4::Cap<void>(err | L4_INVALID_CAP_BIT);
137 
138  auto cap = L4Re::Util::make_unique_cap<L4::Kobject>();
139 
140  if (!cap.is_valid())
141  return cap.get();
142 
143  l4_umword_t id = l4_umword_t(o);
144  err = l4_error(_factory->create_gate(cap.get(), _server, id));
145  if (err < 0)
146  return L4::Cap<void>(err | L4_INVALID_CAP_BIT);
147 
148  err = o->set_server(_sif, cap.get(), true);
149  if (err < 0)
150  return L4::Cap<void>(err | L4_INVALID_CAP_BIT);
151 
152  return cap.release();
153  }
154 
155  L4::Cap<L4::Irq> _register_irq(L4::Epiface *o,
156  Demand const &demand)
157  {
158  int err = _sif->alloc_buffer_demand(demand);
159  if (err < 0)
160  return L4::Cap<L4::Irq>(err | L4_INVALID_CAP_BIT);
161 
162  auto cap = L4Re::Util::make_unique_cap<L4::Irq>();
163 
164  if (!cap.is_valid())
165  return cap.get();
166 
167  l4_umword_t id = l4_umword_t(o);
168  err = l4_error(_factory->create(cap.get()));
169  if (err < 0)
170  return L4::Cap<L4::Irq>(err | L4_INVALID_CAP_BIT);
171 
172  err = l4_error(cap->bind_thread(_server, id));
173  if (err < 0)
174  return L4::Cap<L4::Irq>(err | L4_INVALID_CAP_BIT);
175 
176  err = o->set_server(_sif, cap.get(), true);
177  if (err < 0)
178  return L4::Cap<L4::Irq>(err | L4_INVALID_CAP_BIT);
179 
180  return cap.release();
181  }
182 
183  static Demand _get_buffer_demand(L4::Epiface *o)
184  { return o->get_buffer_demand(); }
185 
186  template<typename T>
187  static Demand _get_buffer_demand(T *,
190  { return d; }
191 
192 public:
201  L4::Cap<void> register_obj(L4::Epiface *o, char const *service) override
202  {
203  return _register_ep(o, service, _get_buffer_demand(o));
204  }
205 
215  L4::Cap<void> register_obj(L4::Epiface *o) override
216  {
217  return _register_gate(o, _get_buffer_demand(o));
218  }
219 
229  L4::Cap<L4::Irq> register_irq_obj(L4::Epiface *o) override
230  {
231  return _register_irq(o, _get_buffer_demand(o));
232  }
233 
234  // pass access to deprecated register_irq_obj
236 
247  register_obj(L4::Epiface *o, L4::Cap<L4::Rcv_endpoint> ep) override
248  {
249  return _register_ep(o, ep, _get_buffer_demand(o));
250  }
251 
252 
263  void unregister_obj(L4::Epiface *o, bool unmap = true) override
264  {
265  L4::Epiface::Stored_cap c;
266 
267  if (!o || !o->obj_cap().is_valid())
268  return;
269 
270  c = o->obj_cap();
271 
272  // make sure unhandled ipc ends up with the null handler
274  todo.add(~3UL, reinterpret_cast<l4_umword_t>(o),
275  ~0UL, reinterpret_cast<l4_umword_t>((L4::Epiface*)&_null_handler));
276  _server->modify_senders(todo);
277 
278  if (unmap)
279  L4::Cap<L4::Task>(L4Re::This_task)->unmap(c.fpage(), L4_FP_ALL_SPACES);
280 
281  // we use bit 4 to indicated an internally allocated cap
282  if (c.managed())
283  cap_alloc.free(c);
284 
285  o->set_server(0, L4::Cap<void>::Invalid);
286  }
287 };
288 
292 template< typename LOOP_HOOKS = L4::Ipc_svr::Default_loop_hooks >
293 class Registry_server : public L4::Server<LOOP_HOOKS>
294 {
295 private:
297  Object_registry _registry;
298 
299 public:
305  Registry_server() : Base(l4_utcb()), _registry(this)
306  {}
307 
316  L4::Cap<L4::Factory> factory)
317  : Base(utcb), _registry(this, server, factory)
318  {}
319 
321  Object_registry const *registry() const { return &_registry; }
323  Object_registry *registry() { return &_registry; }
324 
329  { Base::template loop<L4::Runtime_error, Object_registry &>(_registry); }
330 };
331 
332 }}
Abstract interface for object registries.
Definition: ipc_epiface:305
Object_registry(L4::Ipc_svr::Server_iface *sif)
Create a registry for the main thread of the task using the default factory.
Definition: object_registry:78
Data type for expressing the needed receive buffers at the server-side of an interface.
Definition: __typeinfo.h:516
void L4_NORETURN loop()
Start the server loop.
L4::Cap< L4::Irq > register_irq_obj(L4::Epiface *o) override
Register a handler for an interrupt.
Unique_cap / Unique_del_cap.
Constants.
Interface for server-loop related functions.
Definition: ipc_epiface:47
int add(l4_umword_t match_mask, l4_umword_t match, l4_umword_t del_bits, l4_umword_t add_bits)
Add a rule.
Definition: thread:352
Base exceptions.
Wrapper class for modifying senders.
Definition: thread:323
C++ interface of the initial environment that is provided to an L4 task.
Definition: env:85
l4_msgtag_t create_gate(Cap< void > const &target_cap, Cap< Thread > const &thread_cap, l4_umword_t label, l4_utcb_t *utcb=l4_utcb())
Create a new IPC gate.
Definition: factory:372
L4::Cap< void > register_obj(L4::Epiface *o) override
Register a new server object on a newly allocated capability.
L4Re C++ Interfaces.
Definition: cmd_control:15
Object_registry * registry()
Return registry of this server loop.
struct l4_utcb_t l4_utcb_t
Opaque type for the UTCB.
Definition: utcb.h:67
This registry returns the corresponding server object based on the label of an Ipc_gate.
Definition: ipc_epiface:509
L4::Cap< L4::Rcv_endpoint > register_obj(L4::Epiface *o, L4::Cap< L4::Rcv_endpoint > ep) override
Register a handler for an already existing interrupt.
Common task related definitions.
Registry_server()
Create a new server loop object for the main thread of the task.
Registry_server(l4_utcb_t *utcb, L4::Cap< L4::Thread > server, L4::Cap< L4::Factory > factory)
Create a new server loop object for an arbitrary thread and factory.
Environment interface.
Basic server loop for handling client requests.
Object_registry(L4::Ipc_svr::Server_iface *sif, L4::Cap< L4::Thread > server, L4::Cap< L4::Factory > factory)
Create a registry for arbitrary threads.
Definition: object_registry:92
#define L4_NORETURN
Noreturn function attribute.
Definition: compiler.h:202
Flag to tell the unmap operation to unmap all child mappings including the mapping in the invoked tas...
Definition: consts.h:165
bool free(L4::Cap< void > cap, l4_cap_idx_t task=L4_INVALID_CAP, unsigned unmap_flags=L4_FP_ALL_SPACES)
Free the capability.
Common thread related definitions.
static Env const * env()
Returns the initial environment for the current task.
Definition: env:103
T::__Kobject_typeid::Demand Demand
Data type expressing the static demand of receive buffers in a server.
Definition: __typeinfo.h:632
_Cap_alloc & cap_alloc
Capability allocator.
Object_registry const * registry() const
Return registry of this server loop.
unsigned long l4_umword_t
Unsigned machine word.
Definition: l4int.h:52
S create(Cap< void > target, long obj, l4_utcb_t *utcb=l4_utcb())
Generic create call to the factory.
Definition: factory:259
Interface for kernel objects that allow to receive IPC from them.
Definition: rcv_endpoint:40
A server loop object which has a Object_registry included.
void unregister_obj(L4::Epiface *o, bool unmap=true) override
Remove a server object from the handler list.
l4_utcb_t * l4_utcb(void) L4_NOTHROW L4_PURE
Get the UTCB address.
Definition: utcb.h:340
bool is_valid() const
Test whether the capability is a valid capability index (i.e., not L4_INVALID_CAP).
Definition: capability.h:60
virtual L4::Cap< L4::Irq > register_irq_obj(L4::Epiface *o)=0
Register o as server-side object for asynchronous IRQs.
long l4_error(l4_msgtag_t tag) L4_NOTHROW
Return error code of a system call return message tag.
Definition: ipc.h:517
Common factory related definitions.
L4::Cap< void > register_obj(L4::Epiface *o, char const *service) override
Register a new server object to a pre-allocated receive endpoint.
virtual int alloc_buffer_demand(Demand const &demand)=0
Tells the server to allocate buffers for the given demand.
L4::Cap< T > get_cap(char const *name, unsigned l) const
Get the capability selector for the object named name.
Definition: env:204
Capability allocator.
The C++ IPC gate interface.
A registry that manages server objects and their attached IPC gates for a single server loop for a sp...
Definition: object_registry:52
l4_msgtag_t modify_senders(Modify_senders const &todo)
Apply sender modification rules.
Definition: thread:373
l4_msgtag_t bind_thread(Ipc::Opt< Ipc::Cap< Thread > > t, l4_umword_t label)
Bind a thread to an IPC receive endpoint.