WebSVN – HelenOS – Diff – /tags/0.2.0.5/kernel/generic/src/lib/elf.c


/*
 * Copyright (c) 2006 Sergey Bondari
 * Copyright (c) 2006 Jakub Jermar
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
 
/** @addtogroup generic
 * @{
 */
 
/**
 * @file
 * @brief   Kernel ELF loader.
 */
 
#include <lib/elf.h>
#include <debug.h>
#include <arch/types.h>
#include <mm/as.h>
#include <mm/frame.h>
#include <mm/slab.h>
#include <align.h>
#include <memstr.h>
#include <macros.h>
#include <arch.h>
 
static char *error_codes[] = {
    "no error",
    "invalid image",
    "address space error",
    "incompatible image",
    "unsupported image type",
    "irrecoverable error"
};
 
static int segment_header(elf_segment_header_t *entry, elf_header_t *elf, as_t *as);
static int section_header(elf_section_header_t *entry, elf_header_t *elf, as_t *as);
static int load_segment(elf_segment_header_t *entry, elf_header_t *elf, as_t *as);
 
/** ELF loader
 *
 * @param header Pointer to ELF header in memory
 * @param as Created and properly mapped address space
 * @return EE_OK on success
 */
int elf_load(elf_header_t *header, as_t * as)
{
    int i, rc;
 
    /* Identify ELF */
    if (header->e_ident[EI_MAG0] != ELFMAG0 || header->e_ident[EI_MAG1] != ELFMAG1 ||
        header->e_ident[EI_MAG2] != ELFMAG2 || header->e_ident[EI_MAG3] != ELFMAG3) {
        return EE_INVALID;
    }
   
    /* Identify ELF compatibility */
    if (header->e_ident[EI_DATA] != ELF_DATA_ENCODING || header->e_machine != ELF_MACHINE ||
        header->e_ident[EI_VERSION] != EV_CURRENT || header->e_version != EV_CURRENT ||
        header->e_ident[EI_CLASS] != ELF_CLASS) {
        return EE_INCOMPATIBLE;
    }
 
    if (header->e_phentsize != sizeof(elf_segment_header_t))
        return EE_INCOMPATIBLE;
 
    if (header->e_shentsize != sizeof(elf_section_header_t))
        return EE_INCOMPATIBLE;
 
    /* Check if the object type is supported. */
    if (header->e_type != ET_EXEC)
        return EE_UNSUPPORTED;
 
    /* Walk through all segment headers and process them. */
    for (i = 0; i < header->e_phnum; i++) {
        rc = segment_header(&((elf_segment_header_t *)(((uint8_t *) header) + header->e_phoff))[i], header, as);
        if (rc != EE_OK)
            return rc;
    }
 
    /* Inspect all section headers and proccess them. */
    for (i = 0; i < header->e_shnum; i++) {
        rc = section_header(&((elf_section_header_t *)(((uint8_t *) header) + header->e_shoff))[i], header, as);
        if (rc != EE_OK)
            return rc;
    }
 
    return EE_OK;
}
 
/** Print error message according to error code.
 *
 * @param rc Return code returned by elf_load().
 *
 * @return NULL terminated description of error.
 */
char *elf_error(int rc)
{
    ASSERT(rc < sizeof(error_codes)/sizeof(char *));
 
    return error_codes[rc];
}
 
/** Process segment header.
 *
 * @param entry Segment header.
 * @param elf ELF header.
 * @param as Address space into wich the ELF is being loaded.
 *
 * @return EE_OK on success, error code otherwise.
 */
static int segment_header(elf_segment_header_t *entry, elf_header_t *elf, as_t *as)
{
    switch (entry->p_type) {
    case PT_NULL:
    case PT_PHDR:
        break;
    case PT_LOAD:
        return load_segment(entry, elf, as);
        break;
    case PT_DYNAMIC:
    case PT_INTERP:
    case PT_SHLIB:
    case PT_NOTE:
    case PT_LOPROC:
    case PT_HIPROC:
    default:
        return EE_UNSUPPORTED;
        break;
    }
    return EE_OK;
}
 
/** Load segment described by program header entry.
 *
 * @param entry Program header entry describing segment to be loaded.
 * @param elf ELF header.
 * @param as Address space into wich the ELF is being loaded.
 *
 * @return EE_OK on success, error code otherwise.
 */
int load_segment(elf_segment_header_t *entry, elf_header_t *elf, as_t *as)
{
    as_area_t *a;
    int flags = 0;
    mem_backend_data_t backend_data;
   
    backend_data.elf = elf;
    backend_data.segment = entry;
 
    if (entry->p_align > 1) {
        if ((entry->p_offset % entry->p_align) != (entry->p_vaddr % entry->p_align)) {
            return EE_INVALID;
        }
    }
 
    if (entry->p_flags & PF_X)
        flags |= AS_AREA_EXEC;
    if (entry->p_flags & PF_W)
        flags |= AS_AREA_WRITE;
    if (entry->p_flags & PF_R)
        flags |= AS_AREA_READ;
    flags |= AS_AREA_CACHEABLE;
 
    /*
     * Check if the virtual address starts on page boundary.
     */
    if (ALIGN_UP(entry->p_vaddr, PAGE_SIZE) != entry->p_vaddr)
        return EE_UNSUPPORTED;
 
    a = as_area_create(as, flags, entry->p_memsz, entry->p_vaddr, AS_AREA_ATTR_NONE,
        &elf_backend, &backend_data);
    if (!a)
        return EE_MEMORY;
   
    /*
     * The segment will be mapped on demand by elf_page_fault().
     */
 
    return EE_OK;
}
 
/** Process section header.
 *
 * @param entry Segment header.
 * @param elf ELF header.
 * @param as Address space into wich the ELF is being loaded.
 *
 * @return EE_OK on success, error code otherwise.
 */
static int section_header(elf_section_header_t *entry, elf_header_t *elf, as_t *as)
{
    switch (entry->sh_type) {
    default:
        break;
    }
   
    return EE_OK;
}
 
/** @}
 */
 

Rev 2089	Rev 2474
1	/*	1	/*
2	* Copyright (c) 2006 Sergey Bondari	2	* Copyright (c) 2006 Sergey Bondari
3	* Copyright (c) 2006 Jakub Jermar	3	* Copyright (c) 2006 Jakub Jermar
4	* All rights reserved.	4	* All rights reserved.
5	*	5	*
6	* Redistribution and use in source and binary forms, with or without	6	* Redistribution and use in source and binary forms, with or without
7	* modification, are permitted provided that the following conditions	7	* modification, are permitted provided that the following conditions
8	* are met:	8	* are met:
9	*	9	*
10	* - Redistributions of source code must retain the above copyright	10	* - Redistributions of source code must retain the above copyright
11	* notice, this list of conditions and the following disclaimer.	11	* notice, this list of conditions and the following disclaimer.
12	* - Redistributions in binary form must reproduce the above copyright	12	* - Redistributions in binary form must reproduce the above copyright
13	* notice, this list of conditions and the following disclaimer in the	13	* notice, this list of conditions and the following disclaimer in the
14	* documentation and/or other materials provided with the distribution.	14	* documentation and/or other materials provided with the distribution.
15	* - The name of the author may not be used to endorse or promote products	15	* - The name of the author may not be used to endorse or promote products
16	* derived from this software without specific prior written permission.	16	* derived from this software without specific prior written permission.
17	*	17	*
18	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR	18	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES	19	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.	20	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,	21	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT	22	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,	23	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY	24	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT	25	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF	26	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.	27	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28	*/	28	*/
29		29
30	/** @addtogroup generic	30	/** @addtogroup generic
31	* @{	31	* @{
32	*/	32	*/
33		33
34	/**	34	/**
35	* @file	35	* @file
36	* @brief Kernel ELF loader.	36	* @brief Kernel ELF loader.
37	*/	37	*/
38		38
39	#include <lib/elf.h>	39	#include <lib/elf.h>
40	#include <debug.h>	40	#include <debug.h>
41	#include <arch/types.h>	41	#include <arch/types.h>
42	#include <mm/as.h>	42	#include <mm/as.h>
43	#include <mm/frame.h>	43	#include <mm/frame.h>
44	#include <mm/slab.h>	44	#include <mm/slab.h>
45	#include <align.h>	45	#include <align.h>
46	#include <memstr.h>	46	#include <memstr.h>
47	#include <macros.h>	47	#include <macros.h>
48	#include <arch.h>	48	#include <arch.h>
49		49
50	static char *error_codes[] = {	50	static char *error_codes[] = {
51	"no error",	51	"no error",
52	"invalid image",	52	"invalid image",
53	"address space error",	53	"address space error",
54	"incompatible image",	54	"incompatible image",
55	"unsupported image type",	55	"unsupported image type",
56	"irrecoverable error"	56	"irrecoverable error"
57	};	57	};
58		58
59	static int segment_header(elf_segment_header_t entry, elf_header_t elf, as_t *as);	59	static int segment_header(elf_segment_header_t entry, elf_header_t elf, as_t *as);
60	static int section_header(elf_section_header_t entry, elf_header_t elf, as_t *as);	60	static int section_header(elf_section_header_t entry, elf_header_t elf, as_t *as);
61	static int load_segment(elf_segment_header_t entry, elf_header_t elf, as_t *as);	61	static int load_segment(elf_segment_header_t entry, elf_header_t elf, as_t *as);
62		62
63	/** ELF loader	63	/** ELF loader
64	*	64	*
65	* @param header Pointer to ELF header in memory	65	* @param header Pointer to ELF header in memory
66	* @param as Created and properly mapped address space	66	* @param as Created and properly mapped address space
67	* @return EE_OK on success	67	* @return EE_OK on success
68	*/	68	*/
69	int elf_load(elf_header_t header, as_t as)	69	int elf_load(elf_header_t header, as_t as)
70	{	70	{
71	int i, rc;	71	int i, rc;
72		72
73	/* Identify ELF */	73	/* Identify ELF */
74	if (header->e_ident[EI_MAG0] != ELFMAG0 \|\| header->e_ident[EI_MAG1] != ELFMAG1 \|\|	74	if (header->e_ident[EI_MAG0] != ELFMAG0 \|\| header->e_ident[EI_MAG1] != ELFMAG1 \|\|
75	header->e_ident[EI_MAG2] != ELFMAG2 \|\| header->e_ident[EI_MAG3] != ELFMAG3) {	75	header->e_ident[EI_MAG2] != ELFMAG2 \|\| header->e_ident[EI_MAG3] != ELFMAG3) {
76	return EE_INVALID;	76	return EE_INVALID;
77	}	77	}
78		78
79	/* Identify ELF compatibility */	79	/* Identify ELF compatibility */
80	if (header->e_ident[EI_DATA] != ELF_DATA_ENCODING \|\| header->e_machine != ELF_MACHINE \|\|	80	if (header->e_ident[EI_DATA] != ELF_DATA_ENCODING \|\| header->e_machine != ELF_MACHINE \|\|
81	header->e_ident[EI_VERSION] != EV_CURRENT \|\| header->e_version != EV_CURRENT \|\|	81	header->e_ident[EI_VERSION] != EV_CURRENT \|\| header->e_version != EV_CURRENT \|\|
82	header->e_ident[EI_CLASS] != ELF_CLASS) {	82	header->e_ident[EI_CLASS] != ELF_CLASS) {
83	return EE_INCOMPATIBLE;	83	return EE_INCOMPATIBLE;
84	}	84	}
85		85
86	if (header->e_phentsize != sizeof(elf_segment_header_t))	86	if (header->e_phentsize != sizeof(elf_segment_header_t))
87	return EE_INCOMPATIBLE;	87	return EE_INCOMPATIBLE;
88		88
89	if (header->e_shentsize != sizeof(elf_section_header_t))	89	if (header->e_shentsize != sizeof(elf_section_header_t))
90	return EE_INCOMPATIBLE;	90	return EE_INCOMPATIBLE;
91		91
92	/* Check if the object type is supported. */	92	/* Check if the object type is supported. */
93	if (header->e_type != ET_EXEC)	93	if (header->e_type != ET_EXEC)
94	return EE_UNSUPPORTED;	94	return EE_UNSUPPORTED;
95		95
96	/* Walk through all segment headers and process them. */	96	/* Walk through all segment headers and process them. */
97	for (i = 0; i < header->e_phnum; i++) {	97	for (i = 0; i < header->e_phnum; i++) {
98	rc = segment_header(&((elf_segment_header_t )(((uint8_t ) header) + header->e_phoff))[i], header, as);	98	rc = segment_header(&((elf_segment_header_t )(((uint8_t ) header) + header->e_phoff))[i], header, as);
99	if (rc != EE_OK)	99	if (rc != EE_OK)
100	return rc;	100	return rc;
101	}	101	}
102		102
103	/* Inspect all section headers and proccess them. */	103	/* Inspect all section headers and proccess them. */
104	for (i = 0; i < header->e_shnum; i++) {	104	for (i = 0; i < header->e_shnum; i++) {
105	rc = section_header(&((elf_section_header_t )(((uint8_t ) header) + header->e_shoff))[i], header, as);	105	rc = section_header(&((elf_section_header_t )(((uint8_t ) header) + header->e_shoff))[i], header, as);
106	if (rc != EE_OK)	106	if (rc != EE_OK)
107	return rc;	107	return rc;
108	}	108	}
109		109
110	return EE_OK;	110	return EE_OK;
111	}	111	}
112		112
113	/** Print error message according to error code.	113	/** Print error message according to error code.
114	*	114	*
115	* @param rc Return code returned by elf_load().	115	* @param rc Return code returned by elf_load().
116	*	116	*
117	* @return NULL terminated description of error.	117	* @return NULL terminated description of error.
118	*/	118	*/
119	char *elf_error(int rc)	119	char *elf_error(int rc)
120	{	120	{
121	ASSERT(rc < sizeof(error_codes)/sizeof(char *));	121	ASSERT(rc < sizeof(error_codes)/sizeof(char *));
122		122
123	return error_codes[rc];	123	return error_codes[rc];
124	}	124	}
125		125
126	/** Process segment header.	126	/** Process segment header.
127	*	127	*
128	* @param entry Segment header.	128	* @param entry Segment header.
129	* @param elf ELF header.	129	* @param elf ELF header.
130	* @param as Address space into wich the ELF is being loaded.	130	* @param as Address space into wich the ELF is being loaded.
131	*	131	*
132	* @return EE_OK on success, error code otherwise.	132	* @return EE_OK on success, error code otherwise.
133	*/	133	*/
134	static int segment_header(elf_segment_header_t entry, elf_header_t elf, as_t *as)	134	static int segment_header(elf_segment_header_t entry, elf_header_t elf, as_t *as)
135	{	135	{
136	switch (entry->p_type) {	136	switch (entry->p_type) {
137	case PT_NULL:	137	case PT_NULL:
138	case PT_PHDR:	138	case PT_PHDR:
139	break;	139	break;
140	case PT_LOAD:	140	case PT_LOAD:
141	return load_segment(entry, elf, as);	141	return load_segment(entry, elf, as);
142	break;	142	break;
143	case PT_DYNAMIC:	143	case PT_DYNAMIC:
144	case PT_INTERP:	144	case PT_INTERP:
145	case PT_SHLIB:	145	case PT_SHLIB:
146	case PT_NOTE:	146	case PT_NOTE:
147	case PT_LOPROC:	147	case PT_LOPROC:
148	case PT_HIPROC:	148	case PT_HIPROC:
149	default:	149	default:
150	return EE_UNSUPPORTED;	150	return EE_UNSUPPORTED;
151	break;	151	break;
152	}	152	}
153	return EE_OK;	153	return EE_OK;
154	}	154	}
155		155
156	/** Load segment described by program header entry.	156	/** Load segment described by program header entry.
157	*	157	*
158	* @param entry Program header entry describing segment to be loaded.	158	* @param entry Program header entry describing segment to be loaded.
159	* @param elf ELF header.	159	* @param elf ELF header.
160	* @param as Address space into wich the ELF is being loaded.	160	* @param as Address space into wich the ELF is being loaded.
161	*	161	*
162	* @return EE_OK on success, error code otherwise.	162	* @return EE_OK on success, error code otherwise.
163	*/	163	*/
164	int load_segment(elf_segment_header_t entry, elf_header_t elf, as_t *as)	164	int load_segment(elf_segment_header_t entry, elf_header_t elf, as_t *as)
165	{	165	{
166	as_area_t *a;	166	as_area_t *a;
167	int flags = 0;	167	int flags = 0;
168	mem_backend_data_t backend_data;	168	mem_backend_data_t backend_data;
169		169
170	backend_data.elf = elf;	170	backend_data.elf = elf;
171	backend_data.segment = entry;	171	backend_data.segment = entry;
172		172
173	if (entry->p_align > 1) {	173	if (entry->p_align > 1) {
174	if ((entry->p_offset % entry->p_align) != (entry->p_vaddr % entry->p_align)) {	174	if ((entry->p_offset % entry->p_align) != (entry->p_vaddr % entry->p_align)) {
175	return EE_INVALID;	175	return EE_INVALID;
176	}	176	}
177	}	177	}
178		178
179	if (entry->p_flags & PF_X)	179	if (entry->p_flags & PF_X)
180	flags \|= AS_AREA_EXEC;	180	flags \|= AS_AREA_EXEC;
181	if (entry->p_flags & PF_W)	181	if (entry->p_flags & PF_W)
182	flags \|= AS_AREA_WRITE;	182	flags \|= AS_AREA_WRITE;
183	if (entry->p_flags & PF_R)	183	if (entry->p_flags & PF_R)
184	flags \|= AS_AREA_READ;	184	flags \|= AS_AREA_READ;
185	flags \|= AS_AREA_CACHEABLE;	185	flags \|= AS_AREA_CACHEABLE;
186		186
187	/*	187	/*
188	* Check if the virtual address starts on page boundary.	188	* Check if the virtual address starts on page boundary.
189	*/	189	*/
190	if (ALIGN_UP(entry->p_vaddr, PAGE_SIZE) != entry->p_vaddr)	190	if (ALIGN_UP(entry->p_vaddr, PAGE_SIZE) != entry->p_vaddr)
191	return EE_UNSUPPORTED;	191	return EE_UNSUPPORTED;
192		192
193	a = as_area_create(as, flags, entry->p_memsz, entry->p_vaddr, AS_AREA_ATTR_NONE,	193	a = as_area_create(as, flags, entry->p_memsz, entry->p_vaddr, AS_AREA_ATTR_NONE,
194	&elf_backend, &backend_data);	194	&elf_backend, &backend_data);
195	if (!a)	195	if (!a)
196	return EE_MEMORY;	196	return EE_MEMORY;
197		197
198	/*	198	/*
199	* The segment will be mapped on demand by elf_page_fault().	199	* The segment will be mapped on demand by elf_page_fault().
200	*/	200	*/
201		201
202	return EE_OK;	202	return EE_OK;
203	}	203	}
204		204
205	/** Process section header.	205	/** Process section header.
206	*	206	*
207	* @param entry Segment header.	207	* @param entry Segment header.
208	* @param elf ELF header.	208	* @param elf ELF header.
209	* @param as Address space into wich the ELF is being loaded.	209	* @param as Address space into wich the ELF is being loaded.
210	*	210	*
211	* @return EE_OK on success, error code otherwise.	211	* @return EE_OK on success, error code otherwise.
212	*/	212	*/
213	static int section_header(elf_section_header_t entry, elf_header_t elf, as_t *as)	213	static int section_header(elf_section_header_t entry, elf_header_t elf, as_t *as)
214	{	214	{
215	switch (entry->sh_type) {	215	switch (entry->sh_type) {
216	default:	216	default:
217	break;	217	break;
218	}	218	}
219		219
220	return EE_OK;	220	return EE_OK;
221	}	221	}
222		222
223	/** @}	223	/** @}
224	*/	224	*/
225		225

Subversion Repositories HelenOS

(root)/tags/0.2.0.5/kernel/generic/src/lib/elf.c – Rev 2089 → 2474