1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
/* loader.h - Load ELF binary images, interfaces.
Copyright (C) 2003, 2007 Free Software Foundation, Inc.
Written by Marcus Brinkmann.
This file is part of the GNU Hurd.
The GNU Hurd is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 3, or (at
your option) any later version.
The GNU Hurd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. */
#ifndef _LOADER_H
#define _LOADER_H 1
#include <l4/types.h>
#include <l4/kip.h>
/* The user must provide the following functions. */
/* Return the number of memory descriptors. */
l4_word_t loader_get_num_memory_desc (void);
/* Return the NRth memory descriptor. The first memory descriptor is
indexed by 0. */
l4_memory_desc_t *loader_get_memory_desc (l4_word_t nr);
/* Callback passed to loader_add_region. The region named NAME
starting at START and continuing until END (exclusive) has been
relocated to NEW_START. Update any data structures
appropriately. */
typedef void (*relocate_region) (const char *name,
l4_word_t start, l4_word_t end,
l4_word_t new_start,
void *cookie);
/* Add the region with the name NAME from START to END to the table of
regions to check against. Before doing that, check for overlaps
with existing regions. If at some time an overlap is detected and
RR is not NULL, the region may be relocated. In this case RR is
invoked providing for the possibility to update any pointers. If
DESC_TYPE is not -1, then this region will be added as a memory
descriptor by loader_regions_reserve. */
void loader_add_region (const char *name, l4_word_t start, l4_word_t end,
relocate_region rr, void *cookie,
int desc_type);
/* Remove the region(s) with the name NAME from the region descriptor
table. */
void loader_remove_region (const char *name);
/* Setup memory descriptors corresponding to the current set of
reserved descriptors. Should be called once, immediately before
jumping into the kernel. */
void loader_regions_reserve (void);
/* Load the ELF image from START to END into memory under the name
NAME (also used as the name for the region of the resulting ELF
program). Return the lowest and highest address used by the
program in NEW_START_P and NEW_END_P, and the entry point in ENTRY.
The used regions are automatically added with the type DESC_TYPE
(cf., loader_add_region). */
void loader_elf_load (const char *name, l4_word_t start, l4_word_t end,
l4_word_t *new_start_p, l4_word_t *new_end_p,
l4_word_t *entry, int desc_type);
#endif /* _LOADER_H */
|