1 /*****************************************************************************/
5 /* Module to handle the raw binary format */
9 /* (C) 1999-2001 Ullrich von Bassewitz */
11 /* D-70597 Stuttgart */
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 /*****************************************************************************/
57 /*****************************************************************************/
59 /*****************************************************************************/
64 unsigned Undef; /* Count of undefined externals */
65 FILE* F; /* Output file */
66 const char* Filename; /* Name of output file */
71 /*****************************************************************************/
73 /*****************************************************************************/
77 BinDesc* NewBinDesc (void)
78 /* Create a new binary format descriptor */
80 /* Allocate memory for a new BinDesc struct */
81 BinDesc* D = xmalloc (sizeof (BinDesc));
83 /* Initialize the fields */
88 /* Return the created struct */
94 void FreeBinDesc (BinDesc* D)
95 /* Free a binary format descriptor */
102 static unsigned BinWriteExpr (ExprNode* E, int Signed, unsigned Size,
103 unsigned long Offs, void* Data)
104 /* Called from SegWrite for an expression. Evaluate the expression, check the
105 * range and write the expression value to the file.
108 /* There's a predefined function to handle constant expressions */
109 return SegWriteConstExpr (((BinDesc*)Data)->F, E, Signed, Size);
114 static void PrintBoolVal (const char* Name, int B)
115 /* Print a boolean value for debugging */
117 printf (" %s = %s\n", Name, B? "true" : "false");
122 static void BinWriteMem (BinDesc* D, Memory* M)
123 /* Write the segments of one memory area to a file */
125 /* Get the start address of this memory area */
126 unsigned long Addr = M->Start;
128 /* Get a pointer to the first segment node */
129 MemListNode* N = M->SegList;
134 /* Get the segment from the list node */
137 /* Keep the user happy */
138 Print (stdout, 1, " Writing `%s'\n", S->Name);
140 /* Writes do only occur in the load area and not for BSS segments */
141 DoWrite = (S->Flags & SF_BSS) == 0 && /* No BSS segment */
142 S->Load == M && /* LOAD segment */
143 S->Seg->Dumped == 0; /* Not already written */
145 /* Output the DoWrite flag for debugging */
147 PrintBoolVal ("bss", S->Flags & SF_BSS);
148 PrintBoolVal ("LoadArea", S->Load == M);
149 PrintBoolVal ("Dumped", S->Seg->Dumped);
150 PrintBoolVal ("DoWrite", DoWrite);
153 /* Check if we would need an alignment */
154 if (S->Seg->Align > S->Align) {
155 /* Segment itself requires larger alignment than configured
158 Warning ("Segment `%s' in module `%s' requires larger alignment",
159 S->Name, GetObjFileName (S->Seg->AlignObj));
162 /* Handle ALIGN and OFFSET/START */
163 if (S->Flags & SF_ALIGN) {
164 /* Align the address */
165 unsigned long Val, NewAddr;
166 Val = (0x01UL << S->Align) - 1;
167 NewAddr = (Addr + Val) & ~Val;
169 WriteMult (D->F, M->FillVal, NewAddr-Addr);
172 /* Remember the fill value for the segment */
173 S->Seg->FillVal = M->FillVal;
174 } else if (S->Flags & (SF_OFFSET | SF_START)) {
175 unsigned long NewAddr = S->Addr;
176 if (S->Flags & SF_OFFSET) {
177 /* It's an offset, not a fixed address, make an address */
181 WriteMult (D->F, M->FillVal, NewAddr-Addr);
186 /* Now write the segment to disk if it is not a BSS type segment and
187 * if the memory area is the load area.
190 RelocLineInfo (S->Seg);
191 SegWrite (D->F, S->Seg, BinWriteExpr, D);
192 } else if (M->Flags & MF_FILL) {
193 WriteMult (D->F, M->FillVal, S->Seg->Size);
196 /* If this was the load memory area, mark the segment as dumped */
201 /* Calculate the new address */
202 Addr += S->Seg->Size;
204 /* Next segment node */
208 /* If a fill was requested, fill the remaining space */
209 if (M->Flags & MF_FILL) {
210 while (M->FillLevel < M->Size) {
211 Write8 (D->F, M->FillVal);
219 static int BinUnresolved (const char* Name, void* D)
220 /* Called if an unresolved symbol is encountered */
222 /* Unresolved symbols are an error in binary format. Bump the counter
223 * and return zero telling the caller that the symbol is indeed
226 ((BinDesc*) D)->Undef++;
232 void BinWriteTarget (BinDesc* D, struct File* F)
233 /* Write a binary output file */
237 /* Place the filename in the control structure */
238 D->Filename = F->Name;
240 /* Check for unresolved symbols. The function BinUnresolved is called
241 * if we get an unresolved symbol.
243 D->Undef = 0; /* Reset the counter */
244 CheckExports (BinUnresolved, D);
246 /* We had unresolved symbols, cannot create output file */
247 Error ("%u unresolved external(s) found - cannot create output file", D->Undef);
251 D->F = fopen (F->Name, "wb");
253 Error ("Cannot open `%s': %s", F->Name, strerror (errno));
256 /* Keep the user happy */
257 Print (stdout, 1, "Opened `%s'...\n", F->Name);
259 /* Dump all memory areas */
262 Print (stdout, 1, " Dumping `%s'\n", M->Name);
268 if (fclose (D->F) != 0) {
269 Error ("Cannot write to `%s': %s", F->Name, strerror (errno));
272 /* Reset the file and filename */