Root/
1 | /* This file is derived from the GAS 2.1.4 assembler control file. |
2 | The GAS product is under the GNU General Public License, version 2 or later. |
3 | As such, this file is also under that license. |
4 | |
5 | If the file format changes in the COFF object, this file should be |
6 | subsequently updated to reflect the changes. |
7 | |
8 | The actual loader module only uses a few of these structures. The full |
9 | set is documented here because I received the full set. If you wish |
10 | more information about COFF, then O'Reilly has a very excellent book. |
11 | */ |
12 | |
13 | #define E_SYMNMLEN 8 /* Number of characters in a symbol name */ |
14 | #define E_FILNMLEN 14 /* Number of characters in a file name */ |
15 | #define E_DIMNUM 4 /* Number of array dimensions in auxiliary entry */ |
16 | |
17 | /* |
18 | * These defines are byte order independent. There is no alignment of fields |
19 | * permitted in the structures. Therefore they are declared as characters |
20 | * and the values loaded from the character positions. It also makes it |
21 | * nice to have it "endian" independent. |
22 | */ |
23 | |
24 | /* Load a short int from the following tables with little-endian formats */ |
25 | #define COFF_SHORT_L(ps) ((short)(((unsigned short)((unsigned char)ps[1])<<8)|\ |
26 | ((unsigned short)((unsigned char)ps[0])))) |
27 | |
28 | /* Load a long int from the following tables with little-endian formats */ |
29 | #define COFF_LONG_L(ps) (((long)(((unsigned long)((unsigned char)ps[3])<<24) |\ |
30 | ((unsigned long)((unsigned char)ps[2])<<16) |\ |
31 | ((unsigned long)((unsigned char)ps[1])<<8) |\ |
32 | ((unsigned long)((unsigned char)ps[0]))))) |
33 | |
34 | /* Load a short int from the following tables with big-endian formats */ |
35 | #define COFF_SHORT_H(ps) ((short)(((unsigned short)((unsigned char)ps[0])<<8)|\ |
36 | ((unsigned short)((unsigned char)ps[1])))) |
37 | |
38 | /* Load a long int from the following tables with big-endian formats */ |
39 | #define COFF_LONG_H(ps) (((long)(((unsigned long)((unsigned char)ps[0])<<24) |\ |
40 | ((unsigned long)((unsigned char)ps[1])<<16) |\ |
41 | ((unsigned long)((unsigned char)ps[2])<<8) |\ |
42 | ((unsigned long)((unsigned char)ps[3]))))) |
43 | |
44 | /* These may be overridden later by brain dead implementations which generate |
45 | a big-endian header with little-endian data. In that case, generate a |
46 | replacement macro which tests a flag and uses either of the two above |
47 | as appropriate. */ |
48 | |
49 | #define COFF_LONG(v) COFF_LONG_L(v) |
50 | #define COFF_SHORT(v) COFF_SHORT_L(v) |
51 | |
52 | /*** coff information for Intel 386/486. */ |
53 | |
54 | /********************** FILE HEADER **********************/ |
55 | |
56 | struct COFF_filehdr { |
57 | char f_magic[2]; /* magic number */ |
58 | char f_nscns[2]; /* number of sections */ |
59 | char f_timdat[4]; /* time & date stamp */ |
60 | char f_symptr[4]; /* file pointer to symtab */ |
61 | char f_nsyms[4]; /* number of symtab entries */ |
62 | char f_opthdr[2]; /* sizeof(optional hdr) */ |
63 | char f_flags[2]; /* flags */ |
64 | }; |
65 | |
66 | /* |
67 | * Bits for f_flags: |
68 | * |
69 | * F_RELFLG relocation info stripped from file |
70 | * F_EXEC file is executable (i.e. no unresolved external |
71 | * references) |
72 | * F_LNNO line numbers stripped from file |
73 | * F_LSYMS local symbols stripped from file |
74 | * F_MINMAL this is a minimal object file (".m") output of fextract |
75 | * F_UPDATE this is a fully bound update file, output of ogen |
76 | * F_SWABD this file has had its bytes swabbed (in names) |
77 | * F_AR16WR this file has the byte ordering of an AR16WR |
78 | * (e.g. 11/70) machine |
79 | * F_AR32WR this file has the byte ordering of an AR32WR machine |
80 | * (e.g. vax and iNTEL 386) |
81 | * F_AR32W this file has the byte ordering of an AR32W machine |
82 | * (e.g. 3b,maxi) |
83 | * F_PATCH file contains "patch" list in optional header |
84 | * F_NODF (minimal file only) no decision functions for |
85 | * replaced functions |
86 | */ |
87 | |
88 | #define COFF_F_RELFLG 0000001 |
89 | #define COFF_F_EXEC 0000002 |
90 | #define COFF_F_LNNO 0000004 |
91 | #define COFF_F_LSYMS 0000010 |
92 | #define COFF_F_MINMAL 0000020 |
93 | #define COFF_F_UPDATE 0000040 |
94 | #define COFF_F_SWABD 0000100 |
95 | #define COFF_F_AR16WR 0000200 |
96 | #define COFF_F_AR32WR 0000400 |
97 | #define COFF_F_AR32W 0001000 |
98 | #define COFF_F_PATCH 0002000 |
99 | #define COFF_F_NODF 0002000 |
100 | |
101 | #define COFF_I386MAGIC 0x14c /* Linux's system */ |
102 | |
103 | #if 0 /* Perhaps, someday, these formats may be used. */ |
104 | #define COFF_I386PTXMAGIC 0x154 |
105 | #define COFF_I386AIXMAGIC 0x175 /* IBM's AIX system */ |
106 | #define COFF_I386BADMAG(x) ((COFF_SHORT((x).f_magic) != COFF_I386MAGIC) \ |
107 | && COFF_SHORT((x).f_magic) != COFF_I386PTXMAGIC \ |
108 | && COFF_SHORT((x).f_magic) != COFF_I386AIXMAGIC) |
109 | #else |
110 | #define COFF_I386BADMAG(x) (COFF_SHORT((x).f_magic) != COFF_I386MAGIC) |
111 | #endif |
112 | |
113 | #define COFF_FILHDR struct COFF_filehdr |
114 | #define COFF_FILHSZ sizeof(COFF_FILHDR) |
115 | |
116 | /********************** AOUT "OPTIONAL HEADER" **********************/ |
117 | |
118 | /* Linux COFF must have this "optional" header. Standard COFF has no entry |
119 | location for the "entry" point. They normally would start with the first |
120 | location of the .text section. This is not a good idea for linux. So, |
121 | the use of this "optional" header is not optional. It is required. |
122 | |
123 | Do not be tempted to assume that the size of the optional header is |
124 | a constant and simply index the next byte by the size of this structure. |
125 | Use the 'f_opthdr' field in the main coff header for the size of the |
126 | structure actually written to the file!! |
127 | */ |
128 | |
129 | typedef struct |
130 | { |
131 | char magic[2]; /* type of file */ |
132 | char vstamp[2]; /* version stamp */ |
133 | char tsize[4]; /* text size in bytes, padded to FW bdry */ |
134 | char dsize[4]; /* initialized data " " */ |
135 | char bsize[4]; /* uninitialized data " " */ |
136 | char entry[4]; /* entry pt. */ |
137 | char text_start[4]; /* base of text used for this file */ |
138 | char data_start[4]; /* base of data used for this file */ |
139 | } |
140 | COFF_AOUTHDR; |
141 | |
142 | #define COFF_AOUTSZ (sizeof(COFF_AOUTHDR)) |
143 | |
144 | #define COFF_STMAGIC 0401 |
145 | #define COFF_OMAGIC 0404 |
146 | #define COFF_JMAGIC 0407 /* dirty text and data image, can't share */ |
147 | #define COFF_DMAGIC 0410 /* dirty text segment, data aligned */ |
148 | #define COFF_ZMAGIC 0413 /* The proper magic number for executables */ |
149 | #define COFF_SHMAGIC 0443 /* shared library header */ |
150 | |
151 | /********************** SECTION HEADER **********************/ |
152 | |
153 | struct COFF_scnhdr { |
154 | char s_name[8]; /* section name */ |
155 | char s_paddr[4]; /* physical address, aliased s_nlib */ |
156 | char s_vaddr[4]; /* virtual address */ |
157 | char s_size[4]; /* section size */ |
158 | char s_scnptr[4]; /* file ptr to raw data for section */ |
159 | char s_relptr[4]; /* file ptr to relocation */ |
160 | char s_lnnoptr[4]; /* file ptr to line numbers */ |
161 | char s_nreloc[2]; /* number of relocation entries */ |
162 | char s_nlnno[2]; /* number of line number entries */ |
163 | char s_flags[4]; /* flags */ |
164 | }; |
165 | |
166 | #define COFF_SCNHDR struct COFF_scnhdr |
167 | #define COFF_SCNHSZ sizeof(COFF_SCNHDR) |
168 | |
169 | /* |
170 | * names of "special" sections |
171 | */ |
172 | |
173 | #define COFF_TEXT ".text" |
174 | #define COFF_DATA ".data" |
175 | #define COFF_BSS ".bss" |
176 | #define COFF_COMMENT ".comment" |
177 | #define COFF_LIB ".lib" |
178 | |
179 | #define COFF_SECT_TEXT 0 /* Section for instruction code */ |
180 | #define COFF_SECT_DATA 1 /* Section for initialized globals */ |
181 | #define COFF_SECT_BSS 2 /* Section for un-initialized globals */ |
182 | #define COFF_SECT_REQD 3 /* Minimum number of sections for good file */ |
183 | |
184 | #define COFF_STYP_REG 0x00 /* regular segment */ |
185 | #define COFF_STYP_DSECT 0x01 /* dummy segment */ |
186 | #define COFF_STYP_NOLOAD 0x02 /* no-load segment */ |
187 | #define COFF_STYP_GROUP 0x04 /* group segment */ |
188 | #define COFF_STYP_PAD 0x08 /* .pad segment */ |
189 | #define COFF_STYP_COPY 0x10 /* copy section */ |
190 | #define COFF_STYP_TEXT 0x20 /* .text segment */ |
191 | #define COFF_STYP_DATA 0x40 /* .data segment */ |
192 | #define COFF_STYP_BSS 0x80 /* .bss segment */ |
193 | #define COFF_STYP_INFO 0x200 /* .comment section */ |
194 | #define COFF_STYP_OVER 0x400 /* overlay section */ |
195 | #define COFF_STYP_LIB 0x800 /* library section */ |
196 | |
197 | /* |
198 | * Shared libraries have the following section header in the data field for |
199 | * each library. |
200 | */ |
201 | |
202 | struct COFF_slib { |
203 | char sl_entsz[4]; /* Size of this entry */ |
204 | char sl_pathndx[4]; /* size of the header field */ |
205 | }; |
206 | |
207 | #define COFF_SLIBHD struct COFF_slib |
208 | #define COFF_SLIBSZ sizeof(COFF_SLIBHD) |
209 | |
210 | /********************** LINE NUMBERS **********************/ |
211 | |
212 | /* 1 line number entry for every "breakpointable" source line in a section. |
213 | * Line numbers are grouped on a per function basis; first entry in a function |
214 | * grouping will have l_lnno = 0 and in place of physical address will be the |
215 | * symbol table index of the function name. |
216 | */ |
217 | |
218 | struct COFF_lineno { |
219 | union { |
220 | char l_symndx[4]; /* function name symbol index, iff l_lnno == 0*/ |
221 | char l_paddr[4]; /* (physical) address of line number */ |
222 | } l_addr; |
223 | char l_lnno[2]; /* line number */ |
224 | }; |
225 | |
226 | #define COFF_LINENO struct COFF_lineno |
227 | #define COFF_LINESZ 6 |
228 | |
229 | /********************** SYMBOLS **********************/ |
230 | |
231 | #define COFF_E_SYMNMLEN 8 /* # characters in a short symbol name */ |
232 | #define COFF_E_FILNMLEN 14 /* # characters in a file name */ |
233 | #define COFF_E_DIMNUM 4 /* # array dimensions in auxiliary entry */ |
234 | |
235 | /* |
236 | * All symbols and sections have the following definition |
237 | */ |
238 | |
239 | struct COFF_syment |
240 | { |
241 | union { |
242 | char e_name[E_SYMNMLEN]; /* Symbol name (first 8 characters) */ |
243 | struct { |
244 | char e_zeroes[4]; /* Leading zeros */ |
245 | char e_offset[4]; /* Offset if this is a header section */ |
246 | } e; |
247 | } e; |
248 | |
249 | char e_value[4]; /* Value (address) of the segment */ |
250 | char e_scnum[2]; /* Section number */ |
251 | char e_type[2]; /* Type of section */ |
252 | char e_sclass[1]; /* Loader class */ |
253 | char e_numaux[1]; /* Number of auxiliary entries which follow */ |
254 | }; |
255 | |
256 | #define COFF_N_BTMASK (0xf) /* Mask for important class bits */ |
257 | #define COFF_N_TMASK (0x30) /* Mask for important type bits */ |
258 | #define COFF_N_BTSHFT (4) /* # bits to shift class field */ |
259 | #define COFF_N_TSHIFT (2) /* # bits to shift type field */ |
260 | |
261 | /* |
262 | * Auxiliary entries because the main table is too limiting. |
263 | */ |
264 | |
265 | union COFF_auxent { |
266 | |
267 | /* |
268 | * Debugger information |
269 | */ |
270 | |
271 | struct { |
272 | char x_tagndx[4]; /* str, un, or enum tag indx */ |
273 | union { |
274 | struct { |
275 | char x_lnno[2]; /* declaration line number */ |
276 | char x_size[2]; /* str/union/array size */ |
277 | } x_lnsz; |
278 | char x_fsize[4]; /* size of function */ |
279 | } x_misc; |
280 | |
281 | union { |
282 | struct { /* if ISFCN, tag, or .bb */ |
283 | char x_lnnoptr[4]; /* ptr to fcn line # */ |
284 | char x_endndx[4]; /* entry ndx past block end */ |
285 | } x_fcn; |
286 | |
287 | struct { /* if ISARY, up to 4 dimen. */ |
288 | char x_dimen[E_DIMNUM][2]; |
289 | } x_ary; |
290 | } x_fcnary; |
291 | |
292 | char x_tvndx[2]; /* tv index */ |
293 | } x_sym; |
294 | |
295 | /* |
296 | * Source file names (debugger information) |
297 | */ |
298 | |
299 | union { |
300 | char x_fname[E_FILNMLEN]; |
301 | struct { |
302 | char x_zeroes[4]; |
303 | char x_offset[4]; |
304 | } x_n; |
305 | } x_file; |
306 | |
307 | /* |
308 | * Section information |
309 | */ |
310 | |
311 | struct { |
312 | char x_scnlen[4]; /* section length */ |
313 | char x_nreloc[2]; /* # relocation entries */ |
314 | char x_nlinno[2]; /* # line numbers */ |
315 | } x_scn; |
316 | |
317 | /* |
318 | * Transfer vector (branch table) |
319 | */ |
320 | |
321 | struct { |
322 | char x_tvfill[4]; /* tv fill value */ |
323 | char x_tvlen[2]; /* length of .tv */ |
324 | char x_tvran[2][2]; /* tv range */ |
325 | } x_tv; /* info about .tv section (in auxent of symbol .tv)) */ |
326 | }; |
327 | |
328 | #define COFF_SYMENT struct COFF_syment |
329 | #define COFF_SYMESZ 18 |
330 | #define COFF_AUXENT union COFF_auxent |
331 | #define COFF_AUXESZ 18 |
332 | |
333 | #define COFF_ETEXT "etext" |
334 | |
335 | /********************** RELOCATION DIRECTIVES **********************/ |
336 | |
337 | struct COFF_reloc { |
338 | char r_vaddr[4]; /* Virtual address of item */ |
339 | char r_symndx[4]; /* Symbol index in the symtab */ |
340 | char r_type[2]; /* Relocation type */ |
341 | }; |
342 | |
343 | #define COFF_RELOC struct COFF_reloc |
344 | #define COFF_RELSZ 10 |
345 | |
346 | #define COFF_DEF_DATA_SECTION_ALIGNMENT 4 |
347 | #define COFF_DEF_BSS_SECTION_ALIGNMENT 4 |
348 | #define COFF_DEF_TEXT_SECTION_ALIGNMENT 4 |
349 | |
350 | /* For new sections we haven't heard of before */ |
351 | #define COFF_DEF_SECTION_ALIGNMENT 4 |
352 |
Branches:
ben-wpan
ben-wpan-stefan
javiroman/ks7010
jz-2.6.34
jz-2.6.34-rc5
jz-2.6.34-rc6
jz-2.6.34-rc7
jz-2.6.35
jz-2.6.36
jz-2.6.37
jz-2.6.38
jz-2.6.39
jz-3.0
jz-3.1
jz-3.11
jz-3.12
jz-3.13
jz-3.15
jz-3.16
jz-3.18-dt
jz-3.2
jz-3.3
jz-3.4
jz-3.5
jz-3.6
jz-3.6-rc2-pwm
jz-3.9
jz-3.9-clk
jz-3.9-rc8
jz47xx
jz47xx-2.6.38
master
Tags:
od-2011-09-04
od-2011-09-18
v2.6.34-rc5
v2.6.34-rc6
v2.6.34-rc7
v3.9