L4Re Operating System Framework
Interface and Usage Documentation
Loading...
Searching...
No Matches
region_mapping_svr_2
1// vi:set ft=cpp: -*- Mode: C++ -*-
7/*
8 * (c) 2014 Alexander Warg <alexander.warg@kernkonzept.com>
9 *
10 * License: see LICENSE.spdx (in this directory or the directories above)
11 */
12#pragma once
13
14#include <l4/sys/types.h>
15#include <l4/re/rm>
17
18namespace L4Re { namespace Util {
19
20template<typename DERIVED, typename Dbg>
21struct Rm_server
22{
23private:
24 DERIVED *rm() { return static_cast<DERIVED*>(this); }
25 DERIVED const *rm() const { return static_cast<DERIVED const *>(this); }
26
27public:
28
32 long op_attach(L4Re::Rm::Rights, l4_addr_t &_start,
33 unsigned long size, Rm::Flags flags,
34 L4::Ipc::Snd_fpage ds_cap, L4Re::Rm::Offset offs,
35 unsigned char align, l4_cap_idx_t client_cap_idx,
36 L4::Ipc::String<> name, L4Re::Rm::Offset backing_offset)
37 {
38 typename DERIVED::Dataspace ds;
39
40 if (!(flags & Rm::F::Reserved))
41 {
42 if (long r = rm()->validate_ds
43 (static_cast<DERIVED*>(this)->server_iface(), ds_cap,
44 flags.region_flags(), &ds))
45 return r;
46 }
47
48 size = l4_round_page(size);
49 l4_addr_t start = l4_trunc_page(_start);
50
51 if (size < L4_PAGESIZE)
52 return -L4_EINVAL;
53
54 Rm::Region_flags r_flags = flags.region_flags();
55 Rm::Attach_flags a_flags = flags.attach_flags();
56
57 typename DERIVED::Region_handler handler(ds, client_cap_idx, offs, r_flags);
58 start = l4_addr_t(rm()->attach(reinterpret_cast<void*>(start), size,
59 handler, a_flags, align,
60 name.data, name.length, backing_offset));
61
62 if (start == L4_INVALID_ADDR)
63 return -L4_EADDRNOTAVAIL;
64
65 _start = start;
66 return L4_EOK;
67 }
68
72 long op_free_area(L4Re::Rm::Rights, l4_addr_t start)
73 {
74 if (!rm()->detach_area(start))
75 return -L4_ENOENT;
76
77 return L4_EOK;
78 }
79
83 long op_find(L4Re::Rm::Rights, l4_addr_t &addr, unsigned long &size,
84 L4Re::Rm::Flags &flags, L4Re::Rm::Offset &offset,
86 {
87 if (!DERIVED::Have_find)
88 return -L4_EPERM;
89
90 Rm::Flags flag_area { 0 };
91
92 typename DERIVED::Node r = rm()->find(Region(addr, addr + size -1));
93 if (!r)
94 {
95 r = rm()->area_find(Region(addr, addr + size - 1));
96 if (!r)
97 return -L4_ENOENT;
98 flag_area = Rm::F::In_area;
99 }
100
101 addr = r->first.start();
102 size = r->first.end() + 1 - addr;
103
104 flags = r->second.flags() | flag_area;
105 offset = r->second.offset();
106 m = L4::Cap<L4Re::Dataspace>(DERIVED::find_res(r->second.memory()));
107 return L4_EOK;
108 }
109
113 long op_detach(L4Re::Rm::Rights, l4_addr_t addr,
114 unsigned long size, unsigned flags,
115 l4_addr_t &start, l4_addr_t &rsize,
116 l4_cap_idx_t &mem_cap)
117 {
118 Region r;
119 typename DERIVED::Region_handler h;
120 int err = rm()->detach(reinterpret_cast<void*>(addr), size, flags, &r, &h);
121 if (err < 0)
122 {
123 start = rsize = 0;
124 mem_cap = L4_INVALID_CAP;
125 return err;
126 }
127
128 if (r.invalid())
129 {
130 start = rsize = 0;
131 mem_cap = L4_INVALID_CAP;
132 return -L4_ENOENT;
133 }
134
135 start = r.start();
136 rsize = r.size();
137 mem_cap = h.client_cap_idx();
138 return err;
139 }
140
144 long op_reserve_area(L4Re::Rm::Rights, l4_addr_t &start, unsigned long size,
145 L4Re::Rm::Flags flags, unsigned char align)
146 {
147 start = rm()->attach_area(start, size, flags, align);
148 if (start == L4_INVALID_ADDR)
149 return -L4_EADDRNOTAVAIL;
150 return L4_EOK;
151 }
152
156 long op_get_regions(L4Re::Rm::Rights, l4_addr_t addr,
158 {
159 typename DERIVED::Node r;
160 unsigned num = 0;
161 while ((r = rm()->lower_bound(Region(addr))))
162 {
163 Rm::Region &x = regions.value[num];
164 x.start = r->first.start();
165 x.end = r->first.end();
166
167 if (++num >= regions.max)
168 break;
169
170 if (x.end >= rm()->max_addr())
171 break;
172 addr = x.end + 1;
173 }
174 return num;
175 }
176
180 long op_get_areas(L4Re::Rm::Rights, l4_addr_t addr,
182 {
183 typename DERIVED::Node r;
184 unsigned num = 0;
185 while ((r = rm()->lower_bound_area(Region(addr))))
186 {
187 Rm::Area &x = areas.value[num];
188 x.start = r->first.start();
189 x.end = r->first.end();
190
191 if (++num >= areas.max)
192 break;
193
194 if (x.end >= rm()->max_addr())
195 break;
196
197 addr = x.end + 1;
198 }
199 return num;
200 }
201
202private:
203 static void pager_set_result(L4::Ipc::Opt<L4::Ipc::Snd_fpage> *fp,
204 L4::Ipc::Snd_fpage const &f)
205 { *fp = f; }
206
207 static void pager_set_result(L4::Ipc::Opt<L4::Ipc::Snd_fpage> *, ...)
208 {}
209public:
210
214 long op_io_page_fault(L4::Io_pager::Rights, l4_fpage_t, l4_umword_t,
216 {
217 // generate exception
218 return -L4_ENOMEM;
219 }
220
221 long op_page_fault(L4::Pager::Rights, l4_umword_t addr, l4_umword_t pc,
223 {
224 Dbg(Dbg::Server).printf("page fault: %lx pc=%lx\n", addr, pc);
225
226 bool need_w = addr & 2;
227 bool need_x = addr & 4;
228
229 typename DERIVED::Node n = rm()->find(addr);
230
231 if (!n || !n->second.memory())
232 {
233 Dbg(Dbg::Warn, "rm").printf("unhandled %s page fault at 0x%lx pc=0x%lx\n",
234 need_w ? "write" :
235 need_x ? "instruction" : "read", addr, pc);
236 // generate exception
237 return -L4_ENOMEM;
238 }
239
240 if (!(n->second.flags() & L4Re::Rm::F::W) && need_w)
241 {
242 Dbg(Dbg::Warn, "rm").printf("write page fault in readonly region at 0x%lx pc=0x%lx\n",
243 addr, pc);
244 // generate exception
245 return -L4_EACCESS;
246 }
247
248 if (!(n->second.flags() & L4Re::Rm::F::X) && need_x)
249 {
250 Dbg(Dbg::Warn, "rm").printf("instruction page fault in non-exec region at 0x%lx pc=0x%lx\n",
251 addr, pc);
252 // generate exception
253 return -L4_EACCESS;
254 }
255
256 typename DERIVED::Region_handler::Ops::Map_result map_res;
257 if (int err = n->second.map(addr, n->first, need_w, &map_res))
258 {
259 Dbg(Dbg::Warn, "rm").printf("mapping for page fault failed with error %d at 0x%lx pc=0x%lx\n",
260 err, addr, pc);
261 // generate exception
262 return -L4_ENOMEM;
263 }
264
265 pager_set_result(&fp, map_res);
266 return L4_EOK;
267 }
268
269 long op_get_info(L4Re::Rm::Rights, l4_addr_t addr,
270 L4::Ipc::String<char> &name, L4Re::Rm::Offset &backing_offset)
271 {
272#ifdef CONFIG_L4RE_REGION_INFO
273 typename DERIVED::Node r = rm()->find(Region(addr));
274 if (!r)
275 return -L4_ENOENT;
276 backing_offset = r->first.backing_offset();
277 unsigned long i;
278 char const *src = r->first.name();
279 unsigned src_len = r->first.name_len();
280 for (i = 0; i < src_len && i < name.length - 1; ++i)
281 name.data[i] = src[i];
282 name.length = i + 1;
283 name.data[i] = '\0';
284 return L4_EOK;
285#else
286 (void)addr;
287 (void)name;
288 (void)backing_offset;
289 return -L4_ENOSYS;
290#endif
291 }
292};
293
294}}
Range Area
An area is a range of virtual addresses which is reserved, see L4Re::Rm::reserve_area().
Definition rm:703
Range Region
A region is a range of virtual addresses which is backed by a dataspace.
Definition rm:695
C++ interface for capabilities.
Definition capability.h:224
Send item or return item.
Definition ipc_types:324
unsigned long l4_umword_t
Unsigned machine word.
Definition l4int.h:40
unsigned long l4_addr_t
Address type.
Definition l4int.h:34
unsigned long l4_cap_idx_t
Capability selector type.
Definition types.h:335
@ L4_INVALID_CAP
Invalid capability selector.
Definition consts.h:153
@ L4_ENOENT
No such entity.
Definition err.h:34
@ L4_ENOSYS
No sys.
Definition err.h:50
@ L4_EACCESS
Permission denied.
Definition err.h:40
@ L4_EINVAL
Invalid argument.
Definition err.h:46
@ L4_EOK
Ok.
Definition err.h:32
@ L4_EADDRNOTAVAIL
Address not available.
Definition err.h:52
@ L4_EPERM
No permission.
Definition err.h:33
@ L4_ENOMEM
No memory.
Definition err.h:39
l4_addr_t l4_trunc_page(l4_addr_t address) L4_NOTHROW
Round an address down to the next lower page boundary.
Definition consts.h:448
l4_addr_t l4_round_page(l4_addr_t address) L4_NOTHROW
Round address up to the next page.
Definition consts.h:473
#define L4_PAGESIZE
Minimal page size (in bytes).
Definition consts.h:391
@ L4_INVALID_ADDR
Invalid address.
Definition consts.h:505
Common L4 ABI Data Types.
L4Re C++ Interfaces.
Definition cmd_control:14
Region handling.
Region mapper interface.
@ Reserved
Region is reserved (blocked)
Definition rm:150
@ X
Executable region.
Definition rm:137
@ W
Writable region.
Definition rm:135
@ In_area
Search only in area, or map into area.
Definition rm:116
Attribute for defining an optional RPC argument.
Definition ipc_types:137
Dynamically sized output array of type T.
Definition ipc_ret_array:24
L4 flexpage type.
Definition __l4_fpage.h:76