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 /*****************************************************************************/
58 /*****************************************************************************/
60 /*****************************************************************************/
65 unsigned Undef; /* Count of undefined externals */
66 FILE* F; /* Output file */
67 const char* Filename; /* Name of output file */
72 /*****************************************************************************/
74 /*****************************************************************************/
78 BinDesc* NewBinDesc (void)
79 /* Create a new binary format descriptor */
81 /* Allocate memory for a new BinDesc struct */
82 BinDesc* D = xmalloc (sizeof (BinDesc));
84 /* Initialize the fields */
89 /* Return the created struct */
95 void FreeBinDesc (BinDesc* D)
96 /* Free a binary format descriptor */
103 static unsigned BinWriteExpr (ExprNode* E, int Signed, unsigned Size,
104 unsigned long Offs attribute ((unused)),
106 /* Called from SegWrite for an expression. Evaluate the expression, check the
107 * range and write the expression value to the file.
110 /* There's a predefined function to handle constant expressions */
111 return SegWriteConstExpr (((BinDesc*)Data)->F, E, Signed, Size);
116 static void PrintBoolVal (const char* Name, int B)
117 /* Print a boolean value for debugging */
119 printf (" %s = %s\n", Name, B? "true" : "false");
124 static void BinWriteMem (BinDesc* D, Memory* M)
125 /* Write the segments of one memory area to a file */
127 /* Get the start address of this memory area */
128 unsigned long Addr = M->Start;
130 /* Get a pointer to the first segment node */
131 MemListNode* N = M->SegList;
136 /* Get the segment from the list node */
139 /* Keep the user happy */
140 Print (stdout, 1, " Writing `%s'\n", GetString (S->Name));
142 /* Writes do only occur in the load area and not for BSS segments */
143 DoWrite = (S->Flags & SF_BSS) == 0 && /* No BSS segment */
144 S->Load == M && /* LOAD segment */
145 S->Seg->Dumped == 0; /* Not already written */
147 /* Output the DoWrite flag for debugging */
149 PrintBoolVal ("bss", S->Flags & SF_BSS);
150 PrintBoolVal ("LoadArea", S->Load == M);
151 PrintBoolVal ("Dumped", S->Seg->Dumped);
152 PrintBoolVal ("DoWrite", DoWrite);
155 /* Check if we would need an alignment */
156 if (S->Seg->Align > S->Align) {
157 /* Segment itself requires larger alignment than configured
160 Warning ("Segment `%s' in module `%s' requires larger alignment",
161 GetString (S->Name), GetObjFileName (S->Seg->AlignObj));
164 /* Handle ALIGN and OFFSET/START */
165 if (S->Flags & SF_ALIGN) {
166 /* Align the address */
167 unsigned long Val, NewAddr;
168 Val = (0x01UL << S->Align) - 1;
169 NewAddr = (Addr + Val) & ~Val;
171 WriteMult (D->F, M->FillVal, NewAddr-Addr);
174 /* Remember the fill value for the segment */
175 S->Seg->FillVal = M->FillVal;
176 } else if (S->Flags & (SF_OFFSET | SF_START)) {
177 unsigned long NewAddr = S->Addr;
178 if (S->Flags & SF_OFFSET) {
179 /* It's an offset, not a fixed address, make an address */
183 WriteMult (D->F, M->FillVal, NewAddr-Addr);
188 /* Now write the segment to disk if it is not a BSS type segment and
189 * if the memory area is the load area.
192 RelocLineInfo (S->Seg);
193 SegWrite (D->F, S->Seg, BinWriteExpr, D);
194 } else if (M->Flags & MF_FILL) {
195 WriteMult (D->F, M->FillVal, S->Seg->Size);
198 /* If this was the load memory area, mark the segment as dumped */
203 /* Calculate the new address */
204 Addr += S->Seg->Size;
206 /* Next segment node */
210 /* If a fill was requested, fill the remaining space */
211 if (M->Flags & MF_FILL) {
212 while (M->FillLevel < M->Size) {
213 Write8 (D->F, M->FillVal);
221 static int BinUnresolved (unsigned Name attribute ((unused)), void* D)
222 /* Called if an unresolved symbol is encountered */
224 /* Unresolved symbols are an error in binary format. Bump the counter
225 * and return zero telling the caller that the symbol is indeed
228 ((BinDesc*) D)->Undef++;
234 void BinWriteTarget (BinDesc* D, struct File* F)
235 /* Write a binary output file */
239 /* Place the filename in the control structure */
240 D->Filename = GetString (F->Name);
242 /* Check for unresolved symbols. The function BinUnresolved is called
243 * if we get an unresolved symbol.
245 D->Undef = 0; /* Reset the counter */
246 CheckExports (BinUnresolved, D);
248 /* We had unresolved symbols, cannot create output file */
249 Error ("%u unresolved external(s) found - cannot create output file", D->Undef);
253 D->F = fopen (D->Filename, "wb");
255 Error ("Cannot open `%s': %s", D->Filename, strerror (errno));
258 /* Keep the user happy */
259 Print (stdout, 1, "Opened `%s'...\n", D->Filename);
261 /* Dump all memory areas */
264 Print (stdout, 1, " Dumping `%s'\n", GetString (M->Name));
270 if (fclose (D->F) != 0) {
271 Error ("Cannot write to `%s': %s", D->Filename, strerror (errno));
274 /* Reset the file and filename */