git.sur5r.net Git - cc65/blob - src/ld65/config.h

   1 /*****************************************************************************/
   2 /*                                                                           */
   3 /*                                 config.h                                  */
   4 /*                                                                           */
   5 /*               Target configuration file for the ld65 linker               */
   6 /*                                                                           */
   7 /*                                                                           */
   8 /*                                                                           */
   9 /* (C) 1998-2011, Ullrich von Bassewitz                                      */
  10 /*                Roemerstrasse 52                                           */
  11 /*                D-70794 Filderstadt                                        */
  12 /* EMail:         uz@cc65.org                                                */
  13 /*                                                                           */
  14 /*                                                                           */
  15 /* This software is provided 'as-is', without any expressed or implied       */
  16 /* warranty.  In no event will the authors be held liable for any damages    */
  17 /* arising from the use of this software.                                    */
  18 /*                                                                           */
  19 /* Permission is granted to anyone to use this software for any purpose,     */
  20 /* including commercial applications, and to alter it and redistribute it    */
  21 /* freely, subject to the following restrictions:                            */
  22 /*                                                                           */
  23 /* 1. The origin of this software must not be misrepresented; you must not   */
  24 /*    claim that you wrote the original software. If you use this software   */
  25 /*    in a product, an acknowledgment in the product documentation would be  */
  26 /*    appreciated but is not required.                                       */
  27 /* 2. Altered source versions must be plainly marked as such, and must not   */
  28 /*    be misrepresented as being the original software.                      */
  29 /* 3. This notice may not be removed or altered from any source              */
  30 /*    distribution.                                                          */
  31 /*                                                                           */
  32 /*****************************************************************************/
  33
  34
  35
  36 #ifndef CONFIG_H
  37 #define CONFIG_H
  38
  39
  40
  41 /* common */
  42 #include "coll.h"
  43 #include "filepos.h"
  44
  45 /* ld65 */
  46 #include "lineinfo.h"
  47 #include "segments.h"
  48
  49
  50
  51 /*****************************************************************************/
  52 /*                                   Data                                    */
  53 /*****************************************************************************/
  54
  55
  56
  57 /* Forward for struct MemoryArea */
  58 struct MemoryArea;
  59
  60 /* File list entry */
  61 typedef struct File File;
  62 struct File {
  63     unsigned            Name;           /* Name index of the file */
  64     unsigned            Flags;
  65     unsigned            Format;         /* Output format */
  66     Collection          MemoryAreas;    /* List of memory areas in this file */
  67 };
  68
  69 /* Segment descriptor entry */
  70 typedef struct SegDesc SegDesc;
  71 struct SegDesc {
  72     unsigned            Name;           /* Index of the name */
  73     LineInfo*           LI;             /* Position of definition */
  74     Segment*            Seg;            /* Pointer to segment structure */
  75     unsigned            Attr;           /* Attributes for segment */
  76     unsigned            Flags;          /* Set of bitmapped flags */
  77     struct MemoryArea*  Load;           /* Load memory section */
  78     struct MemoryArea*  Run;            /* Run memory section */
  79     unsigned long       Addr;           /* Start address or offset into segment */
  80     unsigned long       RunAlignment;   /* Run area alignment if given */
  81     unsigned long       LoadAlignment;  /* Load area alignment if given */
  82 };
  83
  84 /* Segment flags */
  85 #define SF_RO           0x0001          /* Read only segment */
  86 #define SF_BSS          0x0002          /* Segment is BSS style segment */
  87 #define SF_ZP           0x0004          /* Zeropage segment (o65 only) */
  88 #define SF_DEFINE       0x0008          /* Define start and size */
  89 #define SF_ALIGN        0x0010          /* Align segment in run area */
  90 #define SF_ALIGN_LOAD   0x0020          /* Align segment in load area */
  91 #define SF_OFFSET       0x0040          /* Segment has offset in memory */
  92 #define SF_START        0x0080          /* Segment has fixed start address */
  93 #define SF_OPTIONAL     0x0100          /* Segment is optional (must not exist) */
  94 #define SF_RUN_DEF      0x0200          /* RUN symbols already defined */
  95 #define SF_LOAD_DEF     0x0400          /* LOAD symbols already defined */
  96
  97
  98
  99 /*****************************************************************************/
 100 /*                                   Code                                    */
 101 /*****************************************************************************/
 102
 103
 104
 105 void CfgRead (void);
 106 /* Read the configuration */
 107
 108 unsigned CfgProcess (void);
 109 /* Process the config file after reading in object files and libraries. This
 110  * includes postprocessing of the config file data but also assigning segments
 111  * and defining segment/memory area related symbols. The function will return
 112  * the number of memory area overflows (so zero means anything went ok).
 113  * In case of overflows, a short mapfile can be generated later, to ease the
 114  * task of rearranging segments for the user.
 115  */
 116
 117 void CfgWriteTarget (void);
 118 /* Write the target file(s) */
 119
 120
 121
 122 /* End of config.h */
 123
 124 #endif
 125
 126
 127
 128
 129