1 /*****************************************************************************/
5 /* Target configuration file for the ld65 linker */
9 /* (C) 1998-2010, Ullrich von Bassewitz */
10 /* Roemerstrasse 52 */
11 /* D-70794 Filderstadt */
12 /* EMail: uz@cc65.org */
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. */
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: */
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 */
32 /*****************************************************************************/
49 /*****************************************************************************/
51 /*****************************************************************************/
56 typedef struct File File;
58 unsigned Name; /* Name index of the file */
60 unsigned Format; /* Output format */
61 Collection MemList; /* List of memory areas in this file */
64 /* Segment list node. Needed because there are two lists (RUN & LOAD) */
65 typedef struct MemListNode MemListNode;
67 MemListNode* Next; /* Next entry */
68 struct SegDesc* Seg; /* Segment */
71 /* Memory list entry */
72 typedef struct Memory 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 */
87 /* Segment descriptor entry */
88 typedef struct SegDesc 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 */
103 extern SegDesc* SegDescList; /* Single linked list */
104 extern unsigned SegDescCount; /* Number of entries in list */
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 */
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 */
127 /*****************************************************************************/
129 /*****************************************************************************/
134 /* Read the configuration */
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.
143 void CfgWriteTarget (void);
144 /* Write the target file(s) */
148 /* End of config.h */