2 * Copyright (c) 2007-2008 Apple Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
31 #include <mach/machine.h>
32 #include <sys/types.h>
34 #include <libkern/kxld_types.h>
36 #include "kxld_types.h"
46 struct relocation_info
;
48 typedef struct kxld_relocator KXLDRelocator
;
49 typedef struct kxld_reloc KXLDReloc
;
51 typedef boolean_t (*RelocHasPair
)(u_int r_type
);
52 typedef u_int (*RelocGetPairType
)(u_int prev_r_type
);
53 typedef boolean_t (*RelocHasGot
)(u_int r_type
);
54 typedef kern_return_t(*ProcessReloc
)(const KXLDRelocator
*relocator
,
55 u_char
*instruction
, u_int length
, u_int pcrel
, kxld_addr_t base_pc
,
56 kxld_addr_t link_pc
, kxld_addr_t link_disp
, u_int type
,
57 kxld_addr_t target
, kxld_addr_t pair_target
, boolean_t swap
);
59 struct kxld_relocator
{
60 RelocHasPair reloc_has_pair
;
61 RelocGetPairType reloc_get_pair_type
;
62 RelocHasGot reloc_has_got
;
63 ProcessReloc process_reloc
;
64 const struct kxld_symtab
*symtab
;
65 const struct kxld_array
*sectarray
;
66 const struct kxld_dict
*vtables
;
67 const struct kxld_vtable
*current_vtable
;
69 u_int function_align
; /* Power of two alignment of functions */
72 boolean_t may_scatter
;
81 u_int pair_target_type
:3;
87 /*******************************************************************************
88 * Constructors and Destructors
89 *******************************************************************************/
90 kern_return_t
kxld_relocator_init(KXLDRelocator
*relocator
, u_char
*file
,
91 const struct kxld_symtab
*symtab
, const struct kxld_array
*sectarray
,
92 cpu_type_t cputype
, cpu_subtype_t cpusubtype
, boolean_t swap
)
93 __attribute__((nonnull
,visibility("hidden")));
95 kern_return_t
kxld_reloc_create_macho(struct kxld_array
*relocarray
,
96 const KXLDRelocator
*relocator
, const struct relocation_info
*srcs
,
97 u_int nsrcs
) __attribute__((nonnull
, visibility("hidden")));
99 void kxld_relocator_clear(KXLDRelocator
*relocator
)
100 __attribute__((nonnull
, visibility("hidden")));
102 /*******************************************************************************
104 *******************************************************************************/
106 boolean_t
kxld_relocator_has_pair(const KXLDRelocator
*relocator
, u_int r_type
)
107 __attribute__((pure
, nonnull
,visibility("hidden")));
109 u_int
kxld_relocator_get_pair_type(const KXLDRelocator
*relocator
,
111 __attribute__((pure
, nonnull
,visibility("hidden")));
113 boolean_t
kxld_relocator_has_got(const KXLDRelocator
*relocator
, u_int r_type
)
114 __attribute__((pure
, nonnull
,visibility("hidden")));
116 kxld_addr_t
kxld_relocator_get_pointer_at_addr(const KXLDRelocator
*relocator
,
117 const u_char
*data
, u_long offset
)
118 __attribute__((pure
, nonnull
,visibility("hidden")));
120 struct kxld_sym
* kxld_reloc_get_symbol(const KXLDRelocator
*relocator
,
121 const KXLDReloc
*reloc
, const u_char
*data
)
122 __attribute__((pure
, nonnull(1,2), visibility("hidden")));
124 kern_return_t
kxld_reloc_get_reloc_index_by_offset(const struct kxld_array
*relocs
,
125 kxld_size_t offset
, u_int
*idx
)
126 __attribute__((nonnull
, visibility("hidden")));
128 KXLDReloc
* kxld_reloc_get_reloc_by_offset(const struct kxld_array
*relocs
,
130 __attribute__((pure
, nonnull
, visibility("hidden")));
133 u_long
kxld_reloc_get_macho_header_size(void)
134 __attribute__((pure
, visibility("hidden")));
136 u_long
kxld_reloc_get_macho_data_size(const struct kxld_array
*locrelocs
,
137 const struct kxld_array
*extrelocs
)
138 __attribute__((pure
, nonnull
, visibility("hidden")));
140 kern_return_t
kxld_reloc_export_macho(const KXLDRelocator
*relocator
,
141 const struct kxld_array
*locrelocs
, const struct kxld_array
*extrelocs
,
142 u_char
*buf
, u_long
*header_offset
, u_long header_size
,
143 u_long
*data_offset
, u_long size
)
144 __attribute__((nonnull
, visibility("hidden")));
145 #endif /* KXLD_PIC_KEXTS */
147 /*******************************************************************************
149 *******************************************************************************/
151 kern_return_t
kxld_reloc_update_symindex(KXLDReloc
*reloc
, u_int symindex
)
152 __attribute__((nonnull
,visibility("hidden")));
154 void kxld_relocator_set_vtables(KXLDRelocator
*relocator
,
155 const struct kxld_dict
*vtables
)
156 __attribute__((nonnull
,visibility("hidden")));
158 kern_return_t
kxld_relocator_process_sect_reloc(KXLDRelocator
*relocator
,
159 const KXLDReloc
*reloc
, const struct kxld_sect
*sect
)
160 __attribute__((nonnull
,visibility("hidden")));
162 kern_return_t
kxld_relocator_process_table_reloc(KXLDRelocator
*relocator
,
163 const KXLDReloc
*reloc
,
164 const struct kxld_seg
*seg
,
165 kxld_addr_t link_addr
)
166 __attribute__((nonnull
,visibility("hidden")));
168 #endif /* _KXLD_RELOC_H */