1 /*****************************************************************************/
5 /* Object file writing routines for the ca65 macroassembler */
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 /*****************************************************************************/
52 /*****************************************************************************/
54 /*****************************************************************************/
61 /* Default extension */
64 /* Header structure */
65 static ObjHeader Header = {
66 OBJ_MAGIC, /* 32: Magic number */
67 OBJ_VERSION, /* 16: Version number */
69 0, /* 32: Offset to option table */
70 0, /* 32: Size of options */
71 0, /* 32: Offset to file table */
72 0, /* 32: Size of files */
73 0, /* 32: Offset to segment table */
74 0, /* 32: Size of segment table */
75 0, /* 32: Offset to import list */
76 0, /* 32: Size of import list */
77 0, /* 32: Offset to export list */
78 0, /* 32: Size of export list */
79 0, /* 32: Offset to list of debug symbols */
80 0, /* 32: Size of debug symbols */
81 0, /* 32: Offset to list of line infos */
82 0, /* 32: Size of line infos */
83 0, /* 32: Offset to string pool */
84 0, /* 32: Size of string pool */
85 0, /* 32: Offset to assertion table */
86 0, /* 32: Size of assertion table */
87 0, /* 32: Offset into scope table */
88 0, /* 32: Size of scope table */
89 0, /* 32: Offset into span table */
90 0, /* 32: Size of span table */
95 /*****************************************************************************/
96 /* Internally used functions */
97 /*****************************************************************************/
101 static void ObjWriteError (void)
102 /* Called on a write error. Will try to close and remove the file, then
103 * print a fatal error.
106 /* Remember the error */
109 /* Force a close of the file, ignoring errors */
112 /* Try to remove the file, also ignoring errors */
115 /* Now abort with a fatal error */
116 Fatal ("Cannot write to output file `%s': %s", OutFile, strerror (Error));
121 static void ObjWriteHeader (void)
122 /* Write the object file header to the current file position */
124 ObjWrite32 (Header.Magic);
125 ObjWrite16 (Header.Version);
126 ObjWrite16 (Header.Flags);
127 ObjWrite32 (Header.OptionOffs);
128 ObjWrite32 (Header.OptionSize);
129 ObjWrite32 (Header.FileOffs);
130 ObjWrite32 (Header.FileSize);
131 ObjWrite32 (Header.SegOffs);
132 ObjWrite32 (Header.SegSize);
133 ObjWrite32 (Header.ImportOffs);
134 ObjWrite32 (Header.ImportSize);
135 ObjWrite32 (Header.ExportOffs);
136 ObjWrite32 (Header.ExportSize);
137 ObjWrite32 (Header.DbgSymOffs);
138 ObjWrite32 (Header.DbgSymSize);
139 ObjWrite32 (Header.LineInfoOffs);
140 ObjWrite32 (Header.LineInfoSize);
141 ObjWrite32 (Header.StrPoolOffs);
142 ObjWrite32 (Header.StrPoolSize);
143 ObjWrite32 (Header.AssertOffs);
144 ObjWrite32 (Header.AssertSize);
145 ObjWrite32 (Header.ScopeOffs);
146 ObjWrite32 (Header.ScopeSize);
147 ObjWrite32 (Header.SpanOffs);
148 ObjWrite32 (Header.SpanSize);
153 /*****************************************************************************/
155 /*****************************************************************************/
160 /* Open the object file for writing, write a dummy header */
162 /* Do we have a name for the output file? */
164 /* We don't have an output name explicitly given, construct one from
165 * the name of the input file.
167 OutFile = MakeFilename (InFile, OBJ_EXT);
170 /* Create the output file */
171 F = fopen (OutFile, "w+b");
173 Fatal ("Cannot open output file `%s': %s", OutFile, strerror (errno));
176 /* Write a dummy header */
183 /* Write an update header and close the object file. */
185 /* Go back to the beginning */
186 if (fseek (F, 0, SEEK_SET) != 0) {
190 /* If we have debug infos, set the flag in the header */
192 Header.Flags |= OBJ_FLAGS_DBGINFO;
195 /* Write the updated header */
199 if (fclose (F) != 0) {
206 unsigned long ObjGetFilePos (void)
207 /* Get the current file position */
209 long Pos = ftell (F);
218 void ObjSetFilePos (unsigned long Pos)
219 /* Set the file position */
221 if (fseek (F, Pos, SEEK_SET) != 0) {
228 void ObjWrite8 (unsigned V)
229 /* Write an 8 bit value to the file */
231 if (putc (V, F) == EOF) {
238 void ObjWrite16 (unsigned V)
239 /* Write a 16 bit value to the file */
247 void ObjWrite24 (unsigned long V)
248 /* Write a 24 bit value to the file */
257 void ObjWrite32 (unsigned long V)
258 /* Write a 32 bit value to the file */
268 void ObjWriteVar (unsigned long V)
269 /* Write a variable sized value to the file in special encoding */
271 /* We will write the value to the file in 7 bit chunks. If the 8th bit
272 * is clear, we're done, if it is set, another chunk follows. This will
273 * allow us to encode smaller values with less bytes, at the expense of
274 * needing 5 bytes if a 32 bit value is written to file.
277 unsigned char C = (V & 0x7F);
288 void ObjWriteStr (const char* S)
289 /* Write a string to the object file */
291 unsigned Len = strlen (S);
293 /* Write the string with the length preceeded (this is easier for
294 * the reading routine than the C format since the length is known in
298 ObjWriteData (S, Len);
303 void ObjWriteBuf (const StrBuf* S)
304 /* Write a string to the object file */
306 /* Write the string with the length preceeded (this is easier for
307 * the reading routine than the C format since the length is known in
310 ObjWriteVar (SB_GetLen (S));
311 ObjWriteData (SB_GetConstBuf (S), SB_GetLen (S));
316 void ObjWriteData (const void* Data, unsigned Size)
317 /* Write literal data to the file */
319 if (fwrite (Data, 1, Size, F) != Size) {
326 void ObjWritePos (const FilePos* Pos)
327 /* Write a file position to the object file */
329 /* Write the data entries */
330 ObjWriteVar (Pos->Line);
331 ObjWriteVar (Pos->Col);
332 if (Pos->Name == 0) {
333 /* Position is outside file scope, use the main file instead */
336 ObjWriteVar (Pos->Name - 1);
342 void ObjStartOptions (void)
343 /* Mark the start of the option section */
345 Header.OptionOffs = ftell (F);
350 void ObjEndOptions (void)
351 /* Mark the end of the option section */
353 Header.OptionSize = ftell (F) - Header.OptionOffs;
358 void ObjStartFiles (void)
359 /* Mark the start of the files section */
361 Header.FileOffs = ftell (F);
366 void ObjEndFiles (void)
367 /* Mark the end of the files section */
369 Header.FileSize = ftell (F) - Header.FileOffs;
374 void ObjStartSegments (void)
375 /* Mark the start of the segment section */
377 Header.SegOffs = ftell (F);
382 void ObjEndSegments (void)
383 /* Mark the end of the segment section */
385 Header.SegSize = ftell (F) - Header.SegOffs;
390 void ObjStartImports (void)
391 /* Mark the start of the import section */
393 Header.ImportOffs = ftell (F);
398 void ObjEndImports (void)
399 /* Mark the end of the import section */
401 Header.ImportSize = ftell (F) - Header.ImportOffs;
406 void ObjStartExports (void)
407 /* Mark the start of the export section */
409 Header.ExportOffs = ftell (F);
414 void ObjEndExports (void)
415 /* Mark the end of the export section */
417 Header.ExportSize = ftell (F) - Header.ExportOffs;
422 void ObjStartDbgSyms (void)
423 /* Mark the start of the debug symbol section */
425 Header.DbgSymOffs = ftell (F);
430 void ObjEndDbgSyms (void)
431 /* Mark the end of the debug symbol section */
433 Header.DbgSymSize = ftell (F) - Header.DbgSymOffs;
438 void ObjStartLineInfos (void)
439 /* Mark the start of the line info section */
441 Header.LineInfoOffs = ftell (F);
446 void ObjEndLineInfos (void)
447 /* Mark the end of the line info section */
449 Header.LineInfoSize = ftell (F) - Header.LineInfoOffs;
454 void ObjStartStrPool (void)
455 /* Mark the start of the string pool section */
457 Header.StrPoolOffs = ftell (F);
462 void ObjEndStrPool (void)
463 /* Mark the end of the string pool section */
465 Header.StrPoolSize = ftell (F) - Header.StrPoolOffs;
470 void ObjStartAssertions (void)
471 /* Mark the start of the assertion table */
473 Header.AssertOffs = ftell (F);
478 void ObjEndAssertions (void)
479 /* Mark the end of the assertion table */
481 Header.AssertSize = ftell (F) - Header.AssertOffs;
486 void ObjStartScopes (void)
487 /* Mark the start of the scope table */
489 Header.ScopeOffs = ftell (F);
494 void ObjEndScopes (void)
495 /* Mark the end of the scope table */
497 Header.ScopeSize = ftell (F) - Header.ScopeOffs;
502 void ObjStartSpans (void)
503 /* Mark the start of the span table */
505 Header.SpanOffs = ftell (F);
510 void ObjEndSpans (void)
511 /* Mark the end of the span table */
513 Header.SpanSize = ftell (F) - Header.SpanOffs;