[gdbserver/lynx178]: Fix null_ptid -vs- minus_one_ptid confusion in comment
[external/binutils.git] / bfd / nlm-target.h
1 /* Target definitions for 32/64-bit NLM (NetWare Loadable Module)
2    Copyright 1993, 1994, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3    2005, 2007, 2009, 2011 Free Software Foundation, Inc.
4
5    This file is part of BFD, the Binary File Descriptor library.
6
7    This program is free software; you can redistribute it and/or modify
8    it under the terms of the GNU General Public License as published by
9    the Free Software Foundation; either version 3 of the License, or
10    (at your option) any later version.
11
12    This program is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15    GNU General Public License for more details.
16
17    You should have received a copy of the GNU General Public License
18    along with this program; if not, write to the Free Software
19    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
20    MA 02110-1301, USA.  */
21
22 #define nlm_core_file_p _bfd_dummy_target
23
24 #define nlm_get_symtab_upper_bound              nlmNAME (get_symtab_upper_bound)
25 #define nlm_canonicalize_symtab                 nlmNAME (canonicalize_symtab)
26 #define nlm_make_empty_symbol                   nlmNAME (make_empty_symbol)
27 #define nlm_print_symbol                        nlmNAME (print_symbol)
28 #define nlm_get_symbol_info                     nlmNAME (get_symbol_info)
29 #define nlm_bfd_is_local_label_name             bfd_generic_is_local_label_name
30 #define nlm_bfd_is_target_special_symbol ((bfd_boolean (*) (bfd *, asymbol *)) bfd_false)
31 #define nlm_get_lineno                          _bfd_nosymbols_get_lineno
32 #define nlm_find_nearest_line                   _bfd_nosymbols_find_nearest_line
33 #define nlm_find_inliner_info                   _bfd_nosymbols_find_inliner_info
34 #define nlm_bfd_make_debug_symbol               _bfd_nosymbols_bfd_make_debug_symbol
35 #define nlm_read_minisymbols                    _bfd_generic_read_minisymbols
36 #define nlm_minisymbol_to_symbol                _bfd_generic_minisymbol_to_symbol
37
38 #define nlm_get_reloc_upper_bound               nlmNAME (get_reloc_upper_bound)
39 #define nlm_canonicalize_reloc                  nlmNAME (canonicalize_reloc)
40 #define nlm_bfd_reloc_type_lookup               bfd_default_reloc_type_lookup
41 #define nlm_bfd_reloc_name_lookup         _bfd_norelocs_bfd_reloc_name_lookup
42 #define nlm_set_section_contents                nlmNAME (set_section_contents)
43
44 #define nlm_sizeof_headers                      _bfd_nolink_sizeof_headers
45 #define nlm_bfd_get_relocated_section_contents  bfd_generic_get_relocated_section_contents
46 #define nlm_bfd_relax_section                   bfd_generic_relax_section
47 #define nlm_bfd_gc_sections                     bfd_generic_gc_sections
48 #define nlm_bfd_lookup_section_flags            bfd_generic_lookup_section_flags
49 #define nlm_bfd_merge_sections                  bfd_generic_merge_sections
50 #define nlm_bfd_is_group_section                bfd_generic_is_group_section
51 #define nlm_bfd_discard_group                   bfd_generic_discard_group
52 #define nlm_section_already_linked              _bfd_generic_section_already_linked
53 #define nlm_bfd_define_common_symbol            bfd_generic_define_common_symbol
54 #define nlm_bfd_link_hash_table_create          _bfd_generic_link_hash_table_create
55 #define nlm_bfd_link_hash_table_free            _bfd_generic_link_hash_table_free
56 #define nlm_bfd_link_add_symbols                _bfd_generic_link_add_symbols
57 #define nlm_bfd_link_just_syms                  _bfd_generic_link_just_syms
58 #define nlm_bfd_copy_link_hash_symbol_type \
59   _bfd_generic_copy_link_hash_symbol_type
60 #define nlm_bfd_final_link                      _bfd_generic_final_link
61 #define nlm_bfd_link_split_section              _bfd_generic_link_split_section
62
63 /* This structure contains everything that BFD knows about a target.
64    It includes things like its byte order, name, what routines to call
65    to do various operations, etc.  Every BFD points to a target structure
66    with its "xvec" member.
67
68    There are two such structures here:  one for big-endian machines and
69    one for little-endian machines.   */
70
71 /* Forward declaration for use when initialising alternative_target field.  */
72 #ifdef TARGET_LITTLE_SYM
73 extern const bfd_target TARGET_LITTLE_SYM;
74 #endif
75
76 #ifdef TARGET_BIG_SYM
77 const bfd_target TARGET_BIG_SYM =
78 {
79   /* Name: identify kind of target.  */
80   TARGET_BIG_NAME,
81
82   /* Flavour: general indication about file.  */
83   bfd_target_nlm_flavour,
84
85   /* Byteorder: data is big endian.  */
86   BFD_ENDIAN_BIG,
87
88   /* Header_byteorder: header is also big endian.  */
89   BFD_ENDIAN_BIG,
90
91   /* Object_flags: mask of all file flags.  */
92   (HAS_RELOC | EXEC_P | HAS_LINENO | HAS_DEBUG | HAS_SYMS | HAS_LOCALS
93    | WP_TEXT),
94
95   /* Section_flags: mask of all section flags.  */
96   (SEC_HAS_CONTENTS | SEC_ALLOC | SEC_LOAD | SEC_RELOC | SEC_READONLY
97    | SEC_CODE | SEC_DATA),
98
99    /* Leading_symbol_char: is the first char of a user symbol
100       predictable, and if so what is it.  */
101    0,
102
103   /* AR_pad_char: pad character for filenames within an archive header
104      FIXME:  this really has nothing to do with NLM, this is a characteristic
105      of the archiver and/or os and should be independently tunable.  */
106   '/',
107
108   /* AR_max_namelen: maximum number of characters in an archive header
109      FIXME:  this really has nothing to do with NLM, this is a characteristic
110      of the archiver and should be independently tunable.  This value is
111      a WAG (wild a** guess).  */
112   15,
113   0,                            /* match priority.  */
114
115   /* Routines to byte-swap various sized integers from the data sections.  */
116   bfd_getb64, bfd_getb_signed_64, bfd_putb64,
117   bfd_getb32, bfd_getb_signed_32, bfd_putb32,
118   bfd_getb16, bfd_getb_signed_16, bfd_putb16,
119
120   /* Routines to byte-swap various sized integers from the file headers.  */
121   bfd_getb64, bfd_getb_signed_64, bfd_putb64,
122   bfd_getb32, bfd_getb_signed_32, bfd_putb32,
123   bfd_getb16, bfd_getb_signed_16, bfd_putb16,
124
125   /* bfd_check_format: check the format of a file being read.  */
126   { _bfd_dummy_target,          /* Unknown format.  */
127     nlmNAME (object_p),         /* Assembler/linker output (object file).  */
128     bfd_generic_archive_p,      /* An archive.  */
129     nlm_core_file_p             /* A core file.  */
130   },
131
132   /* bfd_set_format: set the format of a file being written.  */
133   { bfd_false,
134     nlm_mkobject,
135     _bfd_generic_mkarchive,
136     bfd_false
137   },
138
139   /* bfd_write_contents: write cached information into a file being written.  */
140   { bfd_false,
141     nlmNAME (write_object_contents),
142     _bfd_write_archive_contents,
143     bfd_false
144   },
145
146   /* Initialize a jump table with the standard macro.
147      All names start with "nlm".  */
148   BFD_JUMP_TABLE_GENERIC (_bfd_generic),
149   BFD_JUMP_TABLE_COPY (_bfd_generic),
150   BFD_JUMP_TABLE_CORE (_bfd_nocore),
151   BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive),
152   BFD_JUMP_TABLE_SYMBOLS (nlm),
153   BFD_JUMP_TABLE_RELOCS (nlm),
154   BFD_JUMP_TABLE_WRITE (nlm),
155   BFD_JUMP_TABLE_LINK (nlm),
156   BFD_JUMP_TABLE_DYNAMIC (_bfd_nodynamic),
157
158   /* Alternative endian target.  */
159 #ifdef TARGET_LITTLE_SYM
160   & TARGET_LITTLE_SYM,
161 #else
162   NULL,
163 #endif
164
165   /* Backend_data.  */
166   (void *) TARGET_BACKEND_DATA
167 };
168 #endif
169
170 #ifdef TARGET_LITTLE_SYM
171 const bfd_target TARGET_LITTLE_SYM =
172 {
173   /* Name: identify kind of target.  */
174   TARGET_LITTLE_NAME,
175
176   /* Flavour: general indication about file.  */
177   bfd_target_nlm_flavour,
178
179   /* Byteorder: data is little endian.  */
180   BFD_ENDIAN_LITTLE,
181
182   /* Header_byteorder: header is also little endian.  */
183   BFD_ENDIAN_LITTLE,
184
185   /* Object_flags: mask of all file flags.  */
186   (HAS_RELOC | EXEC_P | HAS_LINENO | HAS_DEBUG | HAS_SYMS | HAS_LOCALS
187    | WP_TEXT),
188
189   /* Section_flags: mask of all section flags.  */
190   (SEC_HAS_CONTENTS | SEC_ALLOC | SEC_LOAD | SEC_RELOC | SEC_READONLY
191    | SEC_DATA),
192
193    /* Leading_symbol_char: is the first char of a user symbol
194       predictable, and if so what is it.  */
195    0,
196
197   /* AR_pad_char: pad character for filenames within an archive header
198      FIXME:  this really has nothing to do with NLM, this is a characteristic
199      of the archiver and/or os and should be independently tunable.  */
200   '/',
201
202   /* AR_max_namelen: maximum number of characters in an archive header
203      FIXME:  this really has nothing to do with NLM, this is a characteristic
204      of the archiver and should be independently tunable.  This value is
205      a WAG (wild a** guess).  */
206   15,
207   0,                            /* match priority.  */
208
209   /* Routines to byte-swap various sized integers from the data sections.  */
210   bfd_getl64, bfd_getl_signed_64, bfd_putl64,
211   bfd_getl32, bfd_getl_signed_32, bfd_putl32,
212   bfd_getl16, bfd_getl_signed_16, bfd_putl16,
213
214   /* Routines to byte-swap various sized integers from the file headers.  */
215   bfd_getl64, bfd_getl_signed_64, bfd_putl64,
216   bfd_getl32, bfd_getl_signed_32, bfd_putl32,
217   bfd_getl16, bfd_getl_signed_16, bfd_putl16,
218
219   /* bfd_check_format: check the format of a file being read.  */
220   { _bfd_dummy_target,          /* Unknown format.  */
221     nlmNAME(object_p),          /* Assembler/linker output (object file).  */
222     bfd_generic_archive_p,      /* An archive.  */
223     nlm_core_file_p             /* A core file.  */
224   },
225
226   /* bfd_set_format: set the format of a file being written.  */
227   { bfd_false,
228     nlm_mkobject,
229     _bfd_generic_mkarchive,
230     bfd_false
231   },
232
233   /* bfd_write_contents: write cached information into a file being written.  */
234   { bfd_false,
235     nlmNAME(write_object_contents),
236     _bfd_write_archive_contents,
237     bfd_false
238   },
239
240   /* Initialize a jump table with the standard macro.
241      All names start with "nlm".  */
242   BFD_JUMP_TABLE_GENERIC (_bfd_generic),
243   BFD_JUMP_TABLE_COPY (_bfd_generic),
244   BFD_JUMP_TABLE_CORE (_bfd_nocore),
245   BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive),
246   BFD_JUMP_TABLE_SYMBOLS (nlm),
247   BFD_JUMP_TABLE_RELOCS (nlm),
248   BFD_JUMP_TABLE_WRITE (nlm),
249   BFD_JUMP_TABLE_LINK (nlm),
250   BFD_JUMP_TABLE_DYNAMIC (_bfd_nodynamic),
251
252   /* Alternative endian target.  */
253 #ifdef TARGET_BIG_SYM
254   & TARGET_BIG_SYM,
255 #else
256   NULL,
257 #endif
258
259   /* Backend_data.  */
260   (void *) TARGET_BACKEND_DATA
261 };
262 #endif