L4Re Operating System Framework
Interface and Usage Documentation
Loading...
Searching...
No Matches
rm_impl.h
Go to the documentation of this file.
1
5/*
6 * (c) 2008-2009 Adam Lackorzynski <adam@os.inf.tu-dresden.de>,
7 * Alexander Warg <warg@os.inf.tu-dresden.de>
8 * economic rights: Technische Universität Dresden (Germany)
9 *
10 * License: see LICENSE.spdx (in this directory or the directories above)
11 */
12
13#include <l4/bid_config.h>
14#include <l4/re/rm>
15#include <l4/re/dataspace>
16
17#include <l4/sys/cxx/ipc_client>
18
19#include <l4/sys/task>
20#include <l4/sys/err.h>
21
30
31namespace L4Re
32{
33
34long
35Rm::attach(l4_addr_t *start, unsigned long size, Rm::Flags flags,
36 L4::Ipc::Cap<Dataspace> mem, Rm::Offset offs,
37 unsigned char align, L4::Cap<L4::Task> const task,
38 char const *name, Rm::Offset backing_offset) const noexcept
39{
40 if ((flags & F::Rights_mask) == Flags(0)
41 || (flags & (F::Reserved | F::Kernel)))
43
44 char const n = '\0';
45 long e = attach_t::call(c(), start, size, flags, mem, offs, align,
46 mem.cap().cap(), name ? name : &n, backing_offset);
47 if (e < 0)
48 return e;
49
50#ifdef CONFIG_MMU
51 if ((flags & (F::Eager_map | F::No_eager_map)) == F::Eager_map)
52#else
53 if (!(flags & F::No_eager_map) && mem.is_valid())
54#endif
55 e = mem.cap()->map_region(offs, flags.map_flags(), *start, *start + size,
56 task);
57
58 return e;
59}
60
61int
62Rm::detach(l4_addr_t start, unsigned long size, L4::Cap<Dataspace> *mem,
63 L4::Cap<L4::Task> task, unsigned flags) const noexcept
64{
65 l4_addr_t rstart = 0, rsize = 0;
67 long e = detach_t::call(c(), start, size, flags, rstart, rsize, mem_cap);
68 if (L4_UNLIKELY(e < 0))
69 return e;
70
71 if (mem)
72 *mem = L4::Cap<L4Re::Dataspace>(mem_cap);
73
74 if (!task.is_valid())
75 return e;
76
77 rsize = l4_round_page(rsize);
78 unsigned order = L4_LOG2_PAGESIZE;
79 unsigned long sz = (1UL << order);
80 for (unsigned long p = rstart; rsize; p += sz, rsize -= sz)
81 {
82 while (sz > rsize)
83 {
84 --order;
85 sz >>= 1;
86 }
87
88 for (;;)
89 {
90 unsigned long m = sz << 1;
91 if (m > rsize)
92 break;
93
94 if (p & (m - 1))
95 break;
96
97 ++order;
98 sz <<= 1;
99 }
100
101 task->unmap(l4_fpage(p, order, L4_FPAGE_RWX),
103 }
104
105 return e;
106}
107
108}
long free_area(l4_addr_t addr)
Free an area from the region map.
long reserve_area(l4_addr_t *start, unsigned long size, Flags flags=Flags(0), unsigned char align=L4_PAGESHIFT) const noexcept
Reserve the given area in the region map.
Definition rm:276
long get_regions(l4_addr_t start, L4::Ipc::Ret_array< Region > regions)
Return the list of regions whose starting addresses are higher or equal to start in the address space...
long find(l4_addr_t *addr, unsigned long *size, Offset *offset, L4Re::Rm::Flags *flags, L4::Cap< Dataspace > *m) noexcept
Find a region given an address and size.
Definition rm:671
long get_areas(l4_addr_t start, L4::Ipc::Ret_array< Area > areas)
Return the list of areas whose starting addresses are higher or equal to start in the address space m...
long attach(l4_addr_t *start, unsigned long size, Flags flags, L4::Ipc::Cap< Dataspace > mem, Offset offs=0, unsigned char align=L4_PAGESHIFT, L4::Cap< L4::Task > const task=L4::Cap< L4::Task >::Invalid, char const *name=nullptr, Offset backing_offset=0) const noexcept
Attach a data space to a region.
Definition rm_impl.h:35
long get_info(l4_addr_t addr, L4::Ipc::String< char > &name, Offset &backing_offset)
Return auxiliary information of a region.
int detach(l4_addr_t addr, L4::Cap< Dataspace > *mem, L4::Cap< L4::Task > const &task=This_task) const noexcept
Detach and unmap a region from the address space.
Definition rm:762
C++ interface for capabilities.
Definition capability.h:224
Capability type for RPC interfaces (see L4::Cap<T>).
Definition ipc_types:699
Dataspace interface.
Error codes.
unsigned long l4_addr_t
Address type.
Definition l4int.h:34
unsigned long l4_cap_idx_t
Capability selector type.
Definition types.h:336
@ L4_INVALID_CAP
Invalid capability selector.
Definition consts.h:153
l4_fpage_t l4_fpage(l4_addr_t address, unsigned int order, unsigned char rights) L4_NOTHROW
Create a memory flexpage.
Definition __l4_fpage.h:703
@ L4_FPAGE_RWX
Read-write-execute flexpage.
Definition __l4_fpage.h:125
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_LOG2_PAGESIZE
Number of bits used for page offset.
Definition consts.h:409
@ L4_FP_ALL_SPACES
Flag to tell the unmap operation to revoke permissions from all child mappings including the mapping ...
Definition consts.h:183
#define L4_UNLIKELY(x)
Expression is unlikely to execute.
Definition compiler.h:284
#define L4_RPC_DEF(name)
Generate the definition of an RPC stub.
Definition ipc_client:32
L4Re C++ Interfaces.
Definition cmd_control:14
Region mapper interface.
@ Rights_mask
Region rights.
Definition rm:131
@ Reserved
Region is reserved (blocked).
Definition rm:152
@ Kernel
Kernel-provided memory (KUMEM).
Definition rm:146
@ No_eager_map
Prevent eager mapping of the attached data space.
Definition rm:119
@ Eager_map
Eagerly map the attached data space in.
Definition rm:117
Common task related definitions.