Document the GDB 8.3 release in gdb/ChangeLog
[external/binutils.git] / bfd / mach-o.h
1 /* Mach-O support for BFD.
2    Copyright (C) 1999-2019 Free Software Foundation, Inc.
3
4    This file is part of BFD, the Binary File Descriptor library.
5
6    This program is free software; you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation; either version 3 of the License, or
9    (at your option) any later version.
10
11    This program is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with this program; if not, write to the Free Software
18    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
19    MA 02110-1301, USA.  */
20
21 #ifndef _BFD_MACH_O_H_
22 #define _BFD_MACH_O_H_
23
24 #include "mach-o/loader.h"
25 #include "mach-o/external.h"
26
27 #ifdef __cplusplus
28 extern "C" {
29 #endif
30
31 typedef struct bfd_mach_o_header
32 {
33   unsigned long magic;
34   unsigned long cputype;
35   unsigned long cpusubtype;
36   unsigned long filetype;
37   unsigned long ncmds;
38   unsigned long sizeofcmds;
39   unsigned long flags;
40   unsigned int reserved;
41   /* Version 1: 32 bits, version 2: 64 bits.  */
42   unsigned int version;
43   enum bfd_endian byteorder;
44 }
45 bfd_mach_o_header;
46
47 typedef struct bfd_mach_o_asymbol
48 {
49   /* The actual symbol which the rest of BFD works with.  */
50   asymbol symbol;
51
52   /* Mach-O symbol fields.  */
53   unsigned char n_type;
54   unsigned char n_sect;
55   unsigned short n_desc;
56 }
57 bfd_mach_o_asymbol;
58
59 #define BFD_MACH_O_SEGNAME_SIZE 16
60 #define BFD_MACH_O_SECTNAME_SIZE 16
61
62 typedef struct bfd_mach_o_section
63 {
64   /* Fields present in the file.  */
65   char sectname[BFD_MACH_O_SECTNAME_SIZE + 1];  /* Always NUL padded.  */
66   char segname[BFD_MACH_O_SEGNAME_SIZE + 1];
67   bfd_vma addr;
68   bfd_vma size;
69   bfd_vma offset;
70   unsigned long align;
71   bfd_vma reloff;
72   unsigned long nreloc;
73   unsigned long flags;
74   unsigned long reserved1;
75   unsigned long reserved2;
76   unsigned long reserved3;
77
78   /* Corresponding bfd section.  */
79   asection *bfdsection;
80
81   /* An array holding the indirect symbols for this section.
82      NULL values indicate local symbols.
83      The number of symbols is determined from the section size and type.  */
84
85   bfd_mach_o_asymbol **indirect_syms;
86
87   /* Simply linked list.  */
88   struct bfd_mach_o_section *next;
89 }
90 bfd_mach_o_section;
91
92 typedef struct bfd_mach_o_segment_command
93 {
94   char segname[BFD_MACH_O_SEGNAME_SIZE + 1];
95   bfd_vma vmaddr;
96   bfd_vma vmsize;
97   bfd_vma fileoff;
98   unsigned long filesize;
99   unsigned long maxprot;        /* Maximum permitted protection.  */
100   unsigned long initprot;       /* Initial protection.  */
101   unsigned long nsects;
102   unsigned long flags;
103
104   /* Linked list of sections.  */
105   bfd_mach_o_section *sect_head;
106   bfd_mach_o_section *sect_tail;
107 }
108 bfd_mach_o_segment_command;
109
110 /* Protection flags.  */
111 #define BFD_MACH_O_PROT_READ    0x01
112 #define BFD_MACH_O_PROT_WRITE   0x02
113 #define BFD_MACH_O_PROT_EXECUTE 0x04
114
115 /* Target platforms.  */
116 #define BFD_MACH_O_PLATFORM_MACOS    1
117 #define BFD_MACH_O_PLATFORM_IOS      2
118 #define BFD_MACH_O_PLATFORM_TVOS     3
119 #define BFD_MACH_O_PLATFORM_WATCHOS  4
120 #define BFD_MACH_O_PLATFORM_BRIDGEOS 5
121
122 /* Build tools.  */
123 #define BFD_MACH_O_TOOL_CLANG 1
124 #define BFD_MACH_O_TOOL_SWIFT 2
125 #define BFD_MACH_O_TOOL_LD    3
126
127 /* Expanded internal representation of a relocation entry.  */
128 typedef struct bfd_mach_o_reloc_info
129 {
130   bfd_vma r_address;
131   bfd_vma r_value;
132   unsigned int r_scattered : 1;
133   unsigned int r_type : 4;
134   unsigned int r_pcrel : 1;
135   unsigned int r_length : 2;
136   unsigned int r_extern : 1;
137 }
138 bfd_mach_o_reloc_info;
139
140 /* The symbol table is sorted like this:
141  (1) local.
142         (otherwise in order of generation)
143  (2) external defined
144         (sorted by name)
145  (3) external undefined / common
146         (sorted by name)
147 */
148
149 typedef struct bfd_mach_o_symtab_command
150 {
151   unsigned int symoff;
152   unsigned int nsyms;
153   unsigned int stroff;
154   unsigned int strsize;
155   bfd_mach_o_asymbol *symbols;
156   char *strtab;
157 }
158 bfd_mach_o_symtab_command;
159
160 /* This is the second set of the symbolic information which is used to support
161    the data structures for the dynamically link editor.
162
163    The original set of symbolic information in the symtab_command which contains
164    the symbol and string tables must also be present when this load command is
165    present.  When this load command is present the symbol table is organized
166    into three groups of symbols:
167        local symbols (static and debugging symbols) - grouped by module
168        defined external symbols - grouped by module (sorted by name if not lib)
169        undefined external symbols (sorted by name)
170    In this load command there are offsets and counts to each of the three groups
171    of symbols.
172
173    This load command contains a the offsets and sizes of the following new
174    symbolic information tables:
175        table of contents
176        module table
177        reference symbol table
178        indirect symbol table
179    The first three tables above (the table of contents, module table and
180    reference symbol table) are only present if the file is a dynamically linked
181    shared library.  For executable and object modules, which are files
182    containing only one module, the information that would be in these three
183    tables is determined as follows:
184        table of contents - the defined external symbols are sorted by name
185        module table - the file contains only one module so everything in the
186                       file is part of the module.
187        reference symbol table - is the defined and undefined external symbols
188
189    For dynamically linked shared library files this load command also contains
190    offsets and sizes to the pool of relocation entries for all sections
191    separated into two groups:
192        external relocation entries
193        local relocation entries
194    For executable and object modules the relocation entries continue to hang
195    off the section structures.  */
196
197 typedef struct bfd_mach_o_dylib_module
198 {
199   /* Index into the string table indicating the name of the module.  */
200   unsigned long module_name_idx;
201   char *module_name;
202
203   /* Index into the symbol table of the first defined external symbol provided
204      by the module.  */
205   unsigned long iextdefsym;
206
207   /* Number of external symbols provided by this module.  */
208   unsigned long nextdefsym;
209
210   /* Index into the external reference table of the first entry
211      provided by this module.  */
212   unsigned long irefsym;
213
214   /* Number of external reference entries provided by this module.  */
215   unsigned long nrefsym;
216
217   /* Index into the symbol table of the first local symbol provided by this
218      module.  */
219   unsigned long ilocalsym;
220
221   /* Number of local symbols provided by this module.  */
222   unsigned long nlocalsym;
223
224   /* Index into the external relocation table of the first entry provided
225      by this module.  */
226   unsigned long iextrel;
227
228   /* Number of external relocation entries provided by this module.  */
229   unsigned long nextrel;
230
231   /* Index in the module initialization section to the pointers for this
232      module.  */
233   unsigned short iinit;
234
235   /* Index in the module termination section to the pointers for this
236      module.  */
237   unsigned short iterm;
238
239   /* Number of pointers in the module initialization for this module.  */
240   unsigned short ninit;
241
242   /* Number of pointers in the module termination for this module.  */
243   unsigned short nterm;
244
245   /* Number of data byte for this module that are used in the __module_info
246      section of the __OBJC segment.  */
247   unsigned long objc_module_info_size;
248
249   /* Statically linked address of the start of the data for this module
250      in the __module_info section of the __OBJC_segment.  */
251   bfd_vma objc_module_info_addr;
252 }
253 bfd_mach_o_dylib_module;
254
255 typedef struct bfd_mach_o_dylib_table_of_content
256 {
257   /* Index into the symbol table to the defined external symbol.  */
258   unsigned long symbol_index;
259
260   /* Index into the module table to the module for this entry.  */
261   unsigned long module_index;
262 }
263 bfd_mach_o_dylib_table_of_content;
264
265 typedef struct bfd_mach_o_dylib_reference
266 {
267   /* Index into the symbol table for the symbol being referenced.  */
268   unsigned long isym;
269
270   /* Type of the reference being made (use REFERENCE_FLAGS constants).  */
271   unsigned long flags;
272 }
273 bfd_mach_o_dylib_reference;
274 #define BFD_MACH_O_REFERENCE_SIZE 4
275
276 typedef struct bfd_mach_o_dysymtab_command
277 {
278   /* The symbols indicated by symoff and nsyms of the LC_SYMTAB load command
279      are grouped into the following three groups:
280        local symbols (further grouped by the module they are from)
281        defined external symbols (further grouped by the module they are from)
282        undefined symbols
283
284      The local symbols are used only for debugging.  The dynamic binding
285      process may have to use them to indicate to the debugger the local
286      symbols for a module that is being bound.
287
288      The last two groups are used by the dynamic binding process to do the
289      binding (indirectly through the module table and the reference symbol
290      table when this is a dynamically linked shared library file).  */
291
292   unsigned long ilocalsym;    /* Index to local symbols.  */
293   unsigned long nlocalsym;    /* Number of local symbols.  */
294   unsigned long iextdefsym;   /* Index to externally defined symbols.  */
295   unsigned long nextdefsym;   /* Number of externally defined symbols.  */
296   unsigned long iundefsym;    /* Index to undefined symbols.  */
297   unsigned long nundefsym;    /* Number of undefined symbols.  */
298
299   /* For the for the dynamic binding process to find which module a symbol
300      is defined in the table of contents is used (analogous to the ranlib
301      structure in an archive) which maps defined external symbols to modules
302      they are defined in.  This exists only in a dynamically linked shared
303      library file.  For executable and object modules the defined external
304      symbols are sorted by name and is use as the table of contents.  */
305
306   unsigned long tocoff;       /* File offset to table of contents.  */
307   unsigned long ntoc;         /* Number of entries in table of contents.  */
308
309   /* To support dynamic binding of "modules" (whole object files) the symbol
310      table must reflect the modules that the file was created from.  This is
311      done by having a module table that has indexes and counts into the merged
312      tables for each module.  The module structure that these two entries
313      refer to is described below.  This exists only in a dynamically linked
314      shared library file.  For executable and object modules the file only
315      contains one module so everything in the file belongs to the module.  */
316
317   unsigned long modtaboff;    /* File offset to module table.  */
318   unsigned long nmodtab;      /* Number of module table entries.  */
319
320   /* To support dynamic module binding the module structure for each module
321      indicates the external references (defined and undefined) each module
322      makes.  For each module there is an offset and a count into the
323      reference symbol table for the symbols that the module references.
324      This exists only in a dynamically linked shared library file.  For
325      executable and object modules the defined external symbols and the
326      undefined external symbols indicates the external references.  */
327
328   unsigned long extrefsymoff;  /* Offset to referenced symbol table.  */
329   unsigned long nextrefsyms;   /* Number of referenced symbol table entries.  */
330
331   /* The sections that contain "symbol pointers" and "routine stubs" have
332      indexes and (implied counts based on the size of the section and fixed
333      size of the entry) into the "indirect symbol" table for each pointer
334      and stub.  For every section of these two types the index into the
335      indirect symbol table is stored in the section header in the field
336      reserved1.  An indirect symbol table entry is simply a 32bit index into
337      the symbol table to the symbol that the pointer or stub is referring to.
338      The indirect symbol table is ordered to match the entries in the section.  */
339
340   unsigned long indirectsymoff; /* File offset to the indirect symbol table.  */
341   unsigned long nindirectsyms;  /* Number of indirect symbol table entries.  */
342
343   /* To support relocating an individual module in a library file quickly the
344      external relocation entries for each module in the library need to be
345      accessed efficiently.  Since the relocation entries can't be accessed
346      through the section headers for a library file they are separated into
347      groups of local and external entries further grouped by module.  In this
348      case the presents of this load command who's extreloff, nextrel,
349      locreloff and nlocrel fields are non-zero indicates that the relocation
350      entries of non-merged sections are not referenced through the section
351      structures (and the reloff and nreloc fields in the section headers are
352      set to zero).
353
354      Since the relocation entries are not accessed through the section headers
355      this requires the r_address field to be something other than a section
356      offset to identify the item to be relocated.  In this case r_address is
357      set to the offset from the vmaddr of the first LC_SEGMENT command.
358
359      The relocation entries are grouped by module and the module table
360      entries have indexes and counts into them for the group of external
361      relocation entries for that the module.
362
363      For sections that are merged across modules there must not be any
364      remaining external relocation entries for them (for merged sections
365      remaining relocation entries must be local).  */
366
367   unsigned long extreloff;    /* Offset to external relocation entries.  */
368   unsigned long nextrel;      /* Number of external relocation entries.  */
369
370   /* All the local relocation entries are grouped together (they are not
371      grouped by their module since they are only used if the object is moved
372      from it statically link edited address).  */
373
374   unsigned long locreloff;    /* Offset to local relocation entries.  */
375   unsigned long nlocrel;      /* Number of local relocation entries.  */
376
377   bfd_mach_o_dylib_module *dylib_module;
378   bfd_mach_o_dylib_table_of_content *dylib_toc;
379   unsigned int *indirect_syms;
380   bfd_mach_o_dylib_reference *ext_refs;
381 }
382 bfd_mach_o_dysymtab_command;
383
384 /* An indirect symbol table entry is simply a 32bit index into the symbol table
385    to the symbol that the pointer or stub is refering to.  Unless it is for a
386    non-lazy symbol pointer section for a defined symbol which strip(1) has
387    removed.  In which case it has the value INDIRECT_SYMBOL_LOCAL.  If the
388    symbol was also absolute INDIRECT_SYMBOL_ABS is or'ed with that.  */
389
390 #define BFD_MACH_O_INDIRECT_SYMBOL_LOCAL 0x80000000
391 #define BFD_MACH_O_INDIRECT_SYMBOL_ABS   0x40000000
392 #define BFD_MACH_O_INDIRECT_SYMBOL_SIZE  4
393
394 /* For LC_TWOLEVEL_HINTS.  */
395
396 typedef struct bfd_mach_o_twolevel_hints_command
397 {
398   /* Offset to the hint table.  */
399   unsigned int offset;
400
401   /* Number of entries in the table.  */
402   unsigned int nhints;
403 }
404 bfd_mach_o_twolevel_hints_command;
405
406 /* For LC_PREBIND_CKSUM.  */
407
408 typedef struct bfd_mach_o_prebind_cksum_command
409 {
410   /* Checksum or zero.  */
411   unsigned int cksum;
412 }
413 bfd_mach_o_prebind_cksum_command;
414
415 /* For LC_THREAD or LC_UNIXTHREAD.  */
416
417 typedef struct bfd_mach_o_thread_flavour
418 {
419   unsigned long flavour;
420   unsigned long offset;
421   unsigned long size;
422 }
423 bfd_mach_o_thread_flavour;
424
425 typedef struct bfd_mach_o_thread_command
426 {
427   unsigned long nflavours;
428   bfd_mach_o_thread_flavour *flavours;
429   asection *section;
430 }
431 bfd_mach_o_thread_command;
432
433 /* For LC_LOAD_DYLINKER and LC_ID_DYLINKER.  */
434
435 typedef struct bfd_mach_o_dylinker_command
436 {
437   unsigned int name_offset;         /* Offset to library's path name.  */
438   char *name_str;
439 }
440 bfd_mach_o_dylinker_command;
441
442 /* For LC_LOAD_DYLIB, LC_LOAD_WEAK_DYLIB, LC_ID_DYLIB
443    or LC_REEXPORT_DYLIB.  */
444
445 typedef struct bfd_mach_o_dylib_command
446 {
447   unsigned int name_offset;            /* Offset to library's path name.  */
448   unsigned long timestamp;             /* Library's build time stamp.  */
449   unsigned long current_version;       /* Library's current version number.  */
450   unsigned long compatibility_version; /* Library's compatibility vers number.  */
451   char *name_str;
452 }
453 bfd_mach_o_dylib_command;
454
455 /* For LC_PREBOUND_DYLIB.  */
456
457 typedef struct bfd_mach_o_prebound_dylib_command
458 {
459   unsigned int name_offset;           /* Library's path name.  */
460   unsigned int nmodules;              /* Number of modules in library.  */
461   unsigned int linked_modules_offset; /* Bit vector of linked modules.  */
462
463   char *name_str;
464   unsigned char *linked_modules;
465 }
466 bfd_mach_o_prebound_dylib_command;
467
468 /* For LC_UUID.  */
469
470 typedef struct bfd_mach_o_uuid_command
471 {
472   unsigned char uuid[16];
473 }
474 bfd_mach_o_uuid_command;
475
476 /* For LC_CODE_SIGNATURE or LC_SEGMENT_SPLIT_INFO.  */
477
478 typedef struct bfd_mach_o_linkedit_command
479 {
480   unsigned long dataoff;
481   unsigned long datasize;
482 }
483 bfd_mach_o_linkedit_command;
484
485 typedef struct bfd_mach_o_str_command
486 {
487   unsigned long stroff;
488   unsigned long str_len;
489   char *str;
490 }
491 bfd_mach_o_str_command;
492
493 typedef struct bfd_mach_o_fvmlib_command
494 {
495   unsigned int name_offset;
496   char *name_str;
497   unsigned int minor_version;
498   unsigned int header_addr;
499 }
500 bfd_mach_o_fvmlib_command;
501
502 typedef struct bfd_mach_o_dyld_info_command
503 {
504   /* File offset and size to rebase info.  */
505   unsigned int rebase_off;
506   unsigned int rebase_size;
507   unsigned char *rebase_content;
508
509   /* File offset and size of binding info.  */
510   unsigned int bind_off;
511   unsigned int bind_size;
512   unsigned char *bind_content;
513
514   /* File offset and size of weak binding info.  */
515   unsigned int weak_bind_off;
516   unsigned int weak_bind_size;
517   unsigned char *weak_bind_content;
518
519   /* File offset and size of lazy binding info.  */
520   unsigned int lazy_bind_off;
521   unsigned int lazy_bind_size;
522   unsigned char *lazy_bind_content;
523
524   /* File offset and size of export info.  */
525   unsigned int export_off;
526   unsigned int export_size;
527   unsigned char *export_content;
528 }
529 bfd_mach_o_dyld_info_command;
530
531 typedef struct bfd_mach_o_version_min_command
532 {
533   uint32_t version;
534   uint32_t sdk;
535 }
536 bfd_mach_o_version_min_command;
537
538 typedef struct bfd_mach_o_encryption_info_command
539 {
540   unsigned int cryptoff;
541   unsigned int cryptsize;
542   unsigned int cryptid;
543 }
544 bfd_mach_o_encryption_info_command;
545
546 typedef struct bfd_mach_o_main_command
547 {
548   bfd_uint64_t entryoff;
549   bfd_uint64_t stacksize;
550 }
551 bfd_mach_o_main_command;
552
553 typedef struct bfd_mach_o_source_version_command
554 {
555   unsigned int a;
556   unsigned short b;
557   unsigned short c;
558   unsigned short d;
559   unsigned short e;
560 }
561 bfd_mach_o_source_version_command;
562
563 typedef struct bfd_mach_o_note_command
564 {
565   char data_owner[16];
566   bfd_uint64_t offset;
567   bfd_uint64_t size;
568 }
569 bfd_mach_o_note_command;
570
571 typedef struct bfd_mach_o_build_version_tool
572 {
573   uint32_t tool;
574   uint32_t version;
575 }
576 bfd_mach_o_build_version_tool;
577
578 typedef struct bfd_mach_o_build_version_command
579 {
580   uint32_t platform;
581   uint32_t minos;
582   uint32_t sdk;
583   uint32_t ntools;
584 }
585 bfd_mach_o_build_version_command;
586
587 typedef struct bfd_mach_o_load_command
588 {
589   /* Next command in the single linked list.  */
590   struct bfd_mach_o_load_command *next;
591
592   /* Type and required flag.  */
593   bfd_mach_o_load_command_type type;
594   bfd_boolean type_required;
595
596   /* Offset and length in the file.  */
597   unsigned int offset;
598   unsigned int len;
599
600   union
601   {
602     bfd_mach_o_segment_command segment;
603     bfd_mach_o_symtab_command symtab;
604     bfd_mach_o_dysymtab_command dysymtab;
605     bfd_mach_o_thread_command thread;
606     bfd_mach_o_dylib_command dylib;
607     bfd_mach_o_dylinker_command dylinker;
608     bfd_mach_o_prebound_dylib_command prebound_dylib;
609     bfd_mach_o_prebind_cksum_command prebind_cksum;
610     bfd_mach_o_twolevel_hints_command twolevel_hints;
611     bfd_mach_o_uuid_command uuid;
612     bfd_mach_o_linkedit_command linkedit;
613     bfd_mach_o_str_command str;
614     bfd_mach_o_dyld_info_command dyld_info;
615     bfd_mach_o_version_min_command version_min;
616     bfd_mach_o_encryption_info_command encryption_info;
617     bfd_mach_o_fvmlib_command fvmlib;
618     bfd_mach_o_main_command main;
619     bfd_mach_o_source_version_command source_version;
620     bfd_mach_o_note_command note;
621     bfd_mach_o_build_version_command build_version;
622   } command;
623 }
624 bfd_mach_o_load_command;
625
626 typedef struct mach_o_data_struct
627 {
628   /* Mach-O header.  */
629   bfd_mach_o_header header;
630
631   /* File offset of the header.  Usually this is 0.  */
632   file_ptr hdr_offset;
633
634   /* Array of load commands (length is given by header.ncmds).  */
635   bfd_mach_o_load_command *first_command;
636   bfd_mach_o_load_command *last_command;
637
638   /* Flatten array of sections.  The array is 0-based.  */
639   unsigned long nsects;
640   bfd_mach_o_section **sections;
641
642   /* Used while writing: current length of the output file.  This is used
643      to allocate space in the file.  */
644   ufile_ptr filelen;
645
646   /* As symtab is referenced by other load command, it is handy to have
647      a direct access to it.  Although it is not clearly stated, only one symtab
648      is expected.  */
649   bfd_mach_o_symtab_command *symtab;
650   bfd_mach_o_dysymtab_command *dysymtab;
651
652   /* A place to stash dwarf2 info for this bfd.  */
653   void *dwarf2_find_line_info;
654
655   /* BFD of .dSYM file.  */
656   bfd *dsym_bfd;
657
658   /* Cache of dynamic relocs.  */
659   arelent *dyn_reloc_cache;
660 }
661 bfd_mach_o_data_struct;
662
663 typedef struct bfd_mach_o_xlat_name
664 {
665   const char *name;
666   unsigned long val;
667 }
668 bfd_mach_o_xlat_name;
669
670 /* Target specific routines.  */
671
672 #define bfd_mach_o_get_data(abfd) ((abfd)->tdata.mach_o_data)
673 #define bfd_mach_o_get_backend_data(abfd) \
674   ((bfd_mach_o_backend_data*)(abfd)->xvec->backend_data)
675
676 /* Get the Mach-O header for section SEC.  */
677 #define bfd_mach_o_get_mach_o_section(sec) \
678   ((bfd_mach_o_section *)(sec)->used_by_bfd)
679
680 bfd_boolean bfd_mach_o_valid (bfd *);
681 bfd_boolean bfd_mach_o_mkobject_init (bfd *);
682 const bfd_target *bfd_mach_o_object_p (bfd *);
683 const bfd_target *bfd_mach_o_core_p (bfd *);
684 const bfd_target *bfd_mach_o_fat_archive_p (bfd *);
685 bfd *bfd_mach_o_fat_openr_next_archived_file (bfd *, bfd *);
686 bfd_boolean bfd_mach_o_set_arch_mach (bfd *, enum bfd_architecture,
687                                       unsigned long);
688 int bfd_mach_o_lookup_command (bfd *, bfd_mach_o_load_command_type, bfd_mach_o_load_command **);
689 bfd_boolean bfd_mach_o_new_section_hook (bfd *, asection *);
690 bfd_boolean bfd_mach_o_write_contents (bfd *);
691 bfd_boolean bfd_mach_o_bfd_copy_private_symbol_data (bfd *, asymbol *,
692                                                      bfd *, asymbol *);
693 bfd_boolean bfd_mach_o_bfd_copy_private_section_data (bfd *, asection *,
694                                                       bfd *, asection *);
695 bfd_boolean bfd_mach_o_bfd_copy_private_header_data (bfd *, bfd *);
696 bfd_boolean bfd_mach_o_bfd_set_private_flags (bfd *, flagword);
697 bfd_boolean bfd_mach_o_bfd_print_private_bfd_data (bfd *, void *);
698 long bfd_mach_o_get_symtab_upper_bound (bfd *);
699 long bfd_mach_o_canonicalize_symtab (bfd *, asymbol **);
700 long bfd_mach_o_get_synthetic_symtab (bfd *, long, asymbol **, long,
701                                       asymbol **, asymbol **ret);
702 long bfd_mach_o_get_reloc_upper_bound (bfd *, asection *);
703 long bfd_mach_o_canonicalize_reloc (bfd *, asection *, arelent **, asymbol **);
704 long bfd_mach_o_get_dynamic_reloc_upper_bound (bfd *);
705 long bfd_mach_o_canonicalize_dynamic_reloc (bfd *, arelent **, asymbol **);
706 asymbol *bfd_mach_o_make_empty_symbol (bfd *);
707 void bfd_mach_o_get_symbol_info (bfd *, asymbol *, symbol_info *);
708 void bfd_mach_o_print_symbol (bfd *, void *, asymbol *, bfd_print_symbol_type);
709 int bfd_mach_o_sizeof_headers (bfd *, struct bfd_link_info *);
710 unsigned long bfd_mach_o_stack_addr (enum bfd_mach_o_cpu_type);
711 int bfd_mach_o_core_fetch_environment (bfd *, unsigned char **, unsigned int *);
712 char *bfd_mach_o_core_file_failing_command (bfd *);
713 int bfd_mach_o_core_file_failing_signal (bfd *);
714 bfd_boolean bfd_mach_o_core_file_matches_executable_p (bfd *, bfd *);
715 bfd *bfd_mach_o_fat_extract (bfd *, bfd_format , const bfd_arch_info_type *);
716 const bfd_target *bfd_mach_o_header_p (bfd *, file_ptr, bfd_mach_o_filetype,
717                                        bfd_mach_o_cpu_type);
718 bfd_boolean bfd_mach_o_build_commands (bfd *);
719 bfd_boolean bfd_mach_o_set_section_contents (bfd *, asection *, const void *,
720                                              file_ptr, bfd_size_type);
721 unsigned int bfd_mach_o_version (bfd *);
722
723 unsigned int bfd_mach_o_get_section_type_from_name (bfd *, const char *);
724 unsigned int bfd_mach_o_get_section_attribute_from_name (const char *);
725
726 void bfd_mach_o_convert_section_name_to_bfd (bfd *, const char *, const char *,
727                                              const char **, flagword *);
728 bfd_boolean bfd_mach_o_find_nearest_line (bfd *, asymbol **,
729                                           asection *, bfd_vma,
730                                           const char **, const char **,
731                                           unsigned int *, unsigned int *);
732 #define bfd_mach_o_find_line _bfd_nosymbols_find_line
733 bfd_boolean bfd_mach_o_close_and_cleanup (bfd *);
734 bfd_boolean bfd_mach_o_free_cached_info (bfd *);
735
736 unsigned int bfd_mach_o_section_get_nbr_indirect (bfd *, bfd_mach_o_section *);
737 unsigned int bfd_mach_o_section_get_entry_size (bfd *, bfd_mach_o_section *);
738 bfd_boolean bfd_mach_o_read_symtab_symbols (bfd *);
739 bfd_boolean bfd_mach_o_read_symtab_strtab (bfd *abfd);
740
741 bfd_vma bfd_mach_o_get_base_address (bfd *);
742
743 void bfd_mach_o_swap_in_non_scattered_reloc (bfd *, bfd_mach_o_reloc_info *,
744                                              unsigned char *);
745 bfd_boolean bfd_mach_o_canonicalize_non_scattered_reloc (bfd *, bfd_mach_o_reloc_info *, arelent *, asymbol **);
746 bfd_boolean bfd_mach_o_pre_canonicalize_one_reloc (bfd *, struct mach_o_reloc_info_external *, bfd_mach_o_reloc_info *, arelent *, asymbol **);
747
748 /* A placeholder in case we need to suppress emitting the dysymtab for some
749    reason (e.g. compatibility with older system versions).  */
750 #define bfd_mach_o_should_emit_dysymtab(x) TRUE
751
752 extern const bfd_mach_o_xlat_name bfd_mach_o_section_attribute_name[];
753 extern const bfd_mach_o_xlat_name bfd_mach_o_section_type_name[];
754
755 extern const bfd_target mach_o_fat_vec;
756
757 /* Interfaces between BFD names and Mach-O names.  */
758
759 typedef struct mach_o_section_name_xlat
760 {
761   const char *bfd_name;
762   const char *mach_o_name;
763   flagword bfd_flags;
764   unsigned int macho_sectype;
765   unsigned int macho_secattr;
766   unsigned int sectalign;
767 } mach_o_section_name_xlat;
768
769 typedef struct mach_o_segment_name_xlat
770 {
771   const char *segname;
772   const mach_o_section_name_xlat *sections;
773 } mach_o_segment_name_xlat;
774
775 const mach_o_section_name_xlat *
776 bfd_mach_o_section_data_for_mach_sect (bfd *, const char *, const char *);
777 const mach_o_section_name_xlat *
778 bfd_mach_o_section_data_for_bfd_name (bfd *, const char *, const char **);
779
780 typedef struct bfd_mach_o_backend_data
781 {
782   enum bfd_architecture arch;
783   bfd_vma page_size;
784   bfd_boolean (*_bfd_mach_o_canonicalize_one_reloc)
785   (bfd *, struct mach_o_reloc_info_external *, arelent *, asymbol **, arelent *);
786   bfd_boolean (*_bfd_mach_o_swap_reloc_out)(arelent *, bfd_mach_o_reloc_info *);
787   bfd_boolean (*_bfd_mach_o_print_thread)(bfd *, bfd_mach_o_thread_flavour *,
788                                           void *, char *);
789   const mach_o_segment_name_xlat *segsec_names_xlat;
790   bfd_boolean (*bfd_mach_o_section_type_valid_for_target) (unsigned long);
791 }
792 bfd_mach_o_backend_data;
793
794 /* Values used in symbol.udata.i, to signal that the mach-o-specific data in the
795    symbol are not yet set, or need validation (where this is possible).  */
796
797 #define SYM_MACHO_FIELDS_UNSET ((bfd_vma) -1)
798 #define SYM_MACHO_FIELDS_NOT_VALIDATED ((bfd_vma) -2)
799
800 #ifdef __cplusplus
801 }
802 #endif
803
804 #endif /* _BFD_MACH_O_H_ */