linker.h revision bda5da074eab4bdf374e1f4a19d480c62c72f5ff
1/* 2 * Copyright (C) 2008 The Android Open Source Project 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in 12 * the documentation and/or other materials provided with the 13 * distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 18 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 19 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 22 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 23 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 25 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29#ifndef _LINKER_H_ 30#define _LINKER_H_ 31 32#include <unistd.h> 33#include <sys/types.h> 34#include <linux/elf.h> 35 36#undef PAGE_MASK 37#undef PAGE_SIZE 38#define PAGE_SIZE 4096 39#define PAGE_MASK 4095 40 41void debugger_init(); 42const char *addr_to_name(unsigned addr); 43 44/* magic shared structures that GDB knows about */ 45 46struct link_map 47{ 48 uintptr_t l_addr; 49 char * l_name; 50 uintptr_t l_ld; 51 struct link_map * l_next; 52 struct link_map * l_prev; 53}; 54 55/* needed for dl_iterate_phdr to be passed to the callbacks provided */ 56struct dl_phdr_info 57{ 58 Elf32_Addr dlpi_addr; 59 const char *dlpi_name; 60 const Elf32_Phdr *dlpi_phdr; 61 Elf32_Half dlpi_phnum; 62}; 63 64 65// Values for r_debug->state 66enum { 67 RT_CONSISTENT, 68 RT_ADD, 69 RT_DELETE 70}; 71 72struct r_debug 73{ 74 int32_t r_version; 75 struct link_map * r_map; 76 void (*r_brk)(void); 77 int32_t r_state; 78 uintptr_t r_ldbase; 79}; 80 81typedef struct soinfo soinfo; 82 83#define FLAG_LINKED 0x00000001 84#define FLAG_ERROR 0x00000002 85#define FLAG_EXE 0x00000004 // The main executable 86 87#define SOINFO_NAME_LEN 128 88 89struct soinfo 90{ 91 const char name[SOINFO_NAME_LEN]; 92 Elf32_Phdr *phdr; 93 int phnum; 94 unsigned entry; 95 unsigned base; 96 unsigned size; 97 98 int unused; // DO NOT USE, maintained for compatibility. 99 100 unsigned *dynamic; 101 102 unsigned wrprotect_start; 103 unsigned wrprotect_end; 104 105 soinfo *next; 106 unsigned flags; 107 108 const char *strtab; 109 Elf32_Sym *symtab; 110 111 unsigned nbucket; 112 unsigned nchain; 113 unsigned *bucket; 114 unsigned *chain; 115 116 unsigned *plt_got; 117 118 Elf32_Rel *plt_rel; 119 unsigned plt_rel_count; 120 121 Elf32_Rel *rel; 122 unsigned rel_count; 123 124#ifdef ANDROID_SH_LINKER 125 Elf32_Rela *plt_rela; 126 unsigned plt_rela_count; 127 128 Elf32_Rela *rela; 129 unsigned rela_count; 130#endif /* ANDROID_SH_LINKER */ 131 132 unsigned *preinit_array; 133 unsigned preinit_array_count; 134 135 unsigned *init_array; 136 unsigned init_array_count; 137 unsigned *fini_array; 138 unsigned fini_array_count; 139 140 void (*init_func)(void); 141 void (*fini_func)(void); 142 143#ifdef ANDROID_ARM_LINKER 144 /* ARM EABI section used for stack unwinding. */ 145 unsigned *ARM_exidx; 146 unsigned ARM_exidx_count; 147#endif 148 149 unsigned refcount; 150 struct link_map linkmap; 151}; 152 153 154extern soinfo libdl_info; 155 156#ifdef ANDROID_ARM_LINKER 157 158#define R_ARM_COPY 20 159#define R_ARM_GLOB_DAT 21 160#define R_ARM_JUMP_SLOT 22 161#define R_ARM_RELATIVE 23 162 163/* According to the AAPCS specification, we only 164 * need the above relocations. However, in practice, 165 * the following ones turn up from time to time. 166 */ 167#define R_ARM_ABS32 2 168#define R_ARM_REL32 3 169 170#elif defined(ANDROID_X86_LINKER) 171 172#define R_386_32 1 173#define R_386_PC32 2 174#define R_386_GLOB_DAT 6 175#define R_386_JUMP_SLOT 7 176#define R_386_RELATIVE 8 177 178#elif defined(ANDROID_SH_LINKER) 179 180#define R_SH_DIR32 1 181#define R_SH_GLOB_DAT 163 182#define R_SH_JUMP_SLOT 164 183#define R_SH_RELATIVE 165 184 185#endif /* ANDROID_*_LINKER */ 186 187 188#ifndef DT_INIT_ARRAY 189#define DT_INIT_ARRAY 25 190#endif 191 192#ifndef DT_FINI_ARRAY 193#define DT_FINI_ARRAY 26 194#endif 195 196#ifndef DT_INIT_ARRAYSZ 197#define DT_INIT_ARRAYSZ 27 198#endif 199 200#ifndef DT_FINI_ARRAYSZ 201#define DT_FINI_ARRAYSZ 28 202#endif 203 204#ifndef DT_PREINIT_ARRAY 205#define DT_PREINIT_ARRAY 32 206#endif 207 208#ifndef DT_PREINIT_ARRAYSZ 209#define DT_PREINIT_ARRAYSZ 33 210#endif 211 212soinfo *find_library(const char *name); 213unsigned unload_library(soinfo *si); 214Elf32_Sym *lookup_in_library(soinfo *si, const char *name); 215Elf32_Sym *lookup(const char *name, soinfo **found, soinfo *start); 216soinfo *find_containing_library(const void *addr); 217Elf32_Sym *find_containing_symbol(const void *addr, soinfo *si); 218const char *linker_get_error(void); 219 220#ifdef ANDROID_ARM_LINKER 221typedef long unsigned int *_Unwind_Ptr; 222_Unwind_Ptr dl_unwind_find_exidx(_Unwind_Ptr pc, int *pcount); 223#elif defined(ANDROID_X86_LINKER) || defined(ANDROID_SH_LINKER) 224int dl_iterate_phdr(int (*cb)(struct dl_phdr_info *, size_t, void *), void *); 225#endif 226 227#endif 228