1 /*****************************************************************************/
5 /* Segment handling for the ld65 linker */
9 /* (C) 1998-2011, 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 /*****************************************************************************/
48 /*****************************************************************************/
50 /*****************************************************************************/
54 /* Segment structure */
55 typedef struct Segment Segment;
57 unsigned Name; /* Name index of the segment */
58 unsigned Id; /* Segment id for debug info */
59 Segment* Next; /* Hash list */
60 Segment* List; /* List of all segments */
61 struct Section* SecRoot; /* Section list */
62 struct Section* SecLast; /* Pointer to last section */
63 unsigned long PC; /* PC were this segment is located */
64 unsigned long Size; /* Size of data so far */
65 struct ObjData* AlignObj; /* Module that requested the alignment */
66 const char* OutputName; /* Name of output file or NULL */
67 unsigned long OutputOffs; /* Offset in output file */
68 unsigned char Align; /* Alignment needed */
69 unsigned char FillVal; /* Value to use for fill bytes */
70 unsigned char AddrSize; /* Address size of segment */
71 unsigned char ReadOnly; /* True for readonly segments (config) */
72 unsigned char Relocatable; /* True if the segment is relocatable */
73 unsigned char Placed; /* Did we place this segment already? */
74 unsigned char Dumped; /* Did we dump this segment? */
79 /* Section structure (a section is a part of a segment) */
80 typedef struct Section Section;
82 Section* Next; /* List of sections in a segment */
83 Segment* Seg; /* Segment that contains the section */
84 struct ObjData* Obj; /* Object file this section comes from */
85 struct Fragment* FragRoot; /* Fragment list */
86 struct Fragment* FragLast; /* Pointer to last fragment */
87 unsigned long Offs; /* Offset into the segment */
88 unsigned long Size; /* Size of the section */
89 unsigned long Fill; /* Fill bytes for alignment */
90 unsigned char Align; /* Alignment */
91 unsigned char AddrSize; /* Address size of segment */
96 /* Prototype for a function that is used to write expressions to the target
97 * file (used in SegWrite). It returns one of the following values:
99 #define SEG_EXPR_OK 0U /* Ok */
100 #define SEG_EXPR_RANGE_ERROR 1U /* Range error */
101 #define SEG_EXPR_TOO_COMPLEX 2U /* Expression too complex */
102 #define SEG_EXPR_INVALID 3U /* Expression is invalid (e.g. unmapped segment) */
104 typedef unsigned (*SegWriteFunc) (ExprNode* E, /* The expression to write */
105 int Signed, /* Signed expression? */
106 unsigned Size, /* Size (=range) */
107 unsigned long Offs, /* File offset */
108 void* Data); /* Callers data */
112 /*****************************************************************************/
114 /*****************************************************************************/
118 Segment* GetSegment (unsigned Name, unsigned char AddrSize, const char* ObjName);
119 /* Search for a segment and return an existing one. If the segment does not
120 * exist, create a new one and return that. ObjName is only used for the error
121 * message and may be NULL if the segment is linker generated.
124 Section* NewSection (Segment* Seg, unsigned char Align, unsigned char AddrSize);
125 /* Create a new section for the given segment */
127 Section* ReadSection (FILE* F, struct ObjData* O);
128 /* Read a section from a file */
130 Segment* SegFind (unsigned Name);
131 /* Return the given segment or NULL if not found. */
133 int IsBSSType (Segment* S);
134 /* Check if the given segment is a BSS style segment, that is, it does not
135 * contain non-zero data.
139 /* Dump the segments and it's contents */
141 unsigned SegWriteConstExpr (FILE* F, ExprNode* E, int Signed, unsigned Size);
142 /* Write a supposedly constant expression to the target file. Do a range
143 * check and return one of the SEG_EXPR_xxx codes.
146 void SegWrite (const char* TgtName, FILE* Tgt, Segment* S, SegWriteFunc F, void* Data);
147 /* Write the data from the given segment to a file. For expressions, F is
148 * called (see description of SegWriteFunc above).
151 void PrintSegmentMap (FILE* F);
152 /* Print a segment map to the given file */
154 void PrintDbgSegments (FILE* F);
155 /* Output the segments to the debug file */
157 void CheckSegments (void);
158 /* Walk through the segment list and check if there are segments that were
159 * not written to the output file. Output an error if this is the case.
164 /* End of segments.h */