1 /*****************************************************************************/
5 /* Module to handle the raw binary format */
9 /* (C) 1999-2000 Ullrich von Bassewitz */
11 /* D-70597 Stuttgart */
12 /* EMail: uz@musoftware.de */
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 /*****************************************************************************/
56 /*****************************************************************************/
58 /*****************************************************************************/
63 unsigned Undef; /* Count of undefined externals */
64 FILE* F; /* Output file */
65 const char* Filename; /* Name of output file */
70 /*****************************************************************************/
72 /*****************************************************************************/
76 BinDesc* NewBinDesc (void)
77 /* Create a new binary format descriptor */
79 /* Allocate memory for a new BinDesc struct */
80 BinDesc* D = xmalloc (sizeof (BinDesc));
82 /* Initialize the fields */
87 /* Return the created struct */
93 void FreeBinDesc (BinDesc* D)
94 /* Free a binary format descriptor */
101 static unsigned BinWriteExpr (ExprNode* E, int Signed, unsigned Size,
102 unsigned long Offs, void* Data)
103 /* Called from SegWrite for an expression. Evaluate the expression, check the
104 * range and write the expression value to the file.
107 /* There's a predefined function to handle constant expressions */
108 return SegWriteConstExpr (((BinDesc*)Data)->F, E, Signed, Size);
113 static void PrintBoolVal (const char* Name, int B)
114 /* Print a boolean value for debugging */
116 printf (" %s = %s\n", Name, B? "true" : "false");
121 static void BinWriteMem (BinDesc* D, Memory* M)
122 /* Write the segments of one memory area to a file */
124 /* Get the start address of this memory area */
125 unsigned long Addr = M->Start;
127 /* Get a pointer to the first segment node */
128 MemListNode* N = M->SegList;
133 /* Get the segment from the list node */
136 /* Keep the user happy */
137 Print (stdout, 1, " Writing `%s'\n", S->Name);
139 /* Writes do only occur in the load area and not for BSS segments */
140 DoWrite = (S->Flags & SF_BSS) == 0 && /* No BSS segment */
141 S->Load == M && /* LOAD segment */
142 S->Seg->Dumped == 0; /* Not already written */
144 /* Output the DoWrite flag for debugging */
146 PrintBoolVal ("bss", S->Flags & SF_BSS);
147 PrintBoolVal ("LoadArea", S->Load == M);
148 PrintBoolVal ("Dumped", S->Seg->Dumped);
149 PrintBoolVal ("DoWrite", DoWrite);
152 /* Check if we would need an alignment */
153 if (S->Seg->Align > S->Align) {
154 /* Segment itself requires larger alignment than configured
157 Warning ("Segment `%s' in module `%s' requires larger alignment",
158 S->Name, GetObjFileName (S->Seg->AlignObj));
161 /* Handle ALIGN and OFFSET/START */
162 if (S->Flags & SF_ALIGN) {
163 /* Align the address */
164 unsigned long Val, NewAddr;
165 Val = (0x01UL << S->Align) - 1;
166 NewAddr = (Addr + Val) & ~Val;
168 WriteMult (D->F, M->FillVal, NewAddr-Addr);
171 /* Remember the fill value for the segment */
172 S->Seg->FillVal = M->FillVal;
173 } else if (S->Flags & (SF_OFFSET | SF_START)) {
174 unsigned long NewAddr = S->Addr;
175 if (S->Flags & SF_OFFSET) {
176 /* It's an offset, not a fixed address, make an address */
180 WriteMult (D->F, M->FillVal, NewAddr-Addr);
185 /* Now write the segment to disk if it is not a BSS type segment and
186 * if the memory area is the load area.
189 SegWrite (D->F, S->Seg, BinWriteExpr, D);
190 } else if (M->Flags & MF_FILL) {
191 WriteMult (D->F, M->FillVal, S->Seg->Size);
194 /* If this was the load memory area, mark the segment as dumped */
199 /* Calculate the new address */
200 Addr += S->Seg->Size;
202 /* Next segment node */
206 /* If a fill was requested, fill the remaining space */
207 if (M->Flags & MF_FILL) {
208 while (M->FillLevel < M->Size) {
209 Write8 (D->F, M->FillVal);
217 static int BinUnresolved (const char* Name, void* D)
218 /* Called if an unresolved symbol is encountered */
220 /* Unresolved symbols are an error in binary format. Bump the counter
221 * and return zero telling the caller that the symbol is indeed
224 ((BinDesc*) D)->Undef++;
230 void BinWriteTarget (BinDesc* D, struct File* F)
231 /* Write a binary output file */
235 /* Place the filename in the control structure */
236 D->Filename = F->Name;
238 /* Check for unresolved symbols. The function BinUnresolved is called
239 * if we get an unresolved symbol.
241 D->Undef = 0; /* Reset the counter */
242 CheckExports (BinUnresolved, D);
244 /* We had unresolved symbols, cannot create output file */
245 Error ("%u unresolved external(s) found - cannot create output file", D->Undef);
249 D->F = fopen (F->Name, "wb");
251 Error ("Cannot open `%s': %s", F->Name, strerror (errno));
254 /* Keep the user happy */
255 Print (stdout, 1, "Opened `%s'...\n", F->Name);
257 /* Dump all memory areas */
260 Print (stdout, 1, " Dumping `%s'\n", M->Name);
266 if (fclose (D->F) != 0) {
267 Error ("Cannot write to `%s': %s", F->Name, strerror (errno));
270 /* Reset the file and filename */