ld/deffile.h

   1 /* deffile.h - header for .DEF file parser
   2    Copyright (C) 1998-2022 Free Software Foundation, Inc.
   3    Written by DJ Delorie dj@cygnus.com
   4
   5    This file is part of the GNU Binutils.
   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, or (at your option)
  10    any later version.
  11
  12    The 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 GLD; see the file COPYING.  If not, write to the Free
  19    Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
  20    02110-1301, USA.  */
  21
  22 #ifndef DEFFILE_H
  23 #define DEFFILE_H
  24
  25 /* DEF storage definitions.  Note that any ordinal may be zero, and
  26    any pointer may be NULL, if not defined by the DEF file.  */
  27
  28 typedef struct def_file_section {
  29   char *name;                   /* always set */
  30   char *class;                  /* may be NULL */
  31   char flag_read, flag_write, flag_execute, flag_shared;
  32 } def_file_section;
  33
  34 typedef struct def_file_export {
  35   char *name;                   /* always set */
  36   char *internal_name;          /* always set, may == name */
  37   char *its_name;               /* optional export table name referred to. */
  38   int ordinal;                  /* -1 if not specified */
  39   int hint;
  40   char flag_private, flag_constant, flag_noname, flag_data, flag_forward;
  41 } def_file_export;
  42
  43 typedef struct def_file_module {
  44   struct def_file_module *next;
  45   void *user_data;
  46   char name[1];                 /* extended via malloc */
  47 } def_file_module;
  48
  49 typedef struct def_file_import {
  50   char *internal_name;          /* always set */
  51   def_file_module *module;      /* always set */
  52   char *name;                   /* may be NULL; either this or ordinal will be set */
  53   char *its_name;               /* optional import table name referred to. */
  54   int ordinal;                  /* may be -1 */
  55   int data;                     /* = 1 if data */
  56 } def_file_import;
  57
  58 typedef struct def_file_aligncomm {
  59   struct def_file_aligncomm *next;      /* Chain pointer.  */
  60   char *symbol_name;            /* Name of common symbol.  */
  61   unsigned int alignment;       /* log-2 alignment.        */
  62 } def_file_aligncomm;
  63
  64 typedef struct def_file_exclude_symbol {
  65   struct def_file_exclude_symbol *next; /* Chain pointer.  */
  66   char *symbol_name;            /* Name of excluded symbol.  */
  67 } def_file_exclude_symbol;
  68
  69 typedef struct def_file {
  70   /* From the NAME or LIBRARY command.  */
  71   char *name;
  72   int is_dll;                   /* -1 if NAME/LIBRARY not given */
  73   bfd_vma base_address;         /* (bfd_vma)(-1) if unspecified */
  74
  75   /* From the DESCRIPTION command.  */
  76   char *description;
  77
  78   /* From the STACK/HEAP command, -1 if unspecified.  */
  79   int stack_reserve, stack_commit;
  80   int heap_reserve, heap_commit;
  81
  82   /* From the SECTION/SEGMENT commands.  */
  83   int num_section_defs;
  84   def_file_section *section_defs;
  85
  86   /* From the EXPORTS commands.  */
  87   int num_exports;
  88   def_file_export *exports;
  89
  90   /* Used by imports for module names.  */
  91   def_file_module *modules;
  92
  93   /* From the IMPORTS commands.  */
  94   int num_imports;
  95   def_file_import *imports;
  96
  97   /* From the VERSION command, -1 if not specified.  */
  98   int version_major, version_minor;
  99
 100   /* Only expected from .drectve sections, not .DEF files.  */
 101   def_file_aligncomm *aligncomms;
 102
 103   /* From EXCLUDE_SYMBOLS or embedded directives. */
 104   def_file_exclude_symbol *exclude_symbols;
 105
 106 } def_file;
 107
 108 extern def_file *def_file_empty (void);
 109
 110 /* The second arg may be NULL.  If not, this .def is appended to it.  */
 111 extern def_file *def_file_parse (const char *, def_file *);
 112 extern void def_file_free (def_file *);
 113 extern def_file_export *def_file_add_export (def_file *, const char *,
 114                                              const char *, int,
 115                                              const char *, int *);
 116 extern def_file_import *def_file_add_import (def_file *, const char *,
 117                                              const char *, int, const char *,
 118                                              const char *, int *);
 119 extern int def_file_add_import_from (def_file *fdef,
 120                                      int num_imports,
 121                                      const char *name,
 122                                      const char *module,
 123                                      int ordinal,
 124                                      const char *internal_name,
 125                                      const char *its_name);
 126 extern def_file_import *def_file_add_import_at (def_file *, int, const char *,
 127                                                 const char *, int, const char *,
 128                                                 const char *);
 129 extern void def_file_add_directive (def_file *, const char *, int);
 130 extern def_file_module *def_get_module (def_file *, const char *);
 131 #ifdef DEF_FILE_PRINT
 132 extern void def_file_print (FILE *, def_file *);
 133 #endif
 134
 135 #endif /* DEFFILE_H */