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-2010, 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
  44 /* ld65 */
  45 #include "segments.h"
  46
  47
  48
  49 /*****************************************************************************/
  50 /*                                   Data                                    */
  51 /*****************************************************************************/
  52
  53
  54
  55 /* File list entry */
  56 typedef struct File File;
  57 struct File {
  58     unsigned            Name;           /* Name index of the file */
  59     unsigned            Flags;
  60     unsigned            Format;         /* Output format */
  61     Collection          MemList;        /* List of memory areas in this file */
  62 };
  63
  64 /* Segment list node. Needed because there are two lists (RUN & LOAD) */
  65 typedef struct MemListNode MemListNode;
  66 struct MemListNode {
  67     MemListNode*        Next;           /* Next entry */
  68     struct SegDesc*     Seg;            /* Segment */
  69 };
  70
  71 /* Memory list entry */
  72 typedef struct Memory Memory;
  73 struct Memory {
  74     unsigned            Name;           /* Name index of the memory section */
  75     unsigned            Attr;           /* Which values are valid? */
  76     unsigned            Flags;          /* Set of bitmapped flags */
  77     unsigned long       Start;          /* Start address */
  78     unsigned long       Size;           /* Length of memory section */
  79     unsigned long       FillLevel;      /* Actual fill level of segment */
  80     unsigned char       FillVal;        /* Value used to fill rest of seg */
  81     unsigned char       Relocatable;    /* Memory area is relocatable */
  82     MemListNode*        SegList;        /* List of segments for this section */
  83     MemListNode*        SegLast;        /* Last segment in this section */
  84     File*               F;              /* File that contains the entry */
  85 };
  86
  87 /* Segment descriptor entry */
  88 typedef struct SegDesc SegDesc;
  89 struct SegDesc {
  90     unsigned            Name;           /* Index of the name */
  91     SegDesc*            Next;           /* Pointer to next entry in list */
  92     Segment*            Seg;            /* Pointer to segment structure */
  93     unsigned            Attr;           /* Attributes for segment */
  94     unsigned            Flags;          /* Set of bitmapped flags */
  95     Memory*             Load;           /* Load memory section */
  96     Memory*             Run;            /* Run memory section */
  97     unsigned long       Addr;           /* Start address or offset into segment */
  98     unsigned char       Align;          /* Run area alignment if given */
  99     unsigned char       AlignLoad;      /* Load area alignment if given */
 100 };
 101
 102 /* Segment list */
 103 extern SegDesc*         SegDescList;    /* Single linked list */
 104 extern unsigned         SegDescCount;   /* Number of entries in list */
 105
 106 /* Memory flags */
 107 #define MF_DEFINE       0x0001          /* Define start and size */
 108 #define MF_FILL         0x0002          /* Fill segment */
 109 #define MF_RO           0x0004          /* Read only memory area */
 110 #define MF_OVERFLOW     0x0008          /* Memory area overflow */
 111
 112 /* Segment flags */
 113 #define SF_RO           0x0001          /* Read only segment */
 114 #define SF_BSS          0x0002          /* Segment is BSS style segment */
 115 #define SF_ZP           0x0004          /* Zeropage segment (o65 only) */
 116 #define SF_DEFINE       0x0008          /* Define start and size */
 117 #define SF_ALIGN        0x0010          /* Align segment in run area */
 118 #define SF_ALIGN_LOAD   0x0020          /* Align segment in load area */
 119 #define SF_OFFSET       0x0040          /* Segment has offset in memory */
 120 #define SF_START        0x0080          /* Segment has fixed start address */
 121 #define SF_OPTIONAL     0x0100          /* Segment is optional (must not exist) */
 122 #define SF_RUN_DEF      0x0200          /* RUN symbols already defined */
 123 #define SF_LOAD_DEF     0x0400          /* LOAD symbols already defined */
 124
 125
 126
 127 /*****************************************************************************/
 128 /*                                   Code                                    */
 129 /*****************************************************************************/
 130
 131
 132
 133 void CfgRead (void);
 134 /* Read the configuration */
 135
 136 unsigned CfgAssignSegments (void);
 137 /* Assign segments, define linker symbols where requested. The function will
 138  * return the number of memory area overflows (so zero means anything went ok).
 139  * In case of overflows, a short mapfile can be generated later, to ease the
 140  * task of rearranging segments for the user.
 141  */
 142
 143 void CfgWriteTarget (void);
 144 /* Write the target file(s) */
 145
 146
 147
 148 /* End of config.h */
 149
 150 #endif
 151
 152
 153
 154
 155