2 // RLN - Reboot's Linker for the Atari Jaguar Console System
3 // RLN.C - Application Code
4 // Copyright (C) 199x, Allan K. Pratt, 2011 Reboot & Friends
9 unsigned errflag = 0; // Error flag, goes TRUE on error
10 unsigned waitflag = 0; // Wait for any keypress flag
11 unsigned versflag = 0; // Version banner has been shown flag
12 unsigned aflag = 0; // Absolute linking flag
13 unsigned bflag = 0; // Don't remove mulitply def locals flag
14 unsigned cflag = 0; // COF executable
15 unsigned dflag = 0; // Wait for key after link flag
16 unsigned gflag = 0; // Source level debug include flag
17 unsigned lflag = 0; // Add local symbols to output flag
18 unsigned mflag = 0; // Produce symbol load map flag
19 unsigned oflag = 0; // Output filename specified
20 unsigned rflag = 0; // Segment alignment size flag
21 unsigned sflag = 0; // Output only global symbols
22 unsigned vflag = 0; // Verbose flag
23 unsigned wflag = 0; // Show warnings flag
24 unsigned zflag = 0; // Suppress banner flag
25 unsigned pflag, uflag; // Unimplemented flags
26 unsigned hd = 0; // Index of next file handle to fill
27 unsigned secalign = 7; // Section Alignment (8=phrase)
28 unsigned tbase = 0; // TEXT base address
29 unsigned dbase = 0; // DATA base address
30 unsigned bbase = 0; // BSS base address
31 unsigned textoffset = 0; // COF TEXT segment offset
32 unsigned dataoffset = 0; // COF DATA segment offset
33 unsigned bssoffset = 0; // COF BSS segment offset
34 unsigned displaybanner = 1; // Display version banner
35 unsigned symoffset = 0; // Symbol table offset in output file
36 unsigned dosymi = 0; // Dosym() processing iterator
37 unsigned dbgsymbase = 0; // Debug symbol base address
38 //unsigned symtrunc = 0; // Symbol truncation -i and -ii
39 int noheaderflag = 0; // No header flag for ABS files
40 int hflags; // Value of the arg to -h option
41 int ttype, dtype, btype; // Type flag: 0, -1, -2, -3, -4
42 int tval, dval, bval; // Values of these abs bases
43 int hflag[NHANDLES]; // True for include files
44 int handle[NHANDLES]; // Open file handles
45 int textsize, datasize, bsssize; // Cumulative segment sizes
46 char libdir[FARGSIZE * 3]; // Library directory to search
47 char ofile[FARGSIZE]; // Output file name (.o)
48 char * name[NHANDLES]; // Associated file names
49 char * cmdlnexec = NULL; // Executable name - pointer to ARGV[0]
50 char * hsym1[SYMLEN]; // First symbol for include files
51 char * hsym2[SYMLEN]; // Second symbol for include files
52 struct OFILE * plist = NULL; // Object image list pointer
53 struct OFILE * plast; // Last object image list pointer
54 struct OFILE * olist = NULL; // Pointer to first object file in list
55 struct OFILE * olast; // Pointer to last object file in list
56 char obj_fname[512][FNLEN]; // Object file names
57 unsigned obj_segsize[512][3]; // Object file seg sizes; TEXT,DATA,BSS
58 unsigned obj_index = 0; // Object file index/count
59 struct HREC * htable[NBUCKETS]; // Hash table
60 struct HREC * unresolved = NULL; // Pointer to unresolved hash list
61 struct HREC * lookup(char *); // Hash lookup
62 char * ost; // Output symbol table
63 char * ost_ptr; // Output symbol table; current pointer
64 char * ost_end; // Output symbol table; end pointer
65 char * oststr; // Output string table
66 char * oststr_ptr; // Output string table; current pointer
67 char * oststr_end; // Output string table; end pointer
68 int ost_index = 0; // Index of next ost addition
69 int endian; // Processor endianess
71 // Some human readable defines for endianess
72 #define ENDIANNESS_BIG 1
73 #define ENDIANNESS_LITTLE 0
77 // Get a Long Word from Memory
79 uint32_t getlong(uint8_t * src)
84 out = (uint8_t *)&temp;
86 if (endian == ENDIANNESS_BIG)
106 // Put a Long Word into Memory
108 void putlong(uint8_t * dest, uint32_t val)
110 *dest++ = (uint8_t)(val >> 24);
111 *dest++ = (uint8_t)(val >> 16);
112 *dest++ = (uint8_t)(val >> 8);
113 *dest = (uint8_t)val;
118 // Get a Word from Memory
120 uint16_t getword(uint8_t * src)
125 out = (uint8_t *)&temp;
127 // Shamus: This assumes little endian...
130 // Shamus: And *why* do this as a uint32_t???
134 if (endian == ENDIANNESS_BIG)
151 // Put a Word into Memory
153 void putword(uint8_t * dest, uint16_t val)
155 *dest++ = (uint8_t)(val >> 8);
156 *dest = (uint8_t)val;
161 // Obtain a File's Size
167 temp = lseek(fd, 0L, SEEK_CUR);
168 hold = lseek(fd, 0L, SEEK_END);
169 lseek(fd, 0L, SEEK_SET);
176 // For this object file, add symbols to the output symbol table after
177 // relocating them. Returns TRUE if ost_lookup returns an error (-1).
179 int dosym(struct OFILE * ofile)
181 char * symptr; // Symbol pointer
182 char * symend; // Symbol end pointer
183 int type; // Symbol type
184 long value; // Symbol value
185 int index; // Symbol index
187 int ssidx; // Segment size table index
188 unsigned tsegoffset; // Cumulative TEXT segment offset
189 unsigned dsegoffset; // Cumulative DATA segment offset
190 unsigned bsegoffset; // Cumulative BSS segment offset
191 struct HREC * hptr; // Hash table pointer for globl/extrn
192 char sym[SYMLEN]; // String for symbol name/hash search
194 // Point to first symbol record in the object file
195 symptr = (ofile->o_image + 32
196 + ofile->o_header.tsize
197 + ofile->o_header.dsize
198 + ofile->o_header.absrel.reloc.tsize
199 + ofile->o_header.absrel.reloc.dsize);
201 // Point to end of symbol record in the object file
202 symend = symptr + ofile->o_header.ssize;
204 // Search through object segment size table to accumulated segment sizes to ensure
205 // the correct offsets are used in the resulting COF file.
206 ssidx = -1; // Initialise segment index
207 tsegoffset = dsegoffset = bsegoffset = 0; // Initialise segment offsets
209 for(j=0; j<(int)obj_index; j++)
210 { // Search for object file name
211 if (!strcmp(ofile->o_name, obj_fname[j]))
213 ssidx = j; // Object file name found
217 tsegoffset += obj_segsize[j][0]; // Accumulate segment sizes
218 dsegoffset += obj_segsize[j][1];
219 bsegoffset += obj_segsize[j][2];
224 printf("dosym() : Cannot get object file segment size : %s\n", ofile->o_name);
228 // Process each record in the symbol table
229 for(; symptr!=symend; symptr+=12)
231 index = getlong(symptr + 0); // Obtain symbol string index
232 type = getlong(symptr + 4); // Obtain symbol type
233 value = getlong(symptr + 8); // Obtain symbol value
235 // Global/External symbols have a pre-processing stage
236 if (type & 0x01000000)
238 // Obtain the string table index for the relocation symbol, look for it in the globals
239 // hash table to obtain information on that symbol. For the hash calculation to work
240 // correctly it must be placed in a 'clean' string before looking it up.
241 memset(sym, 0, SYMLEN);
242 strcpy(sym, symend + index);
247 printf("dosym() : Cannot determine symbol : %s\n", sym);
251 // Search through object segment size table to obtain segment sizes for the object
252 // that has the required external/global as a local symbol. As each object is
253 // interrogated the segment sizes are accumulated to ensure the correct offsets are
254 // used in the resulting COF file. This is effectively 'done again' only as we
255 // are working with a different object file.
256 ssidx = -1; // Initialise segment index
257 tsegoffset = dsegoffset = bsegoffset = 0; // Initialise segment offsets
259 for(j=0; j<(int)obj_index; j++)
260 { // Search for object filename
261 if (!strcmp((const char *)hptr->h_ofile, obj_fname[j]))
263 ssidx = j; // Symbol object filename
267 tsegoffset += obj_segsize[j][0]; // Accumulate segment sizes
268 dsegoffset += obj_segsize[j][1];
269 bsegoffset += obj_segsize[j][2];
274 printf("dosym() : Cannot get object file segment size : %s\n",
279 type = hptr->h_type; // Update type with global type
281 if (type == 0x03000000)
282 type = 0x02000000; // Reset external flag if absolute
284 // If the global/external has a value then update that vaule in accordance with the
285 // segment sizes of the object file it originates from
288 switch (hptr->h_type & 0x0E000000)
290 case 0x02000000: // Absolute value
291 case 0x04000000: // TEXT segment
292 value = hptr->h_value;
294 case 0x06000000: // DATA segment
295 value = hptr->h_value - (hptr->h_ofile->o_header.tsize);
297 case 0x08000000: // BSS segment
298 value = hptr->h_value
299 - (hptr->h_ofile->o_header.tsize + hptr->h_ofile->o_header.dsize);
305 // Process and update the value dependant on whether the symbol is a debug symbol or not
306 if (type & 0xF0000000)
308 // Set the correct debug symbol base address (TEXT segment)
311 for(j=0; (unsigned)j<dosymi; j++)
312 dbgsymbase += obj_segsize[j][0];
314 switch (type & 0xFF000000)
317 value = tval + dbgsymbase;
322 value = tval + dbgsymbase + value;
327 putlong(symptr + 8, value);
330 { // NON-DEBUG SYMBOL
331 // Now make modifications to the symbol value, local or global, based on the segment sizes
332 // of the object file currently being processed.
333 switch (type & T_SEG)
335 case 0x02000000: // Absolute value
337 case T_TEXT: // TEXT segment
338 if (type & 0x01000000)
339 value = tbase + tsegoffset + value;
341 value = tbase + tsegoffset + value;
343 putlong(symptr + 8, value);
345 case T_DATA: // DATA segment
346 if (type & 0x01000000)
347 value = dbase + dsegoffset + value;
349 value = dbase + dsegoffset + (value - ofile->o_header.tsize);
351 putlong(symptr + 8, value);
353 case T_BSS: // BSS segment
354 if (type & 0x01000000)
355 value = bbase + bsegoffset + value;
357 value = bbase + bsegoffset
358 +(value - (ofile->o_header.tsize + ofile->o_header.dsize));
360 putlong(symptr + 8, value);
367 // Add to output symbol table
368 if (lflag || !islocal(type))
370 if (islocal(type) || isglobal(type))
372 if ((index = ost_add(symend + index, type, value)) == -1)
377 // Belongs in OST, but don't look it up yet
383 dosymi++; // Increment dosym() processsing
389 // Free Up Hash Records
394 struct HREC * htemp, * hptr;
396 for(i=0; i<NBUCKETS; i++)
402 htemp = hptr->h_next;
411 // Add all Global and External Symbols to the Output Symbol Table
415 struct HREC * hptr; // Hash record pointer
418 for(i=0; i<NBUCKETS; i++)
420 for(hptr=htable[i]; hptr!=NULL; hptr=hptr->h_next)
422 if (iscommon(hptr->h_type))
424 if (hptr->h_type == 0x03000000)
425 hptr->h_type = 0x02000000; // Absolutes can't be externals
427 if (ost_add(hptr->h_sym, hptr->h_type, hptr->h_value) == -1)
438 // Add a Symbol's Name, Type, and Value to the OST.
439 // Return the Index of the Symbol in OST, or -1 for Error.
441 int ost_add(char * name, int type, long value)
443 int ost_offset_p, ost_offset_e = 0; // OST table offsets for position calcs
444 int slen = 0; // Symbol string length
445 int ostresult; // OST index result
449 // If the OST or OST String Table has not been initialised then do so
452 if ((ost = malloc(OST_BLOCK)) == NULL)
454 printf("OST memory allocation error (stringtable).\n");
458 ost_ptr = ost; // Set OST start pointer
459 ost_end = ost + OST_BLOCK; // Set OST end pointer
461 if ((oststr = malloc(OST_BLOCK)) == NULL)
463 printf("OST memory allocation error (string).\n");
467 putlong(oststr, 0x00000004); // Just null long for now
468 oststr_ptr = oststr + 4; // Skip size of str table long (incl null long)
469 putlong(oststr_ptr, 0x00000000); // Null terminating long
470 oststr_end = oststr + OST_BLOCK;
474 // If next symbol record exceeds current allocation then expand symbol table.
475 ost_offset_p = (ost_ptr - ost);
476 ost_offset_e = (ost_end - ost);
479 if ((ost_ptr + 12) > ost_end)
481 if ((ost = realloc(ost, (unsigned)(ost_end + OST_BLOCK))) == NULL)
483 printf("OST memory reallocation error.\n");
487 ost_ptr = ost + ost_offset_p;
488 ost_end = (ost + ost_offset_e) + OST_BLOCK;
491 ost_offset_p = (oststr_ptr - oststr);
492 ost_offset_e = (oststr_end - oststr);
494 if ((oststr_ptr + (slen + 1 + 4)) > oststr_end)
496 if ((oststr = realloc(oststr, (unsigned)(oststr_end + OST_BLOCK))) == NULL)
498 printf("OSTSTR memory reallocation error.\n");
502 oststr_ptr = oststr + ost_offset_p;
503 oststr_end = (oststr + ost_offset_e) + OST_BLOCK;
507 // If this is a debug symbol and the include debug symbol flag (-g) is not
508 // set then do nothing
509 if ((type & 0xF0000000) && !gflag)
515 ostresult = ost_lookup(name); // Get symbol index in OST
517 // If the symbol is in the output symbol table and the bflag is set
518 // (don't remove multiply defined locals) and this is not an
519 // external/global symbol *** OR *** the symbol is not in the output
520 // symbol table then add it.
521 if (((ostresult != -1) && bflag && !(type & 0x01000000))
522 || ((ostresult != -1) && gflag && (type & 0xF0000000)) || (ostresult == -1))
524 if ((type & 0xF0000000) == 0x40000000)
525 putlong(ost_ptr, 0x00000000); // Zero string table offset for dbg line
527 putlong(ost_ptr, (oststr_ptr - oststr)); // String table offset of symbol string
529 putlong(ost_ptr + 4, type );
530 putlong(ost_ptr + 8, value);
533 // If the symbol type is anything but a debug line information
534 // symbol then write the symbol string to the string table
535 if ((type & 0xF0000000) != 0x40000000)
537 strcpy(oststr_ptr, name); // Put symbol name in string table
538 *(oststr_ptr + slen) = '\0'; // Add null terminating character
539 oststr_ptr += (slen + 1);
540 putlong(oststr_ptr, 0x00000000); // Null terminating long
541 putlong(oststr, (oststr_ptr - oststr)); // Update size of string table
544 return ost_index++; // Return OST index
548 // not sure about this as it could affect return indices. needed to stop return error.
554 // Return the Index of a Symbol in the Output Symbol Table
556 int ost_lookup(char * sym)
559 int stro = 4; // Offset in string table
561 for(i=0; i<ost_index; i++)
563 if (strcmp(oststr + stro, sym) == 0)
566 stro += strlen(oststr + stro) + 1;
574 // Add Unresolved Externs to the Output Symbol Table
576 int dounresolved(void)
578 struct HREC * hptr, * htemp; // Hash record pointers
579 hptr = unresolved; // Point to unresolved symbols list
581 // While unresolved list is valid
584 if (ost_add(hptr->h_sym, T_EXT, 0L) == -1)
587 //printf("dounresolved(): added %s\n",hptr->h_sym);
588 htemp = hptr->h_next; // Temporarily get ptr to next record
589 free(hptr); // Free current record
590 hptr = htemp; // Make next record ptr, current
593 unresolved = NULL; // Zero unresolved record list
599 // Update Object File TEXT and DATA Segments Based on Relocation Records. Take
600 // in an OFILE header and flag (T_TEXT, T_DATA) to process. Return (0) is
601 // successful or non-zero (1) if failed.
603 int reloc_segment(struct OFILE * ofile, int flag)
605 char * symtab; // Start of symbol table
606 char * symbols; // Start of symbols
607 char * sptr; // Start of segment data
608 char * rptr; // Start of segment relocation records
609 unsigned symidx; // Offset to symbol
610 unsigned addr; // Relocation address
611 unsigned rflg; // Relocation flags
612 unsigned olddata; // Old segment data at reloc address
613 unsigned newdata = 0; // New segment data at reloc address
614 unsigned pad; // Temporary to calculate phrase padding
616 char sym[SYMLEN]; // String for symbol name/hash search
617 int ssidx; // Segment size table index
618 unsigned glblreloc; // Global relocation flag
619 unsigned absreloc; // Absolute relocation flag
620 unsigned relreloc; // Relative relocation flag
621 unsigned swcond; // Switch statement condition
622 unsigned relocsize; // Relocation record size
624 // If there is no TEXT relocation data for the selected object file segment
625 // then update the COF TEXT segment offset allowing for the phrase padding
626 if ((flag == T_TEXT) && !ofile->o_header.absrel.reloc.tsize)
628 // TEXT segment size plus padding
629 pad = ((ofile->o_header.tsize+secalign) & ~secalign);
630 textoffset += (ofile->o_header.tsize + (pad - ofile->o_header.tsize));
633 printf("reloc_segment(%s, TEXT) : No Relocation Data\n", ofile->o_name);
638 // If there is no DATA relocation data for the selected object file segment
639 // then update the COF DATA and BSS segment offsets allowing for the phrase
641 if ((flag == T_DATA) && !ofile->o_header.absrel.reloc.dsize)
643 // DATA segment size plus padding
644 pad = ((ofile->o_header.dsize + secalign) & ~secalign);
645 dataoffset += (ofile->o_header.dsize + (pad - ofile->o_header.dsize));
646 // BSS segment size plus padding
647 pad = ((ofile->o_header.bsize + secalign) & ~secalign);
648 bssoffset += (ofile->o_header.bsize + (pad - ofile->o_header.bsize));
651 printf("reloc_segment(%s, DATA) : No Relocation Data\n", ofile->o_name);
656 // Verbose mode information
659 printf("reloc_segment(%s, %s) : Processing Relocation Data\n",
660 ofile->o_name, flag == T_DATA ? "DATA" : "TEXT");
663 // Obtain pointer to start of symbol table
664 symtab = (ofile->o_image + 32 + ofile->o_header.tsize + ofile->o_header.dsize
665 + ofile->o_header.absrel.reloc.tsize + ofile->o_header.absrel.reloc.dsize);
667 // Obtain pointer to start of symbols
668 symbols = symtab + ofile->o_header.ssize;
670 // Obtain pointer to start of TEXT segment
671 sptr = ofile->o_image + 32;
673 // Obtain pointer to start of TEXT relocation records
674 rptr = sptr + (ofile->o_header.tsize + ofile->o_header.dsize);
676 relocsize = ofile->o_header.absrel.reloc.tsize;
680 printf("RELOCSIZE :: %d Records = %d\n",relocsize,relocsize/8);
683 // Update pointers if DATA relocation records are being processed
686 sptr += ofile->o_header.tsize; // Start of DATA segment
687 rptr += ofile->o_header.absrel.reloc.tsize; // Start of DATA relocation records
688 relocsize = ofile->o_header.absrel.reloc.dsize;
691 // Process each relocation record for the TEXT segment
692 for(i=0; i<(int)relocsize; i+=8)
694 // Obtain both the relocation address and the relocation flags from the
696 addr = getlong(rptr);
697 rflg = getlong(rptr + 4);
698 glblreloc = (rflg & 0x00000010 ? 1 : 0); // Set global relocation flag
699 absreloc = (rflg & 0x00000040 ? 1 : 0); // Set absolute relocation flag
700 relreloc = (rflg & 0x000000A0 ? 1 : 0); // Set relative relocation flag
702 // Additional processing required for global relocations
705 // Obtain the string table index for the relocation symbol, look
706 // for it in the globals hash table to obtain information on that
707 // symbol. For the hash calculation to work correctly it must be
708 // placed in a 'clean' string before looking it up.
709 symidx = getlong(symtab + ((rflg >> 8) * 12));
710 memset(sym, 0, SYMLEN);
711 strcpy(sym, symbols + symidx);
712 olddata = newdata = 0; // Initialise old and new segment data
713 ssidx = ost_lookup(sym);
714 newdata = getlong(ost + ((ssidx - 1) * 12) + 8);
717 // Obtain the existing long word segment data and flip words if the
718 // relocation flags indicate it relates to a RISC MOVEI instruction
719 olddata = getlong(sptr + addr);
722 olddata = _SWAPWORD(olddata);
724 // Process record dependant on segment it relates to; TEXT, DATA or
725 // BSS. Construct a new relocated segment long word based on the
726 // required segment base address, the segment data offset in the
727 // resulting COF file and the offsets from the incoming object file.
728 //swcond = glblreloc ? ((hptr->h_type & 0x0E000000) >> 16) : (rflg & 0xFFFFFF00);
729 swcond = (rflg & 0xFFFFFF00);
735 case 0x00000200: // Absolute Value
737 case 0x00000400: // TEXT segment relocation record
738 //AARRRGGGGHHHHH! does the else belong to the 1st 'if' or the 2nd?
739 // can we trust the indention to tell the truth here???
740 // Braces were not here, so if something breaks, try pairing the else to the 1st 'if'...
743 if (flag == T_TEXT) // Is this a TEXT section record?
744 newdata = tbase + textoffset + olddata;
746 newdata = tbase + dataoffset + olddata; // Nope, must be DATA section
750 case 0x00000600: // DATA segment relocation record
752 newdata = dbase + dataoffset + (olddata - ofile->o_header.tsize);
755 case 0x00000800: // BSS segment relocation record
757 newdata = bbase + bssoffset
758 + (olddata - (ofile->o_header.tsize + ofile->o_header.dsize));
769 // Set absolute (long) or relative (word) address of symbol
772 // Flip the new long word segment data if the relocation record
773 // indicated a RISC MOVEI instruction and place the resulting data
774 // back in the COF segment
776 newdata = _SWAPWORD(newdata);
778 putlong(sptr + addr, newdata);
782 putword(sptr + addr, newdata - tbase - addr - ofile->o_tbase);
785 // Shamus: Let's output some info to aid in debugging this crap
792 sprintf(ssiString, " [ssi:%i]", ssidx);
794 printf("reloc_segment($%08X): %s, $%08X: $%08X => $%08X%s\n", rflg, (glblreloc ? sym : "(LOCAL)"), addr, olddata, getlong(sptr + addr), ssiString);
797 rptr += 8; // Point to the next relocation record
800 // Update the COF segment offset allowing for the phrase padding.
803 // TEXT segment plus padding
804 pad = ((ofile->o_header.tsize + secalign) & ~secalign);
805 textoffset += (ofile->o_header.tsize + (pad - ofile->o_header.tsize));
809 // DATA segment plus padding
810 pad = ((ofile->o_header.dsize + secalign) & ~secalign);
811 dataoffset += (ofile->o_header.dsize + (pad - ofile->o_header.dsize));
812 // BSS segment plus padding
813 pad = ((ofile->o_header.bsize + secalign) & ~secalign);
814 bssoffset += (ofile->o_header.bsize + (pad - ofile->o_header.bsize));
817 // Return value, should always be zero
823 // Add a path character to the end of string 's' if it doesn't already end with
824 // one. The last occurrance of '/' or '\\' in the string is assumed to be the
827 void pathadd(char * s)
829 // And hope to God that there's enough space in the buffer...
834 if (*s == '/' || *s == '\\')
851 // Try to open "name", "name.o", "${libdir}name", "${libdir}name.o". Return the
852 // handle of the file successfully opened. p_name is updated to point to a
853 // malloc()'ed string which is the name which actually got opened. p_name will
854 // return unchanged if the file can't be found.
856 int tryopen(char ** p_name)
858 char * name = *p_name; // Filename
859 char * tmpbuf, * lastdot; // Buffer and 'dot' pointers
860 int fd, hasdot; // File descriptor and 'has dot' flag
862 // Note that libdir will be an empty string if there is none specified
863 if ((tmpbuf = malloc((long)strlen(name) + strlen(libdir) + 3)) == NULL)
865 printf("tryopen() : out of memory\n");
869 strcpy(tmpbuf, name);
870 hasdot = ((lastdot = strrchr(tmpbuf, '.')) > strrchr(tmpbuf, '/'))
871 && (lastdot > strrchr(tmpbuf, '\\'));
873 if ((fd = open(tmpbuf, _OPEN_FLAGS)) >= 0)
874 goto ok; // Try to open file as passed first
878 strcat(tmpbuf, ".o"); // Try to open file with '.o' added
880 if ((fd = open(tmpbuf, _OPEN_FLAGS)) >= 0)
884 // Try the libdir only if the name isn't already anchored
885 if (*name != '/' && *name != '\\' && !strchr(name, ':'))
887 strcpy(tmpbuf,libdir);
888 // Add a trailing path char if there isn't one already
890 strcat(tmpbuf, name);
892 if ((fd = open(tmpbuf, _OPEN_FLAGS)) >= 0)
897 strcat(tmpbuf, ".o");
899 if ((fd = open(tmpbuf, _OPEN_FLAGS)) >= 0)
904 return -1; // Couldn't open file at all
906 // What more Atari label use - sigh!!!
908 if ((tmpbuf = realloc(tmpbuf, (long)strlen(tmpbuf) + 1)) == NULL)
910 printf("tryopen() : out of memory\n");
915 return fd; // Return file descriptor
920 // Archive File Use, Needs to be Removed
922 void put_name(struct OFILE * p)
924 int flag = *(p->o_arname);
925 printf("%s%s%s", (flag ? (char *)(p->o_arname) : ""), (flag ? ":" : ""), p->o_name);
930 // Collect file names and handles in a buffer so there is less disk activity.
931 // Call dofile with flag FALSE for normal object files and archives.
932 // Call it with flag TRUE and a symbol name for include files (-i).
934 int dofile(char * fname, int flag, char * sym)
936 int fd; // File descriptor
937 int temp; // Temporary storage
939 // Verbose information
942 printf("dofile() : `%s' %s", fname, flag ? "INCLUDE" : "NORMAL");
945 printf(" symbol %s", sym);
950 // Reached maximum file handles
957 // Attempt to open input file
958 if ((fd = tryopen(&fname)) < 0)
960 printf("Cannot find input module %s\n", fname);
964 // The file is open; save its info in the handle and name arrays
966 name[hd] = fname; // This is the name from tryopen()
972 temp = strlen(sym); // Get symbol length
974 // 100 chars is max length of a symbol
981 // Malloc enough space for two symbols, then build the second one. Second one may be one
982 // character longer than first
983 if ((hsym1[hd] = malloc((long)temp + 1)) == NULL
984 || (hsym2[hd] = malloc((long)temp + 2)) == NULL)
986 printf("dofile() : out of memory for include-file symbols\n");
990 strcpy(hsym1[hd], sym);
991 strcpy(hsym2[hd], sym);
997 printf("Last char of %s is already 'x': choose another name\n", sym);
1001 hsym2[hd][99] = 'x';
1005 hsym2[hd][temp] = 'x';
1006 hsym2[hd][temp+1] = '\0';
1010 hd++; // Increment next handle index
1011 return 0; // No problems
1016 // Pad TEXT or DATA Segment to the Requested Boundary
1018 int segmentpad(FILE * fd, long segsize, int value)
1020 long padsize; // Number of pad bytes needed
1021 int i; // Good 'ol iterator
1022 char padarray[32]; // Array of padding bytes
1023 char * padptr; // Pointer to array
1025 // Determine the number of padding bytes that are needed
1026 padsize = (segsize + secalign) & ~secalign;
1027 padsize = padsize - segsize;
1029 // Fill pad array if padding is required
1036 putword(padptr, value);
1040 symoffset += padsize;
1042 if (fwrite(padarray, padsize, 1, fd) != 1) // Write padding bytes
1046 return 0; // All done
1051 // Write the Output File
1053 int write_ofile(struct OHEADER * header)
1055 FILE * fd; // File descriptor
1056 unsigned osize; // Object segment size
1057 struct OFILE * otemp; // Object file pointer
1058 int i, j; // Iterators
1059 char himage[0x168]; // Header image (COF = 0xA8)
1060 unsigned tsoff, dsoff, bsoff; // Segment offset values
1061 unsigned index, type, value; // Symbol table index, type and value
1062 short abstype; // ABS symbol type
1063 char symbol[14]; // Symbol record for ABS files
1064 int slen; // Symbol string length
1066 symoffset = 0; // Initialise symbol offset
1068 // Add correct output extension if none
1069 if (strchr(ofile, '.') == NULL)
1072 strcat(ofile, ".cof"); // COF files
1073 else if (aflag && !cflag)
1074 strcat(ofile, ".abs"); // ABS files
1076 strcat(ofile, ".o"); // Object files (partial linking etc)
1079 fd = fopen(ofile, "wb"); // Attempt to open output file
1083 printf("Can't open output file %s\n", ofile); // Error opening output file
1087 // Build the output file header
1088 // Absolute (COF) header
1091 tsoff = dsoff = bsoff = 0xA8; // Initialises segment offsets
1093 // Process each object file segment size to obtain a cumulative segment size for both
1094 // the TEXT and DATA segments
1095 for(i=0; i<(int)obj_index; i++)
1097 dsoff += obj_segsize[i][0]; // Adding TEXT segment sizes
1098 bsoff += obj_segsize[i][0] + obj_segsize[i][1]; // Adding TEXT and DATA segment sizes
1101 // Currently this only builds a COF absolute file. Conditionals and additional code will
1102 // need to be added for ABS and partial linking.
1104 // Build the COF_HDR
1105 putword(himage + 0, 0x0150 ); // Magic Number (0x0150)
1106 putword(himage + 2, 0x0003 ); // Sections Number (3)
1107 putlong(himage + 4, 0x00000000 ); // Date (0L)
1108 putlong(himage + 8, dsoff + header->dsize); // Offset to Symbols Section
1109 putlong(himage + 12, ost_index); // Number of Symbols
1110 putword(himage + 16, 0x001C ); // Size of RUN_HDR (0x1C)
1111 putword(himage + 18, 0x0003 ); // Executable Flags (3)
1113 // Build the RUN_HDR
1114 putlong(himage + 20, 0x00000107 ); // Magic/vstamp
1115 putlong(himage + 24, header->tsize ); // TEXT size in bytes
1116 putlong(himage + 28, header->dsize ); // DATA size in bytes
1117 putlong(himage + 32, header->bsize ); // BSS size in bytes
1118 putlong(himage + 36, tbase ); // Start of executable, normally @TEXT
1119 putlong(himage + 40, tbase ); // @TEXT
1120 putlong(himage + 44, dbase ); // @DATA
1122 // Build the TEXT SEC_HDR
1123 putlong(himage + 48, 0x2E746578 );
1124 putlong(himage + 52, 0x74000000 ); // ".text"
1125 putlong(himage + 56, tbase ); // TEXT START
1126 putlong(himage + 60, tbase ); // TEXT START
1127 putlong(himage + 64, header->tsize ); // TEXT size in bytes
1128 putlong(himage + 68, tsoff ); // Offset to section data in file
1129 putlong(himage + 72, 0x00000000 ); // Offset to section reloc in file (0L)
1130 putlong(himage + 76, 0x00000000 ); // Offset to debug lines structures (0L)
1131 putlong(himage + 80, 0x00000000 ); // Nreloc/nlnno (0L)
1132 putlong(himage + 84, 0x00000020 ); // SEC_FLAGS: STYP_TEXT
1134 // Build the DATA SEC_HDR
1135 putlong(himage + 88, 0x2E646174 );
1136 putlong(himage + 92, 0x61000000 ); // ".data"
1137 putlong(himage + 96, dbase ); // DATA START
1138 putlong(himage + 100, dbase ); // DATA START
1139 putlong(himage + 104, header->dsize ); // DATA size in bytes
1140 putlong(himage + 108, dsoff ); // Offset to section data in file
1141 putlong(himage + 112, 0x00000000 ); // Offset to section reloc in file (0L)
1142 putlong(himage + 116, 0x00000000 ); // Offset to debugging lines structures (0L)
1143 putlong(himage + 120, 0x00000000 ); // Nreloc/nlnno (0L)
1144 putlong(himage + 124, 0x00000040 ); // SEC_FLAGS: STYP_DATA
1146 // Build the BSS SEC_HDR
1147 putlong(himage + 128, 0x2E627373 );
1148 putlong(himage + 132, 0x00000000 ); // ".bss"
1149 putlong(himage + 136, bbase ); // BSS START
1150 putlong(himage + 140, bbase ); // BSS START
1151 putlong(himage + 144, header->bsize ); // BSS size in bytes
1152 putlong(himage + 148, bsoff ); // Offset to section data in file
1153 putlong(himage + 152, 0x00000000 ); // Offset to section reloc in file (0L)
1154 putlong(himage + 156, 0x00000000 ); // Offset to debugging lines structures (0L)
1155 putlong(himage + 160, 0x00000000 ); // Nreloc/nlnno (0L)
1156 putlong(himage + 164, 0x00000080 ); // SEC_FLAGS: STYP_BSS
1158 symoffset = 168; // Update symbol offset
1160 // Absolute (ABS) header
1163 // Build the ABS header
1164 putword(himage + 0, 0x601B ); // Magic Number (0x601B)
1165 putlong(himage + 2, header->tsize ); // TEXT segment size
1166 putlong(himage + 6, header->dsize ); // DATA segment size
1167 putlong(himage + 10, header->bsize ); // BSS segment size
1168 putlong(himage + 14, ost_index * 14 ); // Symbol table size (?)
1169 putlong(himage + 18, 0x00000000 ); //
1170 putlong(himage + 22, tbase ); // TEXT base address
1171 putword(himage + 26, 0xFFFF ); // Flags (?)
1172 putlong(himage + 28, dbase ); // DATA base address
1173 putlong(himage + 32, bbase ); // BSS base address
1175 symoffset = 36; // Update symbol offset
1178 // Write the header, but not if noheaderflag
1179 // Absolute (ABS) header
1183 if (fwrite(himage, 36, 1, fd) != 1)
1186 // Absolute (COF) header
1189 if (fwrite(himage, 168, 1, fd) != 1)
1193 // Write the TEXT segment of each object file
1194 for(otemp=olist; otemp!=NULL; otemp=otemp->o_next)
1196 osize = otemp->o_header.tsize;
1198 // Write only if segment has size
1202 printf("Writing TEXT Segment of %s\n", otemp->o_name);
1204 if (fwrite(otemp->o_image + 32, osize, 1, fd) != 1)
1207 // Pad to required alignment boundary
1208 if (segmentpad(fd, osize, 0x0000))
1215 // Write the DATA segment of each object file
1216 for(otemp = olist; otemp != NULL; otemp = otemp->o_next)
1218 osize = otemp->o_header.dsize;
1220 // Write only if the segment has size
1224 printf("Writing DATA Segment of %s\n", otemp->o_name);
1226 if (fwrite((otemp->o_image + 32 + otemp->o_header.tsize), osize, 1, fd) != 1)
1229 // Pad to required alignment boundary
1230 if (segmentpad(fd, osize, 0))
1239 // Write the symbols table and string table
1240 // Absolute (COF) symbol/string table
1245 if (fwrite(ost, (ost_ptr - ost), 1, fd) != 1) goto werror;
1246 if (fwrite(oststr, (oststr_ptr - oststr), 1, fd) != 1) goto werror;
1249 // Absolute (ABS) symbol/string table
1252 // The symbol and string table have been created as part of the dosym() function and the
1253 // output symbol and string tables are in COF format. For an ABS file we need to process
1254 // through this to create the 14 character long combined symbol and string table.
1255 // Format of symbol table in ABS: AAAAAAAATTVVVV, where (A)=STRING, (T)=TYPE & (V)=VALUE
1257 for(i=0; i<ost_index; i++)
1259 memset(symbol, 0, 14); // Initialise symbol record
1260 abstype = 0; // Initialise ABS symbol type
1261 slen = 0; // Initialise symbol string length
1262 index = getlong(ost + (i * 12)); // Get symbol index
1263 type = getlong((ost + (i * 12)) + 4); // Get symbol type
1265 if (type & 0xF0000000)
1266 continue; // Not doing debug symbols
1268 value = getlong((ost + (i * 12)) + 8); // Get symbol value
1269 slen = strlen(oststr + index);
1271 // Get symbol string (maximum 8 chars)
1275 *(symbol + j) = *(oststr + index + j);
1279 for(j=0; j<slen; j++)
1280 *(symbol + j) = *(oststr + index + j);
1283 // Modify to ABS symbol type
1286 case 0x02000000: abstype = (short)ABST_DEFINED; break;
1287 case 0x04000000: abstype = (short)ABST_DEFINED | ABST_TEXT; break;
1288 case 0x05000000: abstype = (short)ABST_DEFINED | ABST_GLOBAL | ABST_TEXT; break;
1289 case 0x06000000: abstype = (short)ABST_DEFINED | ABST_DATA; break;
1290 case 0x07000000: abstype = (short)ABST_DEFINED | ABST_GLOBAL | ABST_DATA; break;
1291 case 0x08000000: abstype = (short)ABST_DEFINED | ABST_BSS; break;
1292 case 0x09000000: abstype = (short)ABST_DEFINED | ABST_GLOBAL | ABST_BSS; break;
1294 printf("write_ofile: abs, cannot determine symbol type\n");
1299 putword(symbol + 8, abstype); // Write back new ABS type
1300 putlong(symbol + 10, value); // Write back value
1302 if (fwrite(symbol, 14, 1, fd) != 1) goto werror; // Write symbol record
1310 printf("Close error on output file %s\n",ofile);
1316 werror: // OMG! Why did Atari use these :)
1317 printf("Write error on output file %s\n", ofile);
1318 fclose(fd); // Try to close output file anyway
1324 // Display the Symbol Load Map
1326 int write_map(struct OHEADER * header)
1328 unsigned i, o; // Inner and outer loop iterators
1329 unsigned c; // Column number
1330 unsigned index; // Symbol string index
1331 unsigned type; // Symbol type
1332 unsigned value; // Symbol value
1333 char * symbol; // Symbol string value
1336 return 0; // Return if no symbols to map
1338 printf("LOAD MAP\n\n");
1340 // Outer loop for each of the symbol areas to map out;
1341 // 0 = NON-RELOCATABLE SYMBOLS
1342 // 1 = TEXT-SEGMENT RELOCATABLE SYMBOLS
1343 // 2 = DATA-SEGMENT RELOCATABLE SYMBOLS
1344 // 3 = BSS-SEGMENT RELOCATABLE SYMBOLS
1347 // Display the correct map header for the symbols being processed
1350 case 0: printf("NON-RELOCATABLE SYMBOLS\n\n"); break;
1351 case 1: printf("TEXT-SEGMENT RELOCATABLE SYMBOLS\n\n"); break;
1352 case 2: printf("DATA-SEGMENT RELOCATABLE SYMBOLS\n\n"); break;
1353 case 3: printf("BSS-SEGMENT RELOCATABLE SYMBOLS\n\n"); break;
1356 c = 0; // Initialise column number
1358 // Inner loop to process each record in the symbol table
1359 for(i=0; i<(unsigned)ost_index; i++)
1361 index = getlong(ost + (i * 12)); // Get symbol string index
1362 type = getlong(ost + (i * 12) + 4); // Get symbol type
1363 value = getlong(ost + (i * 12) + 8); // Get symbol value
1364 symbol = oststr + index; // Get symbol string
1366 // Display only three columns
1373 // If local symbols not included and the type is local then go to next symbol record
1374 if (!lflag & !(type & 0x01000000))
1377 // Output each symbol to the display, dependant on type
1380 case 0: // Non-relocatable symbols
1381 if (type == 0x02000000 || type == 0x03000000)
1383 printf("%-8s %c %08X ", symbol, (type & 0x01000000) ? 'G' : 'L', value);
1388 case 1: // TEXT segment relocatable symbols
1389 if (type == 0x04000000 || type == 0x05000000)
1391 printf("%-8s %c %08X ", symbol, (type & 0x01000000) ? 'G' : 'L', value);
1396 case 2: // DATA segment relocatble symbols
1397 if (type == 0x06000000 || type == 0x07000000)
1399 printf("%-8s %c %08X ", symbol, (type & 0x01000000) ? 'G' : 'L', value);
1404 case 3: // BSS segment relocatable symbols
1405 if (type == 0x08000000 || type == 0x09000000)
1407 printf("%-8s %c %08X ", symbol, (type & 0x01000000) ? 'G' : 'L', value);
1418 return 0; // All done
1423 // Convert ASCII to Hexadecimal
1425 //int atolx(char * string, long * value)
1426 int atolx(char * string, int * value)
1430 while (isxdigit(*string))
1432 if (isdigit(*string))
1434 *value = (*value << 4) + (*string++ - '0');
1438 if (isupper(*string))
1439 *string = tolower(*string);
1441 *value = (*value << 4) + ((*string++ - 'a') + 10);
1445 if (*string != '\0')
1447 printf("Invalid hexadecimal value");
1456 // Stuff the (long) value of a string into the value argument. RETURNS TRUE if
1457 // the string doesn't parse. Parses only as a hex string.
1459 //int getval(char * string, long * value)
1460 int getval(char * string, int * value)
1462 return atolx(string, value);
1467 // Create one big .o file from the images already in memory, returning a
1468 // pointer to an OHEADER. Note that the oheader is just the header for the
1469 // output (plus some other information). The text, data, and fixups are all
1470 // still in the ofile images hanging off the global `olist'.
1472 struct OHEADER * make_ofile()
1474 unsigned tptr, dptr, bptr; // Bases in runtime model
1475 int ret = 0; // Return value
1476 struct OFILE * otemp, * oprev, * ohold; // Object file list pointers
1477 struct OHEADER * header; // Output header pointer
1479 textsize = datasize = bsssize = 0; // Initialise cumulative segment sizes
1481 // For each object file, accumulate the sizes of the segments but remove those
1482 // object files which are unused
1483 oprev = NULL; // Init previous obj file list ptr
1484 otemp = olist; // Set temp pointer to object file list
1486 while (otemp != NULL)
1489 if (!(otemp->o_flags & O_ARCHIVE))
1491 if ((otemp->o_flags & O_USED) == 0)
1495 printf("Unused object file ");
1497 printf(" discarded.\n");
1502 olist = otemp->o_next;
1506 oprev -> o_next = otemp->o_next;
1510 free(ohold->o_image);
1515 // Increment total of segment sizes ensuring requested alignment
1516 textsize += (otemp->o_header.tsize + secalign) & ~secalign;
1517 datasize += (otemp->o_header.dsize + secalign) & ~secalign;
1518 bsssize += (otemp->o_header.bsize + secalign) & ~secalign;
1523 otemp = otemp->o_next; // Go to next object file list pointer
1526 // Update base addresses and create symbols _TEXT_E, _DATA_E and _BSS_E
1528 ost_add("_TEXT_E", 0x05000000, tval + textsize);
1532 // DATA follows TEXT
1533 dbase = tval + textsize;
1534 ost_add("_DATA_E", 0x07000000, tval + textsize + datasize);
1539 bbase = tval + textsize + datasize;
1540 ost_add("_BSS_E", 0x09000000, tval + textsize + datasize + bsssize);
1544 // BSS is independant of DATA
1546 ost_add("_BSS_E", 0x09000000, bval + bsssize);
1551 // DATA is independant of TEXT
1553 ost_add("_DATA_E", 0x07000000, dval + datasize);
1558 bbase = dval + datasize;
1559 ost_add("_BSS_E", 0x09000000, dval + datasize + bsssize);
1563 // BSS is independant of DATA
1565 ost_add("_BSS_E", 0x09000000, bval + bsssize);
1569 // Place each unresolved symbol in the output symbol table
1573 tptr = 0; // Initialise base addresses
1577 // For each file, relocate its symbols and add them to the output symbol table
1581 while (otemp != NULL)
1583 otemp->o_tbase = tptr;
1585 // Do rest only for non-ARCHIVE markers
1586 if (!(otemp->o_flags & O_ARCHIVE))
1588 otemp->o_dbase = dptr;
1589 otemp->o_bbase = bptr;
1590 tptr += (otemp->o_header.tsize + secalign) & ~secalign;
1591 dptr += (otemp->o_header.dsize + secalign) & ~secalign;
1592 bptr += (otemp->o_header.bsize + secalign) & ~secalign;
1595 // For each symbol, (conditionally) add it to the ost
1596 // For ARCHIVE markers, this adds the symbol for the file & returns
1600 if (otemp->o_flags & O_ARCHIVE)
1602 // Now that the archive is marked, remove it from list
1604 olist = otemp->o_next;
1606 oprev->o_next = otemp->o_next;
1610 if (ohold->o_image) free(ohold->o_image);
1618 otemp = otemp->o_next;
1621 // Places all the externs, globals etc into the output symbol table
1622 if (docommon() == -1)
1625 // Create a new output file header
1626 if ((header = new_oheader()) == NULL)
1628 printf("make_ofile: out of memory!\n");
1632 // Fill in the output header. Does not match the actual output but values
1633 // used as reference
1634 header->magic = 0x0150; // COF magic number
1635 header->tsize = textsize; // TEXT segment size
1636 header->dsize = datasize; // DATA segment size
1637 header->bsize = bsssize; // BSS segment size
1638 header->ssize = (ost_ptr - ost); // Symbol table size
1639 header->ostbase = ost; // Output symbol table base address
1641 // For each object file, relocate its TEXT and DATA segments. OR the result
1642 // into ret so all files get moved (and errors reported) before returning
1643 // with the error condition
1644 for(otemp=olist; otemp!=NULL; otemp=otemp->o_next)
1646 if (!(otemp->o_flags & O_ARCHIVE))
1648 ret |= reloc_segment(otemp, T_TEXT); // TEXT segment relocations
1649 ret |= reloc_segment(otemp, T_DATA); // DATA segment relocations
1653 hash_free(); // Done with global symbol hash tables
1655 return (ret ? (unsigned)NULL : header);
1660 // Add Symbol to Hash List
1662 int add_to_hlist(struct HREC ** hptr, char * sym, struct OFILE * ofile, long value, int type)
1664 struct HREC * htemp; // Temporary hash record pointer
1667 // Attempt to allocate new hash record
1668 if ((htemp = new_hrec()) == NULL)
1670 printf("Out of memory\n");
1674 // Shamus: Moar testing...
1677 printf("add_to_hlist(): hptr=$%08X, sym=\"%s\", ofile=$%08X, value=%li, type=%i", (unsigned int)hptr, sym, (unsigned int)ofile, value, type);
1680 for(i=0; i<SYMLEN; i++)
1681 htemp->h_sym[i] = '\0';
1683 strcpy(htemp->h_sym, sym); // Populate hash record
1684 htemp->h_ofile = ofile;
1685 htemp->h_value = value;
1686 htemp->h_type = type;
1688 htemp->h_next = *hptr; // Update hash record pointers
1696 // Add Symbol to the Unresolved Symbols Hash Table
1698 add_unresolved(char * sym, struct OFILE * ofile)
1701 printf("add_unresolved(%s,%s)\n", sym, ofile->o_name);
1703 return add_to_hlist(&unresolved, sym, ofile, 0L, 0);
1708 // Generate and Return Hash Value
1710 int dohash(char * s)
1712 int i = (s[0]+s[1]+s[2]+s[3]+s[4]+s[5]+s[6]+s[7] +s[8]+s[9]+s[10]+s[11]+s[12]+s[13]+s[14]) % NBUCKETS;
1718 // Lookup a Symbol in the Hash Table
1720 struct HREC * lookup(char * sym)
1722 struct HREC * hptr = htable[dohash(sym)]; // Hash index to record based on sym
1723 char symbol[SYMLEN]; // Temporary symbol storage
1725 memset(symbol, 0, SYMLEN); // Clean string for comparison
1726 strcpy(symbol, sym);
1728 while (hptr != NULL)
1730 //This is utter failure...
1731 // if (symcmp(symbol, hptr->h_sym)) <-- left here for giggles :D - LinkoVitch
1732 if (strcmp(symbol, hptr->h_sym) == 0)
1735 hptr = hptr->h_next; // Return hash pointer if found
1738 return NULL; // Not found in hash table
1743 // Add Symbol to the Hash Table
1745 int hash_add(char * sym, long type, long value, struct OFILE * ofile)
1748 int flag = !iscommon(type);
1752 printf("hash_add(%s,%s,%lx,", sym, ofile->o_name,value);
1753 printf("%x,%s)\n", (unsigned int)type, (flag ? "GLOBAL" : "COMMON"));
1756 if ((hptr = lookup(sym)) == NULL)
1758 return add_to_hlist(&htable[dohash(sym)], sym, ofile, value, type);
1763 if (iscommon(type) && !iscommon(hptr->h_type))
1765 // Mismatch: global came first; warn and keep the global one
1768 printf("Warning: %s: global from ",sym);
1769 put_name(hptr->h_ofile);
1770 printf(" used, common from ");
1772 printf(" discarded.\n");
1775 putword(sym + 8, ABST_EXTERN);
1776 putlong(sym + 10, 0L);
1778 else if (iscommon(hptr->h_type) && !iscommon(type))
1780 // Mismatch: common came first; warn and keep the global one
1783 printf("Warning: %s: global from ", sym);
1785 printf(" used, common from ");
1786 put_name(hptr->h_ofile);
1787 printf(" discarded.\n");
1790 hptr->h_type = type;
1791 hptr->h_ofile = ofile;
1792 hptr->h_value = value;
1795 { // They're both global
1796 // Global exported by another ofile; warn and make this one extern
1799 printf("Duplicate symbol %s: ", sym);
1800 put_name(hptr->h_ofile);
1803 printf(" discarded\n");
1806 putword(sym + 8, ABST_EXTERN);
1809 { // They're both common
1810 if (hptr->h_value < value)
1812 hptr->h_value = value;
1813 hptr->h_ofile = ofile;
1822 // Add the imported symbols from this file to unresolved, and the global and
1823 // common symbols to the exported hash table.
1825 // Change old-style commons (type == T_EXTERN, value != 0) to new-style ones
1826 // (type == (T_GLOBAL | T_EXTERN)).
1828 int add_symbols(struct OFILE * Ofile)
1830 long nsymbols; // Number of symbols in object file
1831 char * ptr; // Object data base pointer
1832 char * sfix; // Symbol fixup table pointer
1833 char * sstr; // Symbol string table pointer
1834 long index; // String index
1835 long type; // Symbol type
1836 long value; // Symbol value
1837 struct HREC * hptr; // Hash record pointer
1838 char symbol[SYMLEN];
1841 printf("Add symbols for file %s\n", Ofile->o_name);
1843 ptr = Ofile->o_image + 32 // Get base pointer, start of sym fixups
1844 + Ofile->o_header.tsize
1845 + Ofile->o_header.dsize
1846 + Ofile->o_header.absrel.reloc.tsize
1847 + Ofile->o_header.absrel.reloc.dsize;
1848 sfix = ptr; // Set symbol fixup pointer
1849 sstr = sfix + Ofile->o_header.ssize; // Set symbol table pointer
1850 nsymbols = Ofile->o_header.ssize / 12; // Obtain number of symbols
1854 index = getlong(sfix); // Get symbol string index
1855 type = getlong(sfix + 4); // Get symbol type
1856 value = getlong(sfix + 8); // Get symbol value
1857 memset(symbol, 0, SYMLEN);
1858 strcpy(symbol, sstr + index);
1860 // If this is a global/external
1865 // Then add to hash table
1866 if (hash_add(symbol, type, value, Ofile))
1868 return 1; // Error if addition failed
1873 // If value is zero and in hash table
1874 if ((hptr = lookup(symbol)) != NULL)
1876 hptr->h_ofile->o_flags |= O_USED; // Mark symbol as used
1878 // Otherwise add to unresolved list
1879 else if (add_unresolved(symbol, Ofile))
1881 return 1; // Error if addition failed
1886 sfix += 12; // Increment symbol fixup pointer
1887 nsymbols--; // Decrement num of symbols to process
1890 return 0; // Success loading symbols
1895 // Process Object File for Symbols
1897 int doobj(char * fname, char * ptr, char * aname, int flags)
1899 struct OFILE * Ofile; // Object record pointer
1900 char * temp; // Temporary data pointer
1902 // Allocate memory for object record ptr
1903 if ((Ofile = new_ofile()) == NULL)
1905 printf("Out of memory processing %s\n",fname);
1909 // Starting after all pathnames, etc., copy .o file name to Ofile
1910 temp = path_tail(fname);
1912 // Check filename length
1913 if (strlen(temp) > FNLEN - 1)
1915 printf("File name too long: %s\n", temp);
1919 // Check archive name length
1920 if (strlen(aname) > FNLEN - 1)
1922 printf("Archive name too long: %s\n", aname);
1926 strcpy(Ofile->o_name, temp); // Store filename
1927 strcpy(Ofile->o_arname, aname); // Store archive name
1929 Ofile->o_next = NULL; // Initialise object record information
1933 Ofile->o_flags = flags;
1934 Ofile->o_image = ptr;
1936 // Don't do anything if this is just an ARCHIVE marker, just add the file to the olist
1937 if (!(flags & O_ARCHIVE))
1939 Ofile->o_header.magic = getlong(ptr);
1940 Ofile->o_header.tsize = getlong(ptr+4);
1941 Ofile->o_header.dsize = getlong(ptr+8);
1942 Ofile->o_header.bsize = getlong(ptr+12);
1943 Ofile->o_header.ssize = getlong(ptr+16);
1944 Ofile->o_header.absrel.reloc.tsize = getlong(ptr+24);
1945 Ofile->o_header.absrel.reloc.dsize = getlong(ptr+28);
1947 // Round BSS off to alignment boundary
1948 Ofile->o_header.bsize = (Ofile->o_header.bsize + secalign) & ~secalign;
1950 if (Ofile->o_header.dsize & 7)
1952 printf("Warning: data segment size of ");
1954 printf(" is not a phrase multiple\n");
1957 // Check for odd segment sizes
1958 if ((Ofile->o_header.tsize & 1) || (Ofile->o_header.dsize & 1)
1959 || (Ofile->o_header.bsize & 1))
1961 printf("Error: odd-sized segment in ");
1963 printf("; link aborted.\n");
1967 if (add_symbols(Ofile))
1971 // Add this file to the olist
1975 olast->o_next = Ofile;
1983 // Remove Elements from Unresolved List which are Resolvable
1987 struct HREC * uptr; // Unresolved hash record pointer
1988 struct HREC * prev = NULL; // Previous hash record pointer
1989 struct HREC * htemp; // Temporary hash record pointer
1990 struct OFILE * ptemp; // Temporary object file record pointer
1992 // Process object file list
1993 while (plist != NULL)
1995 if (doobj(plist->o_name, plist->o_image, plist->o_arname, plist->o_flags))
1999 plist = plist->o_next;
2003 // Process unresolved list
2004 for(uptr=unresolved; uptr!=NULL; )
2007 printf("lookup(%s) => ",uptr->h_sym);
2009 if ((htemp = lookup(uptr->h_sym)) != NULL)
2012 printf(" %s in %s\n", isglobal(htemp->h_type) ? "global" : "common", htemp->h_ofile->o_name);
2014 htemp->h_ofile->o_flags |= O_USED;
2018 unresolved = uptr->h_next;
2024 prev->h_next = uptr->h_next;
2026 uptr = prev->h_next;
2033 uptr = uptr->h_next;
2042 // Extract Filename from Path
2044 char * path_tail(char * name)
2046 char * temp = max(strrchr(name,'/'), max(strrchr(name,':'), strrchr(name, 92)));
2056 // Add Input File to Processing List
2058 int pladd(char * ptr, char * fname)
2062 plist = new_ofile(); // First time object record allocation
2063 plast = plist; // Update last object record pointer
2067 plast->o_next = new_ofile(); // Next object record allocation
2068 plast = plast->o_next; // Update last object record pointer
2073 printf("Out of memory.\n"); // Error if memory allocation fails
2077 if (strlen(path_tail(fname)) > FNLEN-1)
2078 { // Error on excessive filename length
2079 printf("File name too long: %s (sorry!)\n",fname);
2083 strcpy(plast->o_name, path_tail(fname)); // Store filename, not path
2084 *plast->o_arname = 0; // No archive name for this file
2085 plast->o_image = ptr; // Store data pointer
2086 plast->o_flags = O_USED; // File is used
2087 plast->o_next = NULL; // Initialise next record pointer
2089 return 0; // Return without errors
2094 // Process in Binary Include Files and Add them to the Processing List. This
2095 // routine takes in the binary file and creates an 'object' file in memory.
2096 // Sym1/Sym2 point to the start and end of data.
2098 // Image size for include files is:
2099 // Header ....... 32 bytes
2100 // Data ......... dsize
2101 // Sym Fixups ... 2 * 12 bytes
2102 // Symbol Size .. 4 bytes (Value to include symbols and terminating null)
2103 // Symbols ...... (strlen(sym1) + 1) + (strlen(sym2) + 1)
2104 // Terminate .... 4 bytes (0x00000000)
2106 int doinclude(char * fname, int handle, char * sym1, char * sym2, int segment)
2108 long fsize, dsize, size; // File, DATA segment and image sizes
2109 char * ptr, * sptr; // Data pointers
2111 int sym1len = 0; // Symbol 1 length
2112 int sym2len = 0; // Symbol 2 length
2113 unsigned symtype = 0;
2115 fsize = FSIZE(handle); // Get size of include file
2116 dsize = (fsize + secalign) & ~secalign; // Round up to a alignment boundary
2118 sym1len = strlen(sym1) + 1; // Get sym1 length + null termination
2119 sym2len = strlen(sym2) + 1; // Get sym2 length + null termination
2121 size = 32 + dsize + 24 + 4 + sym1len + sym2len + 4;
2123 // Use calloc so the header & fixups initialize to zero
2124 // Allocate object image memory
2125 if ((ptr = calloc(size, 1L)) == NULL)
2127 printf("Out of memory while including %s\n", fname);
2132 // Read in binary data
2133 if (read(handle, ptr + 32, fsize) != fsize)
2135 printf("File read error on %s\n", fname);
2141 close(handle); // Close file
2143 strcpy(obj_fname[obj_index], path_tail(fname));
2145 // Build this image's dummy header
2146 putlong(ptr, 0x00000107); // Magic number
2150 putlong(ptr+4, dsize); // Text size
2151 putlong(ptr+8, 0L); // Data size
2152 symtype = 0x05000000;
2153 obj_segsize[obj_index][0] = dsize;
2154 obj_segsize[obj_index][1] = 0;
2155 obj_segsize[obj_index][2] = 0;
2159 putlong(ptr+4, 0L); // Text size
2160 putlong(ptr+8, dsize); // Data size
2161 symtype = 0x07000000;
2162 obj_segsize[obj_index][0] = 0;
2163 obj_segsize[obj_index][1] = dsize;
2164 obj_segsize[obj_index][2] = 0;
2167 obj_index++; // Increment object count
2169 putlong(ptr+12, 0L); // BSS size
2170 putlong(ptr+16, 24); // Symbol table size
2171 putlong(ptr+20, 0L); // Entry point
2172 putlong(ptr+24, 0L); // TEXT relocation size
2173 putlong(ptr+28, 0L); // DATA relocation size
2175 sptr = ptr + 32 + dsize; // Set sptr to symbol table location
2177 putlong(sptr, 4L); // String offset of symbol1
2178 putlong(sptr+4, symtype); // Symbol type
2179 putlong(sptr+8, 0x00000000); // Symbol has no value (START)
2180 putlong(sptr+12, 4L + (sym2len-1)); // String offset of symbol2
2181 putlong(sptr+16, symtype); // Symbol type
2182 putlong(sptr+20, dsize); // Symbol is data size (END)
2184 sptr = ptr + 32 + dsize + 24; // Set sptr to symbol table size loc
2186 putlong(sptr, sym1len + 4L); // Size of symbol table
2188 sptr = ptr + 32 + dsize + 24 + 4; // Set sptr to symbol table location
2190 for(i=0; i<(sym1len-1); i++) // Write symbol1 to string table
2193 sptr += (sym1len-1); // Step past symbol string
2194 *sptr = '\0'; // Terminate symbol string
2195 sptr += 1; // Step past termination
2197 for(i=0; i<(sym2len-1); i++) // Write symbol2 to string table
2200 sptr += (sym2len-1); // Step past symbol string
2201 *sptr = '\0'; // Terminate symbol string
2202 sptr += 1; // Step past termination
2204 putlong(sptr, 0L); // Terminating long for object file
2206 return pladd(ptr, fname);
2211 // Takes a file name, gets in its image, puts it on plist. The image may
2212 // already be in memory: If so, the ptr arg is non-null. If so, the file is
2213 // already closed. Note that the file is already open (from dofile()). RETURNS
2214 // a pointer to the OFILE structure for this file, so you can diddle its flags
2215 // (dofile sets O_USED for files on the command line).
2217 int doobject(char * fname, int fd, char * ptr)
2219 long size; // File size
2223 size = FSIZE(fd); // Get size of input object file
2225 // Allocate memory for file data
2226 if ((ptr = malloc(size)) == NULL)
2228 printf("Out of memory while processing %s\n", fname);
2229 close(fd); // Close and error
2233 // Read in file data
2234 if (read(fd, ptr, size) != size)
2236 printf("File read error on %s\n", fname);
2237 close(fd); // Close, free memory and error
2242 strcpy(obj_fname[obj_index], path_tail(fname)); // SCPCD : get the name of the file instead of all pathname
2243 obj_segsize[obj_index][0] = (getlong(ptr + 4) + secalign) & ~secalign;
2244 obj_segsize[obj_index][1] = (getlong(ptr + 8) + secalign) & ~secalign;
2245 obj_segsize[obj_index][2] = (getlong(ptr + 12) + secalign) & ~secalign;
2248 close(fd); // Close file
2251 // Now add this image to the list of pending ofiles (plist)
2252 // This routine is shared by doinclude after it builds the image
2253 return pladd(ptr, fname);
2258 // Process In Outstanding Object Files
2260 int flush_handles(void)
2263 char magic[4]; // Magic header number
2266 // Process all handles
2267 for(i=0; i<(int)hd; i++)
2269 // Verbose mode information
2272 printf("Read file %s%s\n", name[i], hflag[i] ? " (include)" : "");
2276 { // Attempt to read file magic number
2278 if (read(handle[i],magic,4) != 4)
2280 printf("Error reading file %s\n", name[i]);
2281 close(handle[i]); // Close file and error
2285 lseek(handle[i], 0L, 0); // Reset to start of input file
2286 // test = getlong(magic); printf("Magic Number is 0x%08X\n", test);
2288 if (getlong(magic) == 0x00000107)
2289 { // Look for SMAC/MAC object files
2290 if (doobject(name[i], handle[i], 0L)) // Process input object file
2295 printf("%s is not a supported object file\n", name[i]);
2296 close(handle[i]); // Close file and error
2303 // If hflag[i] is 1, include this in the data segment; if 2, put in in text segment
2304 if (doinclude(name[i], handle[i], hsym1[i], hsym2[i], hflag[i] - 1))
2309 // Free include, symbol & object handles
2310 for(i=0; i<(int)hd; i++)
2321 hd = 0; // Reset next handle indicator
2327 // Load newargv with Pointers to Arguments Found in the Buffer
2329 int parse(char * buf, char * newargv[])
2334 printf("begin parsing\n");
2338 while (*buf && strchr(",\t\n\r\14 ", *buf))
2342 if (*buf == '\0' || *buf == 26)
2346 printf("No commands in command file\n");
2355 /* test for comment */
2358 /* found a comment; skip to next \n and start over */
2359 while (*buf && *buf != '\n')
2367 printf("Too many arguments in command file\n");
2373 while (!strchr(",\t\n\r\14 ", *buf))
2375 if (*buf == '\0' || *buf == 26)
2377 printf("Finished parsing %d args\n", i);
2387 printf("argv[%d] = \"%s\"\n", i, newargv[i]);
2395 // Process in a Link Command File
2397 int docmdfile(char * fname)
2399 int fd; // File descriptor
2400 unsigned size; // Command file size
2401 char * ptr; // Pointer
2402 int newargc; // New argument count
2403 char * (*newargv)[]; // New argument value array
2405 // Verbose information
2407 printf("docmdfile(%s)\n", fname);
2409 // Allocate memory for new argument values
2410 newargv = malloc((long)(sizeof(char *) * MAXARGS));
2414 printf("Out of memory.\n");
2418 // Attempt to open and read in the command file
2421 if ((fd = open(fname, _OPEN_FLAGS)) < 0)
2423 printf("Cannot open command file %s.\n", fname);
2429 if ((ptr = malloc(size + 1)) == NULL)
2431 printf("Out of memory.\n");
2436 if (read(fd, ptr, size) != (int)size)
2438 printf("Read error on command file %s.\n", fname);
2443 *(ptr + size) = 0; // Null terminate the buffer
2448 printf("No command filename specified\n");
2452 // Parse the command file
2453 if ((newargc = parse(ptr, *newargv)) == -1)
2458 // Process the inputted flags
2459 if (doargs(newargc, *newargv))
2461 printf("docmdfile: doargs returns TRUE\n");
2473 // Take an Argument List and Parse the Command Line
2475 int doargs(int argc, char * argv[])
2477 int i = 1; // Iterator
2478 int c; // Command line character
2479 char * ifile, * isym; // File name and symbol name for -i
2482 { // Parse through option switches & files
2483 if (argv[i][0] == '-')
2484 { // Process command line switches
2487 printf("Illegal option argument: %s\n\n", argv[i]);
2492 c = argv[i++][1]; // Get next character in command line
2495 { // Process command line switch
2496 case '?': // Display usage information
2503 case 'A': // Set absolute linking on
2509 printf("Not enough arguments to -a\n");
2513 aflag = 1; // Set abs link flag
2514 // Segment order is TEXT, DATA, BSS
2515 // Text segment can be 'r', 'x' or a value
2518 if ((*argv[i] == 'r' || *argv[i] == 'R') && !argv[i][1])
2520 ttype = -1; // TEXT segment is relocatable
2522 else if ((*argv[i] == 'x' || *argv[i] == 'X'))
2524 printf("Error in text-segment address: cannot be contiguous\n");
2527 else if ((ttype = 0), getval(argv[i], &tval))
2529 printf("Error in text-segment address: %s is not 'r', 'x' or an address.", argv[i]);
2534 // Data segment can be 'r', 'x' or a value
2537 if ((*argv[i] == 'r' || *argv[i] == 'R') && !argv[i][1])
2539 dtype = -1; // DATA segment is relocatable
2541 else if ((*argv[i] == 'x' || *argv[i] == 'X'))
2543 dtype = -2; // DATA follows TEXT
2545 else if ((dtype = 0), getval(argv[i],&dval))
2547 printf("Error in data-segment address: %s is not 'r', 'x' or an address.", argv[i]);
2554 // BSS segment can be 'r', 'x' or a value
2555 if ((*argv[i] == 'r' || *argv[i] == 'R') && !argv[i][1])
2557 btype = -1; // BSS segment is relocatable
2559 else if ((*argv[i] == 'x' || *argv[i] == 'X'))
2561 btype = -3; // BSS follows DATA
2563 else if ((btype = 0), getval(argv[i],&bval))
2565 printf("Error in bss-segment address: %s is not 'r', 'x[td]', or an address.", argv[i]);
2572 case 'B': // Don't remove muliply defined locals
2579 case 'C': // Process a command file
2582 printf("Not enough arguments to -c\n");
2586 if (docmdfile(argv[i++]))
2593 case 'D': // Wait for "return" before exiting
2601 case 'E': // Output COFF (absolute only)
2605 case 'G': // Output source level debugging
2606 printf("\'g\' flag not currently implemented\n");
2609 if (gflag) warn('g', 1);
2614 case 'I': // Include binary file
2617 printf("Not enough arguments to -i\n");
2624 if ((argv[i-3][2] == 'i') || (argv[i-3][2] == 'I'))
2625 { // handle -ii (No truncation)
2627 printf("warning: (-ii) COFF format output not specified\n");
2630 { // handle -i (Truncation)
2631 if (strlen(isym) > 7)
2635 // Place include files in the DATA segment only
2636 if (dofile(ifile, DSTSEG_D, isym))
2641 case 'L': // Add local symbols
2648 case 'M': // Produce load symbol map
2655 case 'N': // Output no header to .abs file
2662 case 'O': // Specify an output file
2670 printf("No output filename following -o switch\n");
2674 if (strlen(argv[i]) > FARGSIZE - 5)
2676 printf("Output file name too long (sorry!)\n");
2680 strcpy(ofile, argv[i++]);
2683 case 'R': // Section alignment size
2689 switch (argv[i-1][2])
2691 case 'w': case 'W': secalign = 1; break; // Word alignment
2692 case 'l': case 'L': secalign = 3; break; // Long alignment
2693 case 'p': case 'P': secalign = 7; break; // Phrase alignment
2694 case 'd': case 'D': secalign = 15; break; // Double phrase alignment
2695 case 'q': case 'Q': secalign = 31; break; // Quad phrase alignment
2696 default: secalign = 7; break; // Default phrase alignment
2701 case 'S': // Output only global symbols
2708 case 'V': // Verbose information
2709 if (!vflag && !versflag)
2717 case 'W': // Show warnings flag
2724 case 'Z': // Suppress banner flag
2731 printf("unknown option argument `%c'\n", c);
2736 { // Not a switch, then process as a file
2737 if (dofile(argv[i++], 0, NULL))
2743 if (!oflag && vflag)
2745 strcpy(ofile, "output");
2746 printf("Output file is %s[.ext]\n", ofile);
2750 printf("Output file is %s\n", ofile);
2755 return 0; // No problems encountered
2760 // Display Version Information
2762 void display_version(void)
2764 if (displaybanner)// && vflag)
2766 printf("\nReboot's Linker for Atari Jaguar\n");
2767 printf("Copyright (c) 199x Allan K. Pratt, 2011 Reboot\n");
2768 printf("V%i.%i.%i %s (%s)\n\n", MAJOR, MINOR, PATCH, __DATE__, PLATFORM);
2774 // Display Command Line Help
2776 void display_help(void)
2779 printf(" %s [-options] file(s)\n", cmdlnexec);
2781 printf("Options:\n");
2782 printf(" -? or -h display usage information\n");
2783 printf(" -a <text> <data> <bss> output absolute file\n");
2784 printf(" hex value: segment address\n");
2785 printf(" r: relocatable segment\n");
2786 printf(" x: contiguous segment\n");
2787 printf(" -b don't remove multiply defined local labels\n");
2788 printf(" -c <fname> add contents of <fname> to command line\n");
2789 printf(" -d wait for key after link\n");
2790 printf(" -e output COF absolute file\n");
2791 printf(" -g output source-level debugging\n");
2792 printf(" -i <fname> <label> incbin <fname> and set <label>\n");
2793 printf(" -l add local symbols\n");
2794 printf(" -m produce load symbols map\n");
2795 printf(" -n output no file header to .abs file\n");
2796 printf(" -o <fname> set output name\n");
2797 printf(" -r<size> section alignment size\n");
2798 printf(" w: word (2 bytes)\n");
2799 printf(" l: long (4 bytes)\n");
2800 printf(" p: phrase (8 bytes, default alignment)\n");
2801 printf(" d: double phrase (16 bytes)\n");
2802 printf(" q: quad phrase (32 bytes)\n");
2803 printf(" -s output only global symbols\n");
2804 printf(" -v set verbose mode\n");
2805 printf(" -w show linker warnings\n");
2806 printf(" -z suppress banner\n");
2818 // Display link status if verbose mode
2820 printf("Link %s.\n", errflag ? "aborted" : "complete");
2822 // Wait for return key if requested
2825 printf("\nPress the [RETURN] key to continue. ");
2826 fgets(tempbuf, 128, stdin);
2834 // Determine Processor Endianess
2836 int get_endianess(void)
2839 char * p = (char *)&i;
2842 return ENDIANNESS_LITTLE;
2844 return ENDIANNESS_BIG;
2849 // Application Code Starts Here
2851 int main(int argc, char * argv[])
2853 char * s = NULL; // String pointer for "getenv"
2854 struct HREC * utemp; // Temporary hash record pointer
2855 struct OHEADER * header; // Pointer to output header structure
2857 endian = get_endianess(); // Get processor endianess
2858 cmdlnexec = argv[0]; // Obtain executable name
2859 s = getenv("RLNPATH");
2861 if (s) // Attempt to obtain env variable
2862 strcpy(libdir, s); // Store it if found
2864 // Parse the command line
2865 if (doargs(argc, argv))
2871 if (!zflag && !vflag)
2873 display_version(); // Display version information
2874 versflag = 1; // We've dumped the version banner
2877 // Process in specified files/objects
2878 if (flush_handles())
2884 // Remove elements from unresolved list
2891 // Check that there is something to link
2894 // printf("No object files to link.\n\n");
2900 // Report unresolved externals
2901 if (unresolved != NULL)
2903 printf("UNRESOLVED SYMBOLS\n");
2905 // Don't list them if two -u's or more
2910 while (utemp != NULL)
2912 printf("\t%s (",utemp->h_sym);
2913 put_name(utemp->h_ofile);
2915 utemp = utemp->h_next;
2926 // Make one output file from input objs
2927 if ((header = make_ofile()) == NULL)
2936 printf("TO DO:Partial linking\n");
2939 // Relocatable linking
2942 printf("TO DO:Relocatable linking\n");
2950 printf("Absolute linking ");
2959 printf("Header magic is 0x%04X\n", (unsigned int)header->magic);
2961 if (write_ofile(header))
2965 if (mflag) // Display the loaded symbols map
2966 if (write_map(header))
2969 // Display segment size summary
2973 printf("+---------+----------+----------+----------+\n");
2974 printf("| Segment | TEXT | DATA | BSS |\n");
2975 printf("| Sizes |----------+----------+----------|\n");
2976 printf("| (Hex) | %8X | %8X | %8X |\n", (unsigned int)header->tsize, (unsigned int)header->dsize, (unsigned int)header->bsize);
2977 printf("+---------+----------+----------+----------+\n\n");
2980 //printf("BIG_ENDIAN = %i, LITTLE_ENDIAN = %i\n", BIG_ENDIAN, LITTLE_ENDIAN);
2982 free(header); // Free allocated memory
2983 rln_exit(); // Perform application exit