Update year range in copyright notice of binutils files
[external/binutils.git] / bfd / xsym.h
1 /* xSYM symbol-file 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 #include "sysdep.h"
22 #include "bfd.h"
23 #include <stdio.h>
24
25 #ifndef __xSYM_H__
26 #define __xSYM_H__
27
28 #define BFD_SYM_VERSION_STR_3_1         "\013Version 3.1"
29 #define BFD_SYM_VERSION_STR_3_2         "\013Version 3.2"
30 #define BFD_SYM_VERSION_STR_3_3         "\013Version 3.3"
31 #define BFD_SYM_VERSION_STR_3_4         "\013Version 3.4"
32 #define BFD_SYM_VERSION_STR_3_5         "\013Version 3.5"
33 #define BFD_SYM_END_OF_LIST_3_2         0xffff
34 #define BFD_SYM_END_OF_LIST_3_4         0xffffffff
35 #define BFD_SYM_END_OF_LIST             BFD_SYM_END_OF_LIST_3_4
36 #define BFD_SYM_FILE_NAME_INDEX_3_2     0xfffe
37 #define BFD_SYM_FILE_NAME_INDEX_3_4     0xfffffffe
38 #define BFD_SYM_FILE_NAME_INDEX         BFD_SYM_FILE_NAME_INDEX_3_4
39 #define BFD_SYM_SOURCE_FILE_CHANGE_3_2  0xfffe
40 #define BFD_SYM_SOURCE_FILE_CHANGE_3_4  0xfffffffe
41 #define BFD_SYM_SOURCE_FILE_CHANGE      BFD_SYM_SOURCE_FILE_CHANGE_3_4
42 #define BFD_SYM_MAXIMUM_LEGAL_INDEX_3_2 0xfffd
43 #define BFD_SYM_MAXIMUM_LEGAL_INDEX_3_4 0xfffffffd
44 #define BFD_SYM_MAXIMUM_LEGAL_INDEX     BFD_SYM_MAXIMUM_LEGAL_INDEX_3_4
45
46 enum bfd_sym_storage_class
47 {
48   BFD_SYM_STORAGE_CLASS_REGISTER = 0,
49   BFD_SYM_STORAGE_CLASS_GLOBAL = 1,
50   BFD_SYM_STORAGE_CLASS_FRAME_RELATIVE = 2,
51   BFD_SYM_STORAGE_CLASS_STACK_RELATIVE = 3,
52   BFD_SYM_STORAGE_CLASS_ABSOLUTE = 4,
53   BFD_SYM_STORAGE_CLASS_CONSTANT = 5,
54   BFD_SYM_STORAGE_CLASS_BIGCONSTANT = 6,
55   BFD_SYM_STORAGE_CLASS_RESOURCE = 99
56 };
57 typedef enum bfd_sym_storage_class bfd_sym_storage_class;
58
59 enum bfd_sym_storage_kind
60 {
61   BFD_SYM_STORAGE_KIND_LOCAL = 0,
62   BFD_SYM_STORAGE_KIND_VALUE = 1,
63   BFD_SYM_STORAGE_KIND_REFERENCE = 2,
64   BFD_SYM_STORAGE_KIND_WITH = 3
65 };
66 typedef enum bfd_sym_storage_kind bfd_sym_storage_kind;
67
68 enum bfd_sym_version
69 {
70   BFD_SYM_VERSION_3_1,
71   BFD_SYM_VERSION_3_2,
72   BFD_SYM_VERSION_3_3,
73   BFD_SYM_VERSION_3_4,
74   BFD_SYM_VERSION_3_5
75 };
76 typedef enum bfd_sym_version bfd_sym_version;
77
78 enum bfd_sym_module_kind
79 {
80   BFD_SYM_MODULE_KIND_NONE = 0,
81   BFD_SYM_MODULE_KIND_PROGRAM = 1,
82   BFD_SYM_MODULE_KIND_UNIT = 2,
83   BFD_SYM_MODULE_KIND_PROCEDURE = 3,
84   BFD_SYM_MODULE_KIND_FUNCTION = 4,
85   BFD_SYM_MODULE_KIND_DATA = 5,
86   BFD_SYM_MODULE_KIND_BLOCK = 6
87 };
88 typedef enum bfd_sym_module_kind bfd_sym_module_kind;
89
90 enum bfd_sym_symbol_scope
91 {
92   BFD_SYM_SYMBOL_SCOPE_LOCAL = 0,  /* Object is seen only inside current scope.  */
93   BFD_SYM_SYMBOL_SCOPE_GLOBAL = 1  /* Object has global scope.  */
94 };
95 typedef enum bfd_sym_symbol_scope bfd_sym_symbol_scope;
96
97 struct bfd_sym_file_reference
98 {
99   unsigned long fref_frte_index; /* File reference table index.  */
100   unsigned long fref_offset;     /* Absolute offset into source file.  */
101 };
102 typedef struct bfd_sym_file_reference bfd_sym_file_reference;
103
104 /* NAME TABLE (NTE).  */
105
106 /* RESOURCES TABLE (RTE)
107
108    All code and data is *defined* to reside in a resource.  Even A5
109    relative data is defined to reside in a dummy resource of ResType
110    'gbld'.  Code always resides in a resource.  Because a code/data
111    is built of many modules, when walking through a resource we must
112    point back to the modules in the order they were defined.  This is
113    done by requiring the entries in the Modules Entry table to be
114    ordered by resource/resource-number and by the location in that
115    resource.  Hence, the resource table entry points to the first
116    module making up that resource.  All modules table entries following
117    that first one with the same restype/resnum are contiguous and offset
118    from that first entry.  */
119
120 struct bfd_sym_resources_table_entry
121 {
122   unsigned char rte_res_type[4];  /* Resource Type.  */
123   unsigned short rte_res_number;  /* Resource Number.  */
124   unsigned long rte_nte_index;    /* Name of the resource.  */
125   unsigned long rte_mte_first;    /* Index of first module in the resource.  */
126   unsigned long rte_mte_last;     /* Index of the last module in the resource.  */
127   unsigned long rte_res_size;     /* Size of the resource.  */
128 };
129 typedef struct bfd_sym_resources_table_entry bfd_sym_resources_table_entry;
130
131 /* MODULES TABLE (MTE)
132
133    Modules table entries are ordered by their appearance in a resource.
134    (Note that having a single module copied into two resources is not
135    possible).  Modules map back to their resource via an index into the
136    resource table and an offset into the resource.  Modules also point
137    to their source files, both the definition module and implementation
138    module.  Because modules can be textually nested within other
139    modules, a link to the parent (containing) module is required.  This
140    module can textually contain other modules.  A link to the contiguous
141    list of child (contained) modules is required.  Variables, statements,
142    and types defined in the module are pointed to by indexing the head of
143    the contiguous lists of contained variables, contained statements,
144    and contained types.  */
145
146 struct bfd_sym_modules_table_entry
147 {
148   unsigned long mte_rte_index;          /* Which resource it is in.  */
149   unsigned long mte_res_offset;         /* Offset into the resource.  */
150   unsigned long mte_size;               /* Size of module.  */
151   char mte_kind;                        /* What kind of module this is.  */
152   char mte_scope;                       /* How visible is it?  */
153   unsigned long mte_parent;             /* Containing module.  */
154   bfd_sym_file_reference mte_imp_fref;  /* Implementation source.  */
155   unsigned long mte_imp_end;            /* End of implementation source.  */
156   unsigned long mte_nte_index;          /* The name of the module.  */
157   unsigned long mte_cmte_index;         /* Modules contained in this.  */
158   unsigned long mte_cvte_index;         /* Variables contained in this.  */
159   unsigned long mte_clte_index;         /* Local labels defined here.  */
160   unsigned long mte_ctte_index;         /* Types contained in this.  */
161   unsigned long mte_csnte_idx_1;        /* CSNTE index of mte_snbr_first.  */
162   unsigned long mte_csnte_idx_2;        /* CSNTE index of mte_snbr_last.  */
163 };
164 typedef struct bfd_sym_modules_table_entry bfd_sym_modules_table_entry;
165
166 /* FILE REFERENCES TABLE (FRTE)
167
168    The FILE REFERENCES TABLE maps from source file to module & offset.
169    The table is ordered by increasing file offset.  Each new offset
170    references a module.
171
172                         FRT     = FILE_SOURCE_START
173                                                 FILE_SOURCE_INCREMENT*
174                                                 END_OF_LIST.
175
176         *** THIS MECHANISM IS VERY SLOW FOR FILE+STATEMENT_NUMBER TO
177         *** MODULE/CODE ADDRESS OPERATIONS.  ANOTHER MECHANISM IS
178         ***     REQUIRED!!  */
179
180 union bfd_sym_file_references_table_entry
181 {
182   struct
183   {
184     /* END_OF_LIST, FILE_NAME_INDEX, or module table entry.  */
185     unsigned long type;
186   }
187   generic;
188
189   struct
190   {
191     /* FILE_NAME_INDEX.  */
192     unsigned long type;
193     unsigned long nte_index;
194     unsigned long mod_date;
195   }
196   filename;
197
198   struct
199   {
200     /* < FILE_NAME_INDEX.  */
201     unsigned long mte_index;
202     unsigned long file_offset;
203   }
204   entry;
205 };
206 typedef union bfd_sym_file_references_table_entry bfd_sym_file_references_table_entry;
207
208 /* CONTAINED MODULES TABLE (CMTE)
209
210    Contained Modules are lists of indices into the modules table.  The
211    lists are terminated by an END_OF_LIST index.  All entries are of the
212    same size, hence mapping an index into a CMTE list is simple.
213
214    CMT = MTE_INDEX* END_OF_LIST.  */
215
216 union bfd_sym_contained_modules_table_entry
217 {
218   struct
219   {
220     /* END_OF_LIST, index.  */
221     unsigned long type;
222   }
223   generic;
224
225   struct
226   {
227     unsigned long mte_index; /* Index into the Modules Table.  */
228     unsigned long nte_index; /* The name of the module.  */
229   }
230   entry;
231 };
232 typedef union bfd_sym_contained_modules_table_entry bfd_sym_contained_modules_table_entry;
233
234 /* CONTAINED VARIABLES TABLE (CVTE)
235
236    Contained Variables map into the module table, file table, name table, and type
237    table.  Contained Variables are a contiguous list of source file change record,
238    giving the name of and offset into the source file corresponding to all variables
239    following.  Variable definition records contain an index into the name table (giving
240    the text of the variable as it appears in the source code), an index into the type
241    table giving the type of the variable, an increment added to the source file
242    offset giving the start of the implementation of the variable, and a storage
243    class address, giving information on variable's runtime address.
244
245    CVT = SOURCE_FILE_CHANGE SYMBOL_INFO* END_OF_LIST.
246    SYMBOL_INFO = SYMBOL_DEFINITION | SOURCE_FILE_CHANGE .
247
248    All entries are of the same size, making the fetching of data simple.  The
249    variable entries in the list are in ALPHABETICAL ORDER to simplify the display of
250    available variables for several of the debugger's windows.  */
251
252 /* 'la_size' determines the variant used below:
253
254      == BFD_SYM_CVTE_SCA
255      Traditional STORAGE_CLASS_ADDRESS;
256
257      <= BFD_SYM_CVTE_LA_MAX_SIZE
258      That many logical address bytes ("in-situ");
259
260      == BFD_SYM_CVTE_BIG_LA
261      Logical address bytes in constant pool, at offset 'big_la'.  */
262
263 #define BFD_SYM_CVTE_SCA 0          /* Indicate SCA variant of CVTE.  */
264 #define BFD_SYM_CVTE_LA_MAX_SIZE 13 /* Max# of logical address bytes in a CVTE.  */
265 #define BFD_SYM_CVTE_BIG_LA 127     /* Indicates LA redirection to constant pool.  */
266
267 union bfd_sym_contained_variables_table_entry
268 {
269   struct
270   {
271     /* END_OF_LIST, SOURCE_FILE_CHANGE, or type table entry.  */
272     unsigned long type;
273   }
274   generic;
275
276   struct
277   {
278     /* SOURCE_FILE_CHANGE.  */
279     unsigned long type;
280     bfd_sym_file_reference fref;
281   }
282   file;
283
284   struct
285   {
286     /* < SOURCE_FILE_CHANGE.  */
287     unsigned long tte_index;
288     unsigned long nte_index;
289     unsigned long file_delta;                       /* Increment from previous source.  */
290     unsigned char scope;
291     unsigned char la_size;                          /* #bytes of LAs below.  */
292
293     union
294     {
295       /* la_size == BFD_SYM_CVTE_SCA.  */
296       struct
297       {
298         unsigned char sca_kind;                     /* Distinguish local from value/var formal.  */
299         unsigned char sca_class;                    /* The storage class itself.  */
300         unsigned long sca_offset;
301       }
302       scstruct;
303
304       /* la_size <= BFD_SYM_CVTE_LA_MAX_SIZE.  */
305       struct {
306         unsigned char la[BFD_SYM_CVTE_LA_MAX_SIZE]; /* Logical address bytes.  */
307         unsigned char la_kind;                      /* Eqv. cvte_location.sca_kind.  */
308       }
309       lastruct;
310
311       /* la_size == BFD_SYM_CVTE_BIG_LA 127.  */
312       struct
313       {
314         unsigned long big_la;                       /* Logical address bytes in constant pool.  */
315         unsigned char big_la_kind;                  /* Eqv. cvte_location.sca_kind.  */
316       }
317       biglastruct;
318     }
319     address;
320   }
321   entry;
322 };
323 typedef union bfd_sym_contained_variables_table_entry bfd_sym_contained_variables_table_entry;
324
325 /* CONTAINED STATEMENTS TABLE (CSNTE)
326
327    Contained Statements table.  This table is similar to the Contained
328    Variables table except that instead of VARIABLE_DEFINITION entries, this
329    module contains STATEMENT_NUMBER_DEFINITION entries.  A statement number
330    definition points back to the containing module (via an index into
331    the module entry table) and contains the file and resource deltas
332    to add to the previous values to get to this statement.
333    All entries are of the same size, making the fetching of data simple.  The
334    entries in the table are in order of increasing statement number within the
335    source file.
336
337    The Contained Statements table is indexed from two places.  An MTE contains
338    an index to the first statement number within the module.  An FRTE contains
339    an index to the first statement in the table (Possibly.  This is slow.)  Or
340    a table of fast statement number to CSNTE entry mappings indexes into the
341    table.  Choice not yet made.  */
342
343 union bfd_sym_contained_statements_table_entry
344 {
345   struct
346   {
347     /* END_OF_LIST, SOURCE_FILE_CHANGE, or statement table entry.  */
348     unsigned long type;
349   }
350   generic;
351
352   struct
353   {
354     /* SOURCE_FILE_CHANGE.  */
355     unsigned long type;
356     bfd_sym_file_reference fref; /* File name table.  */
357   }
358   file;
359
360   struct
361   {
362     unsigned long mte_index;     /* Which module contains it.  */
363     unsigned long file_delta;    /* Where it is defined.  */
364     unsigned long mte_offset;    /* Where it is in the module.  */
365   }
366   entry;
367 };
368 typedef union bfd_sym_contained_statements_table_entry bfd_sym_contained_statements_table_entry;
369
370 /* CONTAINED LABELS TABLE (CLTE)
371
372    Contained Labels table names those labels local to the module.  It is similar
373    to the Contained Statements table.  */
374
375 union bfd_sym_contained_labels_table_entry
376 {
377   struct
378   {
379     /* END_OF_LIST, SOURCE_FILE_CHANGE, index.  */
380     unsigned long type;
381   }
382   generic;
383
384   struct
385   {
386     /* SOURCE_FILE_CHANGE.  */
387     unsigned long type;
388     bfd_sym_file_reference fref;
389   }
390   file;
391
392   struct
393   {
394     /* < SOURCE_FILE_CHANGE.  */
395     unsigned long mte_index;   /* Which module contains us.  */
396     unsigned long mte_offset;  /* Where it is in the module.  */
397     unsigned long nte_index;   /* The name of the label.  */
398     unsigned long file_delta;  /* Where it is defined.  */
399     unsigned short scope;      /* How visible the label is.  */
400   }
401   entry;
402 };
403 typedef union bfd_sym_contained_labels_table_entry bfd_sym_contained_labels_table_entry;
404
405 /* CONTAINED TYPES TABLE (CTTE)
406
407    Contained Types define the named types that are in the module.  It is used to
408    map name indices into type indices.  The type entries in the table are in
409    alphabetical order by type name.  */
410
411 union bfd_sym_contained_types_table_entry
412 {
413   struct
414   {
415     /* END_OF_LIST, SOURCE_FILE_CHANGE, or type table entry.  */
416     unsigned long type;
417   }
418   generic;
419
420   struct
421   {
422     /* SOURCE_FILE_CHANGE.  */
423     unsigned long type;
424     bfd_sym_file_reference fref;
425   }
426   file;
427
428   struct
429   {
430     /* < SOURCE_FILE_CHANGE.  */
431     unsigned long tte_index;
432     unsigned long nte_index;
433     unsigned long file_delta; /* From last file definition.  */
434   }
435   entry;
436 };
437 typedef union bfd_sym_contained_types_table_entry bfd_sym_contained_types_table_entry;
438
439 /* TYPE TABLE (TTE).  */
440
441 typedef unsigned long bfd_sym_type_table_entry;
442
443 /* TYPE INFORMATION TABLE (TINFO).  */
444
445 struct bfd_sym_type_information_table_entry
446 {
447   unsigned long nte_index;
448   unsigned long physical_size;
449   unsigned long logical_size;
450   unsigned long offset;
451 };
452 typedef struct bfd_sym_type_information_table_entry bfd_sym_type_information_table_entry;
453
454 /* FILE REFERENCES INDEX TABLE (FITE)
455
456    The FRTE INDEX TABLE indexes into the FILE REFERENCE TABLE above.  The FRTE
457    at that index is the FILE_SOURCE_START for a series of files.  The FRTEs are
458    indexed from 1.  The list is terminated with an END_OF_LIST.  */
459
460 union bfd_sym_file_references_index_table_entry
461 {
462   struct
463   {
464     unsigned long type;
465   }
466   generic;
467
468   struct
469   {
470     unsigned long frte_index;  /* Index into the FRTE table.  */
471     unsigned long nte_index;   /* Name table index, gives filename.  */
472   }
473   entry;
474 };
475 typedef union bfd_sym_file_references_index_table_entry bfd_sym_file_references_index_table_entry;
476
477 /* CONSTANT POOL (CONST)
478
479    The CONSTANT_POOL consists of entries that start on word boundaries.  The entries
480    are referenced by byte index into the constant pool, not by record number.
481
482    Each entry takes the form:
483
484    <16-bit size>
485    <that many bytes of stuff>
486
487    Entries do not cross page boundaries.  */
488
489 typedef short bfd_sym_constant_pool_entry;
490
491 /* The DISK_SYMBOL_HEADER_BLOCK is the first record in a .SYM file,
492    defining the physical characteristics of the symbolic information.
493    The remainder of the * .SYM file is stored in fixed block
494    allocations. For the purposes of paging, the * file is considered
495    to be an array of dshb_page_size blocks, with block 0 (and *
496    possibly more) devoted to the DISK_SYMBOL_HEADER_BLOCK.
497
498    The dti_object_count field means that the allowed indices for that
499    type of object are 0 .. dti_object_count. An index of 0, although
500    allowed, is never done.  However, an 0th entry is created in the
501    table.  That entry is filled with all zeroes.  The reason for this
502    is to avoid off-by-one programming errors that would otherwise
503    occur: an index of k *MEANS* k, not k-1 when going to the disk
504    table.  */
505
506 struct bfd_sym_table_info
507 {
508   unsigned long dti_first_page;   /* First page for this table.  */
509   unsigned long dti_page_count;   /* Number of pages for the table.  */
510   unsigned long dti_object_count; /* Number of objects in the table.  */
511 };
512 typedef struct bfd_sym_table_info bfd_sym_table_info;
513
514 struct bfd_sym_header_block
515 {
516   unsigned char dshb_id[32];      /* Version information.  */
517   unsigned short dshb_page_size;  /* Size of the pages/blocks.  */
518   unsigned long dshb_hash_page;   /* Disk page for the hash table.  */
519   unsigned long dshb_root_mte;    /* MTE index of the program root.  */
520   unsigned long dshb_mod_date;    /* modification date of executable.  */
521   bfd_sym_table_info dshb_frte;   /* Per TABLE information.  */
522   bfd_sym_table_info dshb_rte;
523   bfd_sym_table_info dshb_mte;
524   bfd_sym_table_info dshb_cmte;
525   bfd_sym_table_info dshb_cvte;
526   bfd_sym_table_info dshb_csnte;
527   bfd_sym_table_info dshb_clte;
528   bfd_sym_table_info dshb_ctte;
529   bfd_sym_table_info dshb_tte;
530   bfd_sym_table_info dshb_nte;
531   bfd_sym_table_info dshb_tinfo;
532   bfd_sym_table_info dshb_fite;   /* File information.  */
533   bfd_sym_table_info dshb_const;  /* Constant pool.  */
534
535   unsigned char dshb_file_creator[4]; /* Executable's creator.  */
536   unsigned char dshb_file_type[4];    /* Executable's file type.  */
537 };
538 typedef struct bfd_sym_header_block bfd_sym_header_block;
539
540 struct bfd_sym_data_struct
541 {
542   unsigned char *name_table;
543   bfd_sym_header_block header;
544   bfd_sym_version version;
545   bfd *sbfd;
546 };
547 typedef struct bfd_sym_data_struct bfd_sym_data_struct;
548
549 extern bfd_boolean bfd_sym_mkobject
550   (bfd *);
551 extern void bfd_sym_print_symbol
552   (bfd *, void *, asymbol *, bfd_print_symbol_type);
553 extern bfd_boolean bfd_sym_valid
554   (bfd *);
555 extern unsigned char * bfd_sym_read_name_table
556   (bfd *, bfd_sym_header_block *);
557 extern void bfd_sym_parse_file_reference_v32
558   (unsigned char *, size_t, bfd_sym_file_reference *);
559 extern void bfd_sym_parse_disk_table_v32
560   (unsigned char *, size_t, bfd_sym_table_info *);
561 extern void bfd_sym_parse_header_v32
562   (unsigned char *, size_t, bfd_sym_header_block *);
563 extern int bfd_sym_read_header_v32
564   (bfd *, bfd_sym_header_block *);
565 extern int bfd_sym_read_header_v34
566   (bfd *, bfd_sym_header_block *);
567 extern int bfd_sym_read_header
568   (bfd *, bfd_sym_header_block *, bfd_sym_version);
569 extern int bfd_sym_read_version
570   (bfd *, bfd_sym_version *);
571 extern void bfd_sym_display_table_summary
572   (FILE *, bfd_sym_table_info *, const char *);
573 extern void bfd_sym_display_header
574   (FILE *, bfd_sym_header_block *);
575 extern void bfd_sym_parse_resources_table_entry_v32
576   (unsigned char *, size_t, bfd_sym_resources_table_entry *);
577 extern void bfd_sym_parse_modules_table_entry_v33
578   (unsigned char *, size_t, bfd_sym_modules_table_entry *);
579 extern void bfd_sym_parse_file_references_table_entry_v32
580   (unsigned char *, size_t, bfd_sym_file_references_table_entry *);
581 extern void bfd_sym_parse_contained_modules_table_entry_v32
582   (unsigned char *, size_t, bfd_sym_contained_modules_table_entry *);
583 extern void bfd_sym_parse_contained_variables_table_entry_v32
584   (unsigned char *, size_t, bfd_sym_contained_variables_table_entry *);
585 extern void bfd_sym_parse_contained_statements_table_entry_v32
586   (unsigned char *, size_t, bfd_sym_contained_statements_table_entry *);
587 extern void bfd_sym_parse_contained_labels_table_entry_v32
588   (unsigned char *, size_t, bfd_sym_contained_labels_table_entry *);
589 extern void bfd_sym_parse_type_table_entry_v32
590   (unsigned char *, size_t, bfd_sym_type_table_entry *);
591 extern int bfd_sym_fetch_resources_table_entry
592   (bfd *, bfd_sym_resources_table_entry *, unsigned long);
593 extern int bfd_sym_fetch_modules_table_entry
594   (bfd *, bfd_sym_modules_table_entry *, unsigned long);
595 extern int bfd_sym_fetch_file_references_table_entry
596   (bfd *, bfd_sym_file_references_table_entry *, unsigned long);
597 extern int bfd_sym_fetch_contained_modules_table_entry
598   (bfd *, bfd_sym_contained_modules_table_entry *, unsigned long);
599 extern int bfd_sym_fetch_contained_variables_table_entry
600   (bfd *, bfd_sym_contained_variables_table_entry *, unsigned long);
601 extern int bfd_sym_fetch_contained_statements_table_entry
602   (bfd *, bfd_sym_contained_statements_table_entry *, unsigned long);
603 extern int bfd_sym_fetch_contained_labels_table_entry
604   (bfd *, bfd_sym_contained_labels_table_entry *, unsigned long);
605 extern int bfd_sym_fetch_contained_types_table_entry
606   (bfd *, bfd_sym_contained_types_table_entry *, unsigned long);
607 extern int bfd_sym_fetch_file_references_index_table_entry
608   (bfd *, bfd_sym_file_references_index_table_entry *, unsigned long);
609 extern int bfd_sym_fetch_constant_pool_entry
610   (bfd *, bfd_sym_constant_pool_entry *, unsigned long);
611 extern int bfd_sym_fetch_type_table_entry
612   (bfd *, bfd_sym_type_table_entry *, unsigned long);
613 extern int bfd_sym_fetch_type_information_table_entry
614   (bfd *, bfd_sym_type_information_table_entry *, unsigned long);
615 extern int bfd_sym_fetch_type_table_information
616   (bfd *, bfd_sym_type_information_table_entry *, unsigned long);
617 extern const unsigned char * bfd_sym_symbol_name
618   (bfd *, unsigned long);
619 extern const unsigned char * bfd_sym_module_name
620   (bfd *, unsigned long);
621 extern const char * bfd_sym_unparse_storage_kind
622   (enum bfd_sym_storage_kind);
623 extern const char * bfd_sym_unparse_storage_class
624   (enum bfd_sym_storage_class);
625 extern const char * bfd_sym_unparse_module_kind
626   (enum bfd_sym_module_kind);
627 extern const char * bfd_sym_unparse_symbol_scope
628   (enum bfd_sym_symbol_scope);
629 extern void bfd_sym_print_file_reference
630   (bfd *, FILE *, bfd_sym_file_reference *);
631 extern void bfd_sym_print_resources_table_entry
632   (bfd *, FILE *, bfd_sym_resources_table_entry *);
633 extern void bfd_sym_print_modules_table_entry
634   (bfd *, FILE *, bfd_sym_modules_table_entry *);
635 extern void bfd_sym_print_file_references_table_entry
636   (bfd *, FILE *, bfd_sym_file_references_table_entry *);
637 extern void bfd_sym_print_contained_modules_table_entry
638   (bfd *, FILE *, bfd_sym_contained_modules_table_entry *);
639 extern void bfd_sym_print_contained_variables_table_entry
640   (bfd *, FILE *f, bfd_sym_contained_variables_table_entry *);
641 extern void bfd_sym_print_contained_statements_table_entry
642   (bfd *, FILE *, bfd_sym_contained_statements_table_entry *);
643 extern void bfd_sym_print_contained_labels_table_entry
644   (bfd *, FILE *, bfd_sym_contained_labels_table_entry *);
645 extern void bfd_sym_print_contained_types_table_entry
646   (bfd *, FILE *, bfd_sym_contained_types_table_entry *);
647 extern const char * bfd_sym_type_operator_name
648   (unsigned char);
649 extern const char * bfd_sym_type_basic_name
650   (unsigned char);
651 extern int bfd_sym_fetch_long
652   (unsigned char *, unsigned long, unsigned long, unsigned long *, long *);
653 extern void bfd_sym_print_type_information
654   (bfd *, FILE *, unsigned char *, unsigned long, unsigned long, unsigned long *);
655 extern void bfd_sym_print_type_information_table_entry
656   (bfd *, FILE *, bfd_sym_type_information_table_entry *);
657 extern void bfd_sym_print_file_references_index_table_entry
658   (bfd *, FILE *, bfd_sym_file_references_index_table_entry *);
659 extern void bfd_sym_print_constant_pool_entry
660   (bfd *, FILE *, bfd_sym_constant_pool_entry *);
661 extern unsigned char * bfd_sym_display_name_table_entry
662   (bfd *, FILE *, unsigned char *);
663 extern void bfd_sym_display_name_table
664   (bfd *, FILE *);
665 extern void bfd_sym_display_resources_table
666   (bfd *, FILE *);
667 extern void bfd_sym_display_modules_table
668   (bfd *, FILE *);
669 extern void bfd_sym_display_file_references_table
670   (bfd *, FILE *);
671 extern void bfd_sym_display_contained_modules_table
672   (bfd *, FILE *);
673 extern void bfd_sym_display_contained_variables_table
674   (bfd *, FILE *);
675 extern void bfd_sym_display_contained_statements_table
676   (bfd *, FILE *);
677 extern void bfd_sym_display_contained_labels_table
678   (bfd *, FILE *);
679 extern void bfd_sym_display_contained_types_table
680   (bfd *, FILE *);
681 extern void bfd_sym_display_file_references_index_table
682   (bfd *, FILE *);
683 extern void bfd_sym_display_constant_pool
684   (bfd *, FILE *);
685 extern void bfd_sym_display_type_information_table
686   (bfd *, FILE *);
687 extern int bfd_sym_scan
688   (bfd *, bfd_sym_version, bfd_sym_data_struct *);
689 extern const bfd_target * bfd_sym_object_p
690   (bfd *);
691 extern void bfd_sym_get_symbol_info
692   (bfd *, asymbol *, symbol_info *);
693 extern long bfd_sym_get_symtab_upper_bound
694   (bfd *);
695 extern long bfd_sym_canonicalize_symtab
696   (bfd *, asymbol **);
697 extern int bfd_sym_sizeof_headers
698   (bfd *, struct bfd_link_info *);
699
700 #endif /* __xSYM_H__ */