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 /* Forward for struct MemoryArea */
  56 struct MemoryArea;
  57
  58 /* File list entry */
  59 typedef struct File File;
  60 struct File {
  61     unsigned            Name;           /* Name index of the file */
  62     unsigned            Flags;
  63     unsigned            Format;         /* Output format */
  64     Collection          MemoryAreas;    /* List of memory areas in this file */
  65 };
  66
  67 /* Segment descriptor entry */
  68 typedef struct SegDesc SegDesc;
  69 struct SegDesc {
  70     unsigned            Name;           /* Index of the name */
  71     Segment*            Seg;            /* Pointer to segment structure */
  72     unsigned            Attr;           /* Attributes for segment */
  73     unsigned            Flags;          /* Set of bitmapped flags */
  74     struct MemoryArea*  Load;           /* Load memory section */
  75     struct MemoryArea*  Run;            /* Run memory section */
  76     unsigned long       Addr;           /* Start address or offset into segment */
  77     unsigned char       Align;          /* Run area alignment if given */
  78     unsigned char       AlignLoad;      /* Load area alignment if given */
  79 };
  80
  81 /* Segment flags */
  82 #define SF_RO           0x0001          /* Read only segment */
  83 #define SF_BSS          0x0002          /* Segment is BSS style segment */
  84 #define SF_ZP           0x0004          /* Zeropage segment (o65 only) */
  85 #define SF_DEFINE       0x0008          /* Define start and size */
  86 #define SF_ALIGN        0x0010          /* Align segment in run area */
  87 #define SF_ALIGN_LOAD   0x0020          /* Align segment in load area */
  88 #define SF_OFFSET       0x0040          /* Segment has offset in memory */
  89 #define SF_START        0x0080          /* Segment has fixed start address */
  90 #define SF_OPTIONAL     0x0100          /* Segment is optional (must not exist) */
  91 #define SF_RUN_DEF      0x0200          /* RUN symbols already defined */
  92 #define SF_LOAD_DEF     0x0400          /* LOAD symbols already defined */
  93
  94
  95
  96 /*****************************************************************************/
  97 /*                                   Code                                    */
  98 /*****************************************************************************/
  99
 100
 101
 102 void CfgRead (void);
 103 /* Read the configuration */
 104
 105 void CfgProcess (void);
 106 /* Process the config file after reading in object files and libraries */
 107
 108 unsigned CfgAssignSegments (void);
 109 /* Assign segments, define linker symbols where requested. The function will
 110  * return the number of memory area overflows (so zero means anything went ok).
 111  * In case of overflows, a short mapfile can be generated later, to ease the
 112  * task of rearranging segments for the user.
 113  */
 114
 115 void CfgWriteTarget (void);
 116 /* Write the target file(s) */
 117
 118
 119
 120 /* End of config.h */
 121
 122 #endif
 123
 124
 125
 126
 127