2 // RLN - Reboot's Linker for the Atari Jaguar Console System
3 // RLN.C - Application Code
4 // Copyright (C) 199x, Allan K. Pratt, 2014 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)
123 uint8_t * out = (uint8_t *)&temp;
125 if (endian == ENDIANNESS_BIG)
141 // Put a Word into Memory
143 void putword(uint8_t * dest, uint16_t val)
145 *dest++ = (uint8_t)(val >> 8);
146 *dest = (uint8_t)val;
151 // Obtain a File's Size
157 temp = lseek(fd, 0L, SEEK_CUR);
158 hold = lseek(fd, 0L, SEEK_END);
159 lseek(fd, 0L, SEEK_SET);
166 // For this object file, add symbols to the output symbol table after
167 // relocating them. Returns TRUE if ost_lookup returns an error (-1).
169 int dosym(struct OFILE * ofile)
171 char * symptr; // Symbol pointer
172 char * symend; // Symbol end pointer
173 int type; // Symbol type
174 long value; // Symbol value
175 int index; // Symbol index
177 int ssidx; // Segment size table index
178 unsigned tsegoffset; // Cumulative TEXT segment offset
179 unsigned dsegoffset; // Cumulative DATA segment offset
180 unsigned bsegoffset; // Cumulative BSS segment offset
181 struct HREC * hptr; // Hash table pointer for globl/extrn
182 char sym[SYMLEN]; // String for symbol name/hash search
184 // Point to first symbol record in the object file
185 symptr = (ofile->o_image + 32
186 + ofile->o_header.tsize
187 + ofile->o_header.dsize
188 + ofile->o_header.absrel.reloc.tsize
189 + ofile->o_header.absrel.reloc.dsize);
191 // Point to end of symbol record in the object file
192 symend = symptr + ofile->o_header.ssize;
194 // Search through object segment size table to accumulated segment sizes to ensure
195 // the correct offsets are used in the resulting COF file.
196 ssidx = -1; // Initialise segment index
197 tsegoffset = dsegoffset = bsegoffset = 0; // Initialise segment offsets
199 // Search for object file name
200 for(j=0; j<(int)obj_index; j++)
202 if (!strcmp(ofile->o_name, obj_fname[j]))
204 ssidx = j; // Object file name found
208 tsegoffset += obj_segsize[j][0]; // Accumulate segment sizes
209 dsegoffset += obj_segsize[j][1];
210 bsegoffset += obj_segsize[j][2];
215 printf("dosym() : Cannot get object file segment size : %s\n", ofile->o_name);
219 // Process each record in the symbol table
220 for(; symptr!=symend; symptr+=12)
222 index = getlong(symptr + 0); // Obtain symbol string index
223 type = getlong(symptr + 4); // Obtain symbol type
224 value = getlong(symptr + 8); // Obtain symbol value
226 // Global/External symbols have a pre-processing stage
227 if (type & 0x01000000)
229 // Obtain the string table index for the relocation symbol, look
230 // for it in the globals hash table to obtain information on that
231 // symbol. For the hash calculation to work correctly it must be
232 // placed in a 'clean' string before looking it up.
233 memset(sym, 0, SYMLEN);
234 strcpy(sym, symend + index);
239 printf("dosym() : Cannot determine symbol : %s\n", sym);
243 // Search through object segment size table to obtain segment sizes
244 // for the object that has the required external/global as a local
245 // symbol. As each object is interrogated the segment sizes are
246 // accumulated to ensure the correct offsets are used in the
247 // resulting COF file. This is effectively 'done again' only as we
248 // are working with a different object file.
249 ssidx = -1; // Initialise segment index
250 tsegoffset = dsegoffset = bsegoffset = 0; // Initialise segment offsets
252 for(j=0; j<(int)obj_index; j++)
253 { // Search for object filename
254 if (!strcmp((const char *)hptr->h_ofile, obj_fname[j]))
256 ssidx = j; // Symbol object filename
260 tsegoffset += obj_segsize[j][0]; // Accumulate segment sizes
261 dsegoffset += obj_segsize[j][1];
262 bsegoffset += obj_segsize[j][2];
267 printf("dosym() : Cannot get object file segment size : %s\n",
272 type = hptr->h_type; // Update type with global type
274 if (type == 0x03000000)
275 type = 0x02000000; // Reset external flag if absolute
277 // If the global/external has a value then update that vaule in
278 // accordance with the segment sizes of the object file it
282 switch (hptr->h_type & 0x0E000000)
284 case 0x02000000: // Absolute value
285 case 0x04000000: // TEXT segment
286 value = hptr->h_value;
288 case 0x06000000: // DATA segment
289 value = hptr->h_value - (hptr->h_ofile->o_header.tsize);
291 case 0x08000000: // BSS segment
292 value = hptr->h_value
293 - (hptr->h_ofile->o_header.tsize + hptr->h_ofile->o_header.dsize);
299 // Process and update the value dependant on whether the symbol is a
300 // debug symbol or not
301 if (type & 0xF0000000)
304 // Set the correct debug symbol base address (TEXT segment)
307 for(j=0; (unsigned)j<dosymi; j++)
308 dbgsymbase += obj_segsize[j][0];
310 switch (type & 0xFF000000)
313 value = tval + dbgsymbase;
318 value = tval + dbgsymbase + value;
323 putlong(symptr + 8, value);
328 // Now make modifications to the symbol value, local or global,
329 // based on the segment sizes of the object file currently being
331 switch (type & T_SEG)
333 case 0x02000000: // Absolute value
335 case T_TEXT: // TEXT segment
336 if (type & 0x01000000)
337 value = tbase + tsegoffset + value;
339 value = tbase + tsegoffset + value;
341 putlong(symptr + 8, value);
343 case T_DATA: // DATA segment
344 if (type & 0x01000000)
345 value = dbase + dsegoffset + value;
347 value = dbase + dsegoffset + (value - ofile->o_header.tsize);
349 putlong(symptr + 8, value);
351 case T_BSS: // BSS segment
352 if (type & 0x01000000)
353 value = bbase + bsegoffset + value;
355 value = bbase + bsegoffset
356 + (value - (ofile->o_header.tsize + ofile->o_header.dsize));
358 putlong(symptr + 8, value);
365 // Add to output symbol table
366 if (lflag || !islocal(type))
368 if (islocal(type) || isglobal(type))
370 if ((index = ost_add(symend + index, type, value)) == -1)
375 // Belongs in OST, but don't look it up yet
381 // 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 //NO! if (iscommon(hptr->h_type))
423 if (isglobal(hptr->h_type) || isextern(hptr->h_type))
425 if (hptr->h_type == 0x03000000)
426 hptr->h_type = 0x02000000; // Absolutes can't be externals
428 if (ost_add(hptr->h_sym, hptr->h_type, hptr->h_value) == -1)
439 // Add a Symbol's Name, Type, and Value to the OST.
440 // Return the Index of the Symbol in OST, or -1 for Error.
442 int ost_add(char * name, int type, long value)
444 int ost_offset_p, ost_offset_e = 0; // OST table offsets for position calcs
445 int slen = 0; // Symbol string length
446 int ostresult; // OST index result
450 // If the OST or OST String Table has not been initialised then do so
453 if ((ost = malloc(OST_BLOCK)) == NULL)
455 printf("OST memory allocation error (stringtable).\n");
459 ost_ptr = ost; // Set OST start pointer
460 ost_end = ost + OST_BLOCK; // Set OST end pointer
462 if ((oststr = malloc(OST_BLOCK)) == NULL)
464 printf("OST memory allocation error (string).\n");
468 putlong(oststr, 0x00000004); // Just null long for now
469 oststr_ptr = oststr + 4; // Skip size of str table long (incl null long)
470 putlong(oststr_ptr, 0x00000000); // Null terminating long
471 oststr_end = oststr + OST_BLOCK;
475 // If next symbol record exceeds current allocation then expand symbol table.
476 ost_offset_p = (ost_ptr - ost);
477 ost_offset_e = (ost_end - ost);
480 if ((ost_ptr + 12) > ost_end)
482 if ((ost = realloc(ost, (unsigned)(ost_end + OST_BLOCK))) == NULL)
484 printf("OST memory reallocation error.\n");
488 ost_ptr = ost + ost_offset_p;
489 ost_end = (ost + ost_offset_e) + OST_BLOCK;
492 ost_offset_p = (oststr_ptr - oststr);
493 ost_offset_e = (oststr_end - oststr);
495 if ((oststr_ptr + (slen + 1 + 4)) > oststr_end)
497 if ((oststr = realloc(oststr, (unsigned)(oststr_end + OST_BLOCK))) == NULL)
499 printf("OSTSTR memory reallocation error.\n");
503 oststr_ptr = oststr + ost_offset_p;
504 oststr_end = (oststr + ost_offset_e) + OST_BLOCK;
508 // If this is a debug symbol and the include debug symbol flag (-g) is not
509 // set then do nothing
510 if ((type & 0xF0000000) && !gflag)
516 ostresult = ost_lookup(name); // Get symbol index in OST
518 // If the symbol is in the output symbol table and the bflag is set
519 // (don't remove multiply defined locals) and this is not an
520 // external/global symbol *** OR *** the symbol is not in the output
521 // symbol table then add it.
522 if (((ostresult != -1) && bflag && !(type & 0x01000000))
523 || ((ostresult != -1) && gflag && (type & 0xF0000000)) || (ostresult == -1))
525 if ((type & 0xF0000000) == 0x40000000)
526 putlong(ost_ptr, 0x00000000); // Zero string table offset for dbg line
528 putlong(ost_ptr, (oststr_ptr - oststr)); // String table offset of symbol string
530 putlong(ost_ptr + 4, type );
531 putlong(ost_ptr + 8, value);
534 // If the symbol type is anything but a debug line information
535 // symbol then write the symbol string to the string table
536 if ((type & 0xF0000000) != 0x40000000)
538 strcpy(oststr_ptr, name); // Put symbol name in string table
539 *(oststr_ptr + slen) = '\0'; // Add null terminating character
540 oststr_ptr += (slen + 1);
541 putlong(oststr_ptr, 0x00000000); // Null terminating long
542 putlong(oststr, (oststr_ptr - oststr)); // Update size of string table
547 printf("ost_add: (%s), type=$%08X, val=$%08X\n", name, type, value);
554 // Not sure about this as it could affect return indices. Needed to stop
561 // Return the Index of a Symbol in the Output Symbol Table
563 int ost_lookup(char * sym)
566 int stro = 4; // Offset in string table
568 for(i=0; i<ost_index; i++)
570 if (strcmp(oststr + stro, sym) == 0)
573 stro += strlen(oststr + stro) + 1;
581 // Add Unresolved Externs to the Output Symbol Table
583 int dounresolved(void)
585 struct HREC * hptr, * htemp; // Hash record pointers
586 hptr = unresolved; // Point to unresolved symbols list
588 // While unresolved list is valid
591 if (ost_add(hptr->h_sym, T_EXT, 0L) == -1)
595 printf("dounresolved(): added %s\n", hptr->h_sym);
597 htemp = hptr->h_next; // Temporarily get ptr to next record
598 free(hptr); // Free current record
599 hptr = htemp; // Make next record ptr, current
602 unresolved = NULL; // Zero unresolved record list
608 // Update Object File TEXT and DATA Segments Based on Relocation Records. Take
609 // in an OFILE header and flag (T_TEXT, T_DATA) to process. Return (0) is
610 // successful or non-zero (1) if failed.
612 int reloc_segment(struct OFILE * ofile, int flag)
614 char * symtab; // Start of symbol table
615 char * symbols; // Start of symbols
616 char * sptr; // Start of segment data
617 char * rptr; // Start of segment relocation records
618 unsigned symidx; // Offset to symbol
619 unsigned addr; // Relocation address
620 unsigned rflg; // Relocation flags
621 unsigned olddata; // Old segment data at reloc address
622 unsigned newdata = 0; // New segment data at reloc address
623 unsigned pad; // Temporary to calculate phrase padding
625 char sym[SYMLEN]; // String for symbol name/hash search
626 int ssidx; // Segment size table index
627 unsigned glblreloc; // Global relocation flag
628 unsigned absreloc; // Absolute relocation flag
629 unsigned relreloc; // Relative relocation flag
630 unsigned swcond; // Switch statement condition
631 unsigned relocsize; // Relocation record size
633 // If there is no TEXT relocation data for the selected object file segment
634 // then update the COF TEXT segment offset allowing for the phrase padding
635 if ((flag == T_TEXT) && !ofile->o_header.absrel.reloc.tsize)
637 // TEXT segment size plus padding
638 pad = ((ofile->o_header.tsize + secalign) & ~secalign);
639 textoffset += (ofile->o_header.tsize + (pad - ofile->o_header.tsize));
642 printf("reloc_segment(%s, TEXT) : No Relocation Data\n", ofile->o_name);
647 // If there is no DATA relocation data for the selected object file segment
648 // then update the COF DATA and BSS segment offsets allowing for the phrase
650 if ((flag == T_DATA) && !ofile->o_header.absrel.reloc.dsize)
652 // DATA segment size plus padding
653 pad = ((ofile->o_header.dsize + secalign) & ~secalign);
654 dataoffset += (ofile->o_header.dsize + (pad - ofile->o_header.dsize));
655 // BSS segment size plus padding
656 pad = ((ofile->o_header.bsize + secalign) & ~secalign);
657 bssoffset += (ofile->o_header.bsize + (pad - ofile->o_header.bsize));
660 printf("reloc_segment(%s, DATA) : No Relocation Data\n", ofile->o_name);
665 // Verbose mode information
668 printf("reloc_segment(%s, %s) : Processing Relocation Data\n",
669 ofile->o_name, flag == T_DATA ? "DATA" : "TEXT");
672 // Obtain pointer to start of symbol table
673 symtab = (ofile->o_image + 32 + ofile->o_header.tsize + ofile->o_header.dsize
674 + ofile->o_header.absrel.reloc.tsize + ofile->o_header.absrel.reloc.dsize);
676 // Obtain pointer to start of symbols
677 symbols = symtab + ofile->o_header.ssize;
679 // Obtain pointer to start of TEXT segment
680 sptr = ofile->o_image + 32;
682 // Obtain pointer to start of TEXT relocation records
683 rptr = sptr + (ofile->o_header.tsize + ofile->o_header.dsize);
685 relocsize = ofile->o_header.absrel.reloc.tsize;
689 printf("RELOCSIZE :: %d Records = %d\n",relocsize,relocsize/8);
692 // Update pointers if DATA relocation records are being processed
695 sptr += ofile->o_header.tsize; // Start of DATA segment
696 rptr += ofile->o_header.absrel.reloc.tsize; // Start of DATA relocation records
697 relocsize = ofile->o_header.absrel.reloc.dsize;
700 // Process each relocation record for the TEXT segment
701 for(i=0; i<(int)relocsize; i+=8)
703 // Obtain both the relocation address and the relocation flags from the
705 addr = getlong(rptr);
706 rflg = getlong(rptr + 4);
707 glblreloc = (rflg & 0x00000010 ? 1 : 0); // Set global relocation flag
708 absreloc = (rflg & 0x00000040 ? 1 : 0); // Set absolute relocation flag
709 relreloc = (rflg & 0x000000A0 ? 1 : 0); // Set relative relocation flag
711 // Additional processing required for global relocations
714 // Obtain the string table index for the relocation symbol, look
715 // for it in the globals hash table to obtain information on that
716 // symbol. For the hash calculation to work correctly it must be
717 // placed in a 'clean' string before looking it up.
718 symidx = getlong(symtab + ((rflg >> 8) * 12));
719 memset(sym, 0, SYMLEN);
720 strcpy(sym, symbols + symidx);
721 olddata = newdata = 0; // Initialise old and new segment data
722 ssidx = ost_lookup(sym);
723 newdata = getlong(ost + ((ssidx - 1) * 12) + 8);
726 // Obtain the existing long word segment data and flip words if the
727 // relocation flags indicate it relates to a RISC MOVEI instruction
728 olddata = getlong(sptr + addr);
731 olddata = _SWAPWORD(olddata);
733 // Process record dependant on segment it relates to; TEXT, DATA or
734 // BSS. Construct a new relocated segment long word based on the
735 // required segment base address, the segment data offset in the
736 // resulting COF file and the offsets from the incoming object file.
737 //swcond = glblreloc ? ((hptr->h_type & 0x0E000000) >> 16) : (rflg & 0xFFFFFF00);
738 swcond = (rflg & 0xFFFFFF00);
744 case 0x00000200: // Absolute Value
746 case 0x00000400: // TEXT segment relocation record
747 //AARRRGGGGHHHHH! does the else belong to the 1st 'if' or the 2nd?
748 // can we trust the indention to tell the truth here???
749 // Braces were not here, so if something breaks, try pairing the else to the 1st 'if'...
752 if (flag == T_TEXT) // Is this a TEXT section record?
753 newdata = tbase + textoffset + olddata;
755 newdata = tbase + dataoffset + olddata; // Nope, must be DATA section
759 case 0x00000600: // DATA segment relocation record
761 newdata = dbase + dataoffset + (olddata - ofile->o_header.tsize);
764 case 0x00000800: // BSS segment relocation record
766 newdata = bbase + bssoffset
767 + (olddata - (ofile->o_header.tsize + ofile->o_header.dsize));
778 // Set absolute (long) or relative (word) address of symbol
781 // Flip the new long word segment data if the relocation record
782 // indicated a RISC MOVEI instruction and place the resulting data
783 // back in the COF segment
785 newdata = _SWAPWORD(newdata);
787 putlong(sptr + addr, newdata);
791 putword(sptr + addr, newdata - tbase - addr - ofile->o_tbase);
794 // Shamus: Let's output some info to aid in debugging this crap
801 sprintf(ssiString, " [ssi:%i]", ssidx);
803 printf("reloc_segment($%08X): %s, $%08X: $%08X => $%08X%s\n", rflg, (glblreloc ? sym : "(LOCAL)"), addr, olddata, getlong(sptr + addr), ssiString);
806 rptr += 8; // Point to the next relocation record
809 // Update the COF segment offset allowing for the phrase padding.
812 // TEXT segment plus padding
813 pad = ((ofile->o_header.tsize + secalign) & ~secalign);
814 textoffset += (ofile->o_header.tsize + (pad - ofile->o_header.tsize));
818 // DATA segment plus padding
819 pad = ((ofile->o_header.dsize + secalign) & ~secalign);
820 dataoffset += (ofile->o_header.dsize + (pad - ofile->o_header.dsize));
821 // BSS segment plus padding
822 pad = ((ofile->o_header.bsize + secalign) & ~secalign);
823 bssoffset += (ofile->o_header.bsize + (pad - ofile->o_header.bsize));
826 // Return value, should always be zero
832 // Add a path character to the end of string 's' if it doesn't already end with
833 // one. The last occurrance of '/' or '\\' in the string is assumed to be the
836 void pathadd(char * s)
838 // And hope to God that there's enough space in the buffer...
843 if (*s == '/' || *s == '\\')
860 // Try to open "name", "name.o", "${libdir}name", "${libdir}name.o". Return the
861 // handle of the file successfully opened. p_name is updated to point to a
862 // malloc()'ed string which is the name which actually got opened. p_name will
863 // return unchanged if the file can't be found.
865 int tryopen(char ** p_name)
867 char * name = *p_name; // Filename
868 char * tmpbuf, * lastdot; // Buffer and 'dot' pointers
869 int fd, hasdot; // File descriptor and 'has dot' flag
871 // Note that libdir will be an empty string if there is none specified
872 if ((tmpbuf = malloc((long)strlen(name) + strlen(libdir) + 3)) == NULL)
874 printf("tryopen() : out of memory\n");
878 strcpy(tmpbuf, name);
879 hasdot = ((lastdot = strrchr(tmpbuf, '.')) > strrchr(tmpbuf, '/'))
880 && (lastdot > strrchr(tmpbuf, '\\'));
882 if ((fd = open(tmpbuf, _OPEN_FLAGS)) >= 0)
883 goto ok; // Try to open file as passed first
887 strcat(tmpbuf, ".o"); // Try to open file with '.o' added
889 if ((fd = open(tmpbuf, _OPEN_FLAGS)) >= 0)
893 // Try the libdir only if the name isn't already anchored
894 if (*name != '/' && *name != '\\' && !strchr(name, ':'))
896 strcpy(tmpbuf,libdir);
897 // Add a trailing path char if there isn't one already
899 strcat(tmpbuf, name);
901 if ((fd = open(tmpbuf, _OPEN_FLAGS)) >= 0)
906 strcat(tmpbuf, ".o");
908 if ((fd = open(tmpbuf, _OPEN_FLAGS)) >= 0)
913 // Couldn't open file at all
916 // There are worse things... :-P
918 if ((tmpbuf = realloc(tmpbuf, (long)strlen(tmpbuf) + 1)) == NULL)
920 printf("tryopen() : out of memory\n");
925 return fd; // Return file descriptor
930 // Archive File Use, Needs to be Removed
932 void put_name(struct OFILE * p)
934 int flag = *(p->o_arname);
935 printf("%s%s%s", (flag ? (char *)(p->o_arname) : ""), (flag ? ":" : ""), p->o_name);
940 // Collect file names and handles in a buffer so there is less disk activity.
941 // Call dofile with flag FALSE for normal object files and archives.
942 // Call it with flag TRUE and a symbol name for include files (-i).
944 int dofile(char * fname, int flag, char * sym)
946 int fd; // File descriptor
947 int temp; // Temporary storage
949 // Verbose information
952 printf("dofile() : `%s' %s", fname, flag ? "INCLUDE" : "NORMAL");
955 printf(" symbol %s", sym);
960 // Reached maximum file handles
967 // Attempt to open input file
968 if ((fd = tryopen(&fname)) < 0)
970 printf("Cannot find input module %s\n", fname);
974 // The file is open; save its info in the handle and name arrays
976 name[hd] = fname; // This is the name from tryopen()
982 temp = strlen(sym); // Get symbol length
984 // 100 chars is max length of a symbol
991 // Malloc enough space for two symbols, then build the second one.
992 // Second one may be one character longer than first
993 if ((hsym1[hd] = malloc((long)temp + 1)) == NULL
994 || (hsym2[hd] = malloc((long)temp + 2)) == NULL)
996 printf("dofile() : out of memory for include-file symbols\n");
1000 strcpy(hsym1[hd], sym);
1001 strcpy(hsym2[hd], sym);
1007 printf("Last char of %s is already 'x': choose another name\n", sym);
1011 hsym2[hd][99] = 'x';
1015 hsym2[hd][temp] = 'x';
1016 hsym2[hd][temp+1] = '\0';
1020 // Increment next handle index
1028 // Pad TEXT or DATA Segment to the Requested Boundary
1030 int segmentpad(FILE * fd, long segsize, int value)
1032 long padsize; // Number of pad bytes needed
1033 int i; // Good 'ol iterator
1034 char padarray[32]; // Array of padding bytes
1035 char * padptr; // Pointer to array
1037 // Determine the number of padding bytes that are needed
1038 padsize = (segsize + secalign) & ~secalign;
1039 padsize = padsize - segsize;
1041 // Fill pad array if padding is required
1048 putword(padptr, value);
1052 symoffset += padsize;
1054 if (fwrite(padarray, padsize, 1, fd) != 1) // Write padding bytes
1058 return 0; // All done
1063 // Write the Output File
1065 int write_ofile(struct OHEADER * header)
1067 FILE * fd; // File descriptor
1068 unsigned osize; // Object segment size
1069 struct OFILE * otemp; // Object file pointer
1070 int i, j; // Iterators
1071 char himage[0x168]; // Header image (COF = 0xA8)
1072 unsigned tsoff, dsoff, bsoff; // Segment offset values
1073 unsigned index, type, value; // Symbol table index, type and value
1074 short abstype; // ABS symbol type
1075 char symbol[14]; // Symbol record for ABS files
1076 int slen; // Symbol string length
1078 symoffset = 0; // Initialise symbol offset
1080 // Add correct output extension if none
1081 if (strchr(ofile, '.') == NULL)
1084 strcat(ofile, ".cof"); // COF files
1085 else if (aflag && !cflag)
1086 strcat(ofile, ".abs"); // ABS files
1088 strcat(ofile, ".o"); // Object files (partial linking etc)
1091 fd = fopen(ofile, "wb"); // Attempt to open output file
1095 printf("Can't open output file %s\n", ofile); // Error opening output file
1099 // Build the output file header
1100 // Absolute (COF) header
1103 tsoff = dsoff = bsoff = 0xA8; // Initialises segment offsets
1105 // Process each object file segment size to obtain a cumulative segment
1106 // size for both the TEXT and DATA segments
1107 for(i=0; i<(int)obj_index; i++)
1109 dsoff += obj_segsize[i][0]; // Adding TEXT segment sizes
1110 bsoff += obj_segsize[i][0] + obj_segsize[i][1]; // Adding TEXT and DATA segment sizes
1113 // Currently this only builds a COF absolute file. Conditionals and
1114 // additional code will need to be added for ABS and partial linking.
1116 // Build the COF_HDR
1117 putword(himage + 0, 0x0150 ); // Magic Number (0x0150)
1118 putword(himage + 2, 0x0003 ); // Sections Number (3)
1119 putlong(himage + 4, 0x00000000 ); // Date (0L)
1120 putlong(himage + 8, dsoff + header->dsize); // Offset to Symbols Section
1121 putlong(himage + 12, ost_index); // Number of Symbols
1122 putword(himage + 16, 0x001C ); // Size of RUN_HDR (0x1C)
1123 putword(himage + 18, 0x0003 ); // Executable Flags (3)
1125 // Build the RUN_HDR
1126 putlong(himage + 20, 0x00000107 ); // Magic/vstamp
1127 putlong(himage + 24, header->tsize ); // TEXT size in bytes
1128 putlong(himage + 28, header->dsize ); // DATA size in bytes
1129 putlong(himage + 32, header->bsize ); // BSS size in bytes
1130 putlong(himage + 36, tbase ); // Start of executable, normally @TEXT
1131 putlong(himage + 40, tbase ); // @TEXT
1132 putlong(himage + 44, dbase ); // @DATA
1134 // Build the TEXT SEC_HDR
1135 putlong(himage + 48, 0x2E746578 );
1136 putlong(himage + 52, 0x74000000 ); // ".text"
1137 putlong(himage + 56, tbase ); // TEXT START
1138 putlong(himage + 60, tbase ); // TEXT START
1139 putlong(himage + 64, header->tsize ); // TEXT size in bytes
1140 putlong(himage + 68, tsoff ); // Offset to section data in file
1141 putlong(himage + 72, 0x00000000 ); // Offset to section reloc in file (0L)
1142 putlong(himage + 76, 0x00000000 ); // Offset to debug lines structures (0L)
1143 putlong(himage + 80, 0x00000000 ); // Nreloc/nlnno (0L)
1144 putlong(himage + 84, 0x00000020 ); // SEC_FLAGS: STYP_TEXT
1146 // Build the DATA SEC_HDR
1147 putlong(himage + 88, 0x2E646174 );
1148 putlong(himage + 92, 0x61000000 ); // ".data"
1149 putlong(himage + 96, dbase ); // DATA START
1150 putlong(himage + 100, dbase ); // DATA START
1151 putlong(himage + 104, header->dsize ); // DATA size in bytes
1152 putlong(himage + 108, dsoff ); // Offset to section data in file
1153 putlong(himage + 112, 0x00000000 ); // Offset to section reloc in file (0L)
1154 putlong(himage + 116, 0x00000000 ); // Offset to debugging lines structures (0L)
1155 putlong(himage + 120, 0x00000000 ); // Nreloc/nlnno (0L)
1156 putlong(himage + 124, 0x00000040 ); // SEC_FLAGS: STYP_DATA
1158 // Build the BSS SEC_HDR
1159 putlong(himage + 128, 0x2E627373 );
1160 putlong(himage + 132, 0x00000000 ); // ".bss"
1161 putlong(himage + 136, bbase ); // BSS START
1162 putlong(himage + 140, bbase ); // BSS START
1163 putlong(himage + 144, header->bsize ); // BSS size in bytes
1164 putlong(himage + 148, bsoff ); // Offset to section data in file
1165 putlong(himage + 152, 0x00000000 ); // Offset to section reloc in file (0L)
1166 putlong(himage + 156, 0x00000000 ); // Offset to debugging lines structures (0L)
1167 putlong(himage + 160, 0x00000000 ); // Nreloc/nlnno (0L)
1168 putlong(himage + 164, 0x00000080 ); // SEC_FLAGS: STYP_BSS
1170 symoffset = 168; // Update symbol offset
1172 // Absolute (ABS) header
1175 // Build the ABS header
1176 putword(himage + 0, 0x601B ); // Magic Number (0x601B)
1177 putlong(himage + 2, header->tsize ); // TEXT segment size
1178 putlong(himage + 6, header->dsize ); // DATA segment size
1179 putlong(himage + 10, header->bsize ); // BSS segment size
1180 putlong(himage + 14, ost_index * 14 ); // Symbol table size (?)
1181 putlong(himage + 18, 0x00000000 ); //
1182 putlong(himage + 22, tbase ); // TEXT base address
1183 putword(himage + 26, 0xFFFF ); // Flags (?)
1184 putlong(himage + 28, dbase ); // DATA base address
1185 putlong(himage + 32, bbase ); // BSS base address
1187 symoffset = 36; // Update symbol offset
1190 // Write the header, but not if noheaderflag
1191 // Absolute (ABS) header
1195 if (fwrite(himage, 36, 1, fd) != 1)
1198 // Absolute (COF) header
1201 if (fwrite(himage, 168, 1, fd) != 1)
1205 // Write the TEXT segment of each object file
1206 for(otemp=olist; otemp!=NULL; otemp=otemp->o_next)
1208 osize = otemp->o_header.tsize;
1210 // Write only if segment has size
1214 printf("Writing TEXT Segment of %s\n", otemp->o_name);
1216 if (fwrite(otemp->o_image + 32, osize, 1, fd) != 1)
1219 // Pad to required alignment boundary
1220 if (segmentpad(fd, osize, 0x0000))
1227 // Write the DATA segment of each object file
1228 for(otemp = olist; otemp != NULL; otemp = otemp->o_next)
1230 osize = otemp->o_header.dsize;
1232 // Write only if the segment has size
1236 printf("Writing DATA Segment of %s\n", otemp->o_name);
1238 if (fwrite((otemp->o_image + 32 + otemp->o_header.tsize), osize, 1, fd) != 1)
1241 // Pad to required alignment boundary
1242 if (segmentpad(fd, osize, 0))
1251 // Write the symbols table and string table
1252 // Absolute (COF) symbol/string table
1257 if (fwrite(ost, (ost_ptr - ost), 1, fd) != 1) goto werror;
1258 if (fwrite(oststr, (oststr_ptr - oststr), 1, fd) != 1) goto werror;
1261 // Absolute (ABS) symbol/string table
1264 // The symbol and string table have been created as part of the
1265 // dosym() function and the output symbol and string tables are in
1266 // COF format. For an ABS file we need to process through this to
1267 // create the 14 character long combined symbol and string table.
1268 // Format of symbol table in ABS: AAAAAAAATTVVVV, where (A)=STRING,
1269 // (T)=TYPE & (V)=VALUE
1271 for(i=0; i<ost_index; i++)
1273 memset(symbol, 0, 14); // Initialise symbol record
1274 abstype = 0; // Initialise ABS symbol type
1275 slen = 0; // Initialise symbol string length
1276 index = getlong(ost + (i * 12)); // Get symbol index
1277 type = getlong((ost + (i * 12)) + 4); // Get symbol type
1279 if (type & 0xF0000000)
1280 continue; // Not doing debug symbols
1282 value = getlong((ost + (i * 12)) + 8); // Get symbol value
1283 slen = strlen(oststr + index);
1285 // Get symbol string (maximum 8 chars)
1289 *(symbol + j) = *(oststr + index + j);
1293 for(j=0; j<slen; j++)
1294 *(symbol + j) = *(oststr + index + j);
1297 // Modify to ABS symbol type
1300 case 0x02000000: abstype = (short)ABST_DEFINED; break;
1301 case 0x04000000: abstype = (short)ABST_DEFINED | ABST_TEXT; break;
1302 case 0x05000000: abstype = (short)ABST_DEFINED | ABST_GLOBAL | ABST_TEXT; break;
1303 case 0x06000000: abstype = (short)ABST_DEFINED | ABST_DATA; break;
1304 case 0x07000000: abstype = (short)ABST_DEFINED | ABST_GLOBAL | ABST_DATA; break;
1305 case 0x08000000: abstype = (short)ABST_DEFINED | ABST_BSS; break;
1306 case 0x09000000: abstype = (short)ABST_DEFINED | ABST_GLOBAL | ABST_BSS; break;
1308 printf("write_ofile: abs, cannot determine symbol type\n");
1313 putword(symbol + 8, abstype); // Write back new ABS type
1314 putlong(symbol + 10, value); // Write back value
1316 if (fwrite(symbol, 14, 1, fd) != 1) goto werror; // Write symbol record
1324 printf("Close error on output file %s\n",ofile);
1331 printf("Write error on output file %s\n", ofile);
1332 fclose(fd); // Try to close output file anyway
1338 // Display the Symbol Load Map
1340 int write_map(struct OHEADER * header)
1342 unsigned i, o; // Inner and outer loop iterators
1343 unsigned c; // Column number
1344 unsigned index; // Symbol string index
1345 unsigned type; // Symbol type
1346 unsigned value; // Symbol value
1347 char * symbol; // Symbol string value
1350 return 0; // Return if no symbols to map
1352 printf("LOAD MAP\n\n");
1354 // Outer loop for each of the symbol areas to map out;
1355 // 0 = NON-RELOCATABLE SYMBOLS
1356 // 1 = TEXT-SEGMENT RELOCATABLE SYMBOLS
1357 // 2 = DATA-SEGMENT RELOCATABLE SYMBOLS
1358 // 3 = BSS-SEGMENT RELOCATABLE SYMBOLS
1361 // Display the correct map header for the symbols being processed
1364 case 0: printf("NON-RELOCATABLE SYMBOLS\n\n"); break;
1365 case 1: printf("TEXT-SEGMENT RELOCATABLE SYMBOLS\n\n"); break;
1366 case 2: printf("DATA-SEGMENT RELOCATABLE SYMBOLS\n\n"); break;
1367 case 3: printf("BSS-SEGMENT RELOCATABLE SYMBOLS\n\n"); break;
1370 c = 0; // Initialise column number
1372 // Inner loop to process each record in the symbol table
1373 for(i=0; i<(unsigned)ost_index; i++)
1375 index = getlong(ost + (i * 12)); // Get symbol string index
1376 type = getlong(ost + (i * 12) + 4); // Get symbol type
1377 value = getlong(ost + (i * 12) + 8); // Get symbol value
1378 symbol = oststr + index; // Get symbol string
1380 // Display only three columns
1387 // If local symbols not included and the type is local then go to
1388 // next symbol record
1389 if (!lflag & !(type & 0x01000000))
1392 // Output each symbol to the display, dependant on type
1396 // Non-relocatable symbols
1397 if (type == 0x02000000 || type == 0x03000000)
1399 printf("%-8s %c %08X ", symbol, (type & 0x01000000) ? 'G' : 'L', value);
1405 // TEXT segment relocatable symbols
1406 if (type == 0x04000000 || type == 0x05000000)
1408 printf("%-8s %c %08X ", symbol, (type & 0x01000000) ? 'G' : 'L', value);
1414 // DATA segment relocatble symbols
1415 if (type == 0x06000000 || type == 0x07000000)
1417 printf("%-8s %c %08X ", symbol, (type & 0x01000000) ? 'G' : 'L', value);
1423 // BSS segment relocatable symbols
1424 if (type == 0x08000000 || type == 0x09000000)
1426 printf("%-8s %c %08X ", symbol, (type & 0x01000000) ? 'G' : 'L', value);
1442 // Convert ASCII to Hexadecimal
1444 //int atolx(char * string, long * value)
1445 int atolx(char * string, int * value)
1449 while (isxdigit(*string))
1451 if (isdigit(*string))
1453 *value = (*value << 4) + (*string++ - '0');
1457 if (isupper(*string))
1458 *string = tolower(*string);
1460 *value = (*value << 4) + ((*string++ - 'a') + 10);
1464 if (*string != '\0')
1466 printf("Invalid hexadecimal value");
1475 // Stuff the (long) value of a string into the value argument. RETURNS TRUE if
1476 // the string doesn't parse. Parses only as a hex string.
1478 //int getval(char * string, long * value)
1479 int getval(char * string, int * value)
1481 return atolx(string, value);
1486 // Create one big .o file from the images already in memory, returning a
1487 // pointer to an OHEADER. Note that the oheader is just the header for the
1488 // output (plus some other information). The text, data, and fixups are all
1489 // still in the ofile images hanging off the global `olist'.
1491 struct OHEADER * make_ofile()
1493 unsigned tptr, dptr, bptr; // Bases in runtime model
1494 int ret = 0; // Return value
1495 struct OFILE * otemp, * oprev, * ohold; // Object file list pointers
1496 struct OHEADER * header; // Output header pointer
1498 textsize = datasize = bsssize = 0; // Initialise cumulative segment sizes
1500 // For each object file, accumulate the sizes of the segments but remove
1501 // those object files which are unused
1502 oprev = NULL; // Init previous obj file list ptr
1503 otemp = olist; // Set temp pointer to object file list
1505 while (otemp != NULL)
1508 if (!(otemp->o_flags & O_ARCHIVE))
1510 if ((otemp->o_flags & O_USED) == 0)
1514 printf("Unused object file ");
1516 printf(" discarded.\n");
1521 olist = otemp->o_next;
1525 oprev -> o_next = otemp->o_next;
1529 free(ohold->o_image);
1534 // Increment total of segment sizes ensuring requested alignment
1535 textsize += (otemp->o_header.tsize + secalign) & ~secalign;
1536 datasize += (otemp->o_header.dsize + secalign) & ~secalign;
1537 bsssize += (otemp->o_header.bsize + secalign) & ~secalign;
1542 // Go to next object file list pointer
1543 otemp = otemp->o_next;
1546 // Update base addresses and create symbols _TEXT_E, _DATA_E and _BSS_E
1548 ost_add("_TEXT_E", 0x05000000, tval + textsize);
1552 // DATA follows TEXT
1553 dbase = tval + textsize;
1554 ost_add("_DATA_E", 0x07000000, tval + textsize + datasize);
1559 bbase = tval + textsize + datasize;
1560 ost_add("_BSS_E", 0x09000000, tval + textsize + datasize + bsssize);
1564 // BSS is independant of DATA
1566 ost_add("_BSS_E", 0x09000000, bval + bsssize);
1571 // DATA is independant of TEXT
1573 ost_add("_DATA_E", 0x07000000, dval + datasize);
1578 bbase = dval + datasize;
1579 ost_add("_BSS_E", 0x09000000, dval + datasize + bsssize);
1583 // BSS is independant of DATA
1585 ost_add("_BSS_E", 0x09000000, bval + bsssize);
1589 // Place each unresolved symbol in the output symbol table
1593 tptr = 0; // Initialise base addresses
1597 // For each file, relocate its symbols and add them to the output symbol table
1601 while (otemp != NULL)
1603 otemp->o_tbase = tptr;
1605 // Do rest only for non-ARCHIVE markers
1606 if (!(otemp->o_flags & O_ARCHIVE))
1608 otemp->o_dbase = dptr;
1609 otemp->o_bbase = bptr;
1610 tptr += (otemp->o_header.tsize + secalign) & ~secalign;
1611 dptr += (otemp->o_header.dsize + secalign) & ~secalign;
1612 bptr += (otemp->o_header.bsize + secalign) & ~secalign;
1615 // For each symbol, (conditionally) add it to the ost
1616 // For ARCHIVE markers, this adds the symbol for the file & returns
1620 if (otemp->o_flags & O_ARCHIVE)
1622 // Now that the archive is marked, remove it from list
1624 olist = otemp->o_next;
1626 oprev->o_next = otemp->o_next;
1630 if (ohold->o_image) free(ohold->o_image);
1638 otemp = otemp->o_next;
1641 // Places all the externs, globals etc into the output symbol table
1642 if (docommon() == -1)
1645 // Create a new output file header
1646 if ((header = new_oheader()) == NULL)
1648 printf("make_ofile: out of memory!\n");
1652 // Fill in the output header. Does not match the actual output but values
1653 // used as reference
1654 header->magic = 0x0150; // COF magic number
1655 header->tsize = textsize; // TEXT segment size
1656 header->dsize = datasize; // DATA segment size
1657 header->bsize = bsssize; // BSS segment size
1658 header->ssize = (ost_ptr - ost); // Symbol table size
1659 header->ostbase = ost; // Output symbol table base address
1661 // For each object file, relocate its TEXT and DATA segments. OR the result
1662 // into ret so all files get moved (and errors reported) before returning
1663 // with the error condition
1664 for(otemp=olist; otemp!=NULL; otemp=otemp->o_next)
1666 if (!(otemp->o_flags & O_ARCHIVE))
1668 ret |= reloc_segment(otemp, T_TEXT); // TEXT segment relocations
1669 ret |= reloc_segment(otemp, T_DATA); // DATA segment relocations
1673 hash_free(); // Done with global symbol hash tables
1675 return (ret ? (unsigned)NULL : header);
1680 // Add Symbol to Hash List
1682 int add_to_hlist(struct HREC ** hptr, char * sym, struct OFILE * ofile, long value, int type)
1684 struct HREC * htemp; // Temporary hash record pointer
1687 // Attempt to allocate new hash record
1688 if ((htemp = new_hrec()) == NULL)
1690 printf("Out of memory\n");
1694 // Shamus: Moar testing...
1697 printf("add_to_hlist(): hptr=$%08X, sym=\"%s\", ofile=$%08X, value=$%X, type=$%X\n", (unsigned int)hptr, sym, (unsigned int)ofile, value, type);
1700 for(i=0; i<SYMLEN; i++)
1701 htemp->h_sym[i] = '\0';
1703 strcpy(htemp->h_sym, sym); // Populate hash record
1704 htemp->h_ofile = ofile;
1705 htemp->h_value = value;
1706 htemp->h_type = type;
1708 htemp->h_next = *hptr; // Update hash record pointers
1716 // Add Symbol to the Unresolved Symbols Hash Table
1718 add_unresolved(char * sym, struct OFILE * ofile)
1721 printf("add_unresolved(%s, %s)\n", sym, ofile->o_name);
1723 return add_to_hlist(&unresolved, sym, ofile, 0L, 0);
1728 // Generate and Return Hash Value
1730 int dohash(char * s)
1732 int i = (s[0] + s[1] + s[2] + s[3] + s[4] + s[5] + s[6] + s[7] + s[8]
1733 + s[9] + s[10] + s[11] + s[12] + s[13] + s[14]) % NBUCKETS;
1739 // Lookup a Symbol in the Hash Table
1741 struct HREC * lookup(char * sym)
1743 struct HREC * hptr = htable[dohash(sym)]; // Hash index to record based on sym
1744 char symbol[SYMLEN]; // Temporary symbol storage
1746 memset(symbol, 0, SYMLEN); // Clean string for comparison
1747 strcpy(symbol, sym);
1749 while (hptr != NULL)
1751 //This is utter failure...
1752 // if (symcmp(symbol, hptr->h_sym)) <-- left here for giggles :D - LinkoVitch
1753 // Return hash pointer if found
1754 if (strcmp(symbol, hptr->h_sym) == 0)
1757 hptr = hptr->h_next;
1760 // Symbol was not found in hash table
1766 // Add Symbol to the Hash Table
1768 int hash_add(char * sym, long type, long value, struct OFILE * ofile)
1771 int flag = !iscommon(type);
1775 printf("hash_add(%s,%s,%lx,", sym, ofile->o_name, value);
1776 printf("%x,%s)\n", (unsigned int)type, (flag ? "GLOBAL" : "COMMON"));
1779 if ((hptr = lookup(sym)) == NULL)
1781 return add_to_hlist(&htable[dohash(sym)], sym, ofile, value, type);
1785 if (iscommon(type) && !iscommon(hptr->h_type))
1787 // Mismatch: global came first; warn and keep the global one
1790 printf("Warning: %s: global from ", sym);
1791 put_name(hptr->h_ofile);
1792 printf(" used, common from ");
1794 printf(" discarded.\n");
1797 putword(sym + 8, ABST_EXTERN);
1798 putlong(sym + 10, 0L);
1800 else if (iscommon(hptr->h_type) && !iscommon(type))
1802 // Mismatch: common came first; warn and keep the global one
1805 printf("Warning: %s: global from ", sym);
1807 printf(" used, common from ");
1808 put_name(hptr->h_ofile);
1809 printf(" discarded.\n");
1812 hptr->h_type = type;
1813 hptr->h_ofile = ofile;
1814 hptr->h_value = value;
1816 // They're both global
1819 // Global exported by another ofile; warn and make this one extern
1822 printf("Duplicate symbol %s: ", sym);
1823 put_name(hptr->h_ofile);
1826 printf(" discarded\n");
1829 putword(sym + 8, ABST_EXTERN);
1831 // They're both common
1834 if (hptr->h_value < value)
1836 hptr->h_value = value;
1837 hptr->h_ofile = ofile;
1846 // Add the imported symbols from this file to unresolved, and the global and
1847 // common symbols to the exported hash table.
1849 // Change old-style commons (type == T_EXTERN, value != 0) to new-style ones
1850 // (type == (T_GLOBAL | T_EXTERN)).
1852 int add_symbols(struct OFILE * Ofile)
1854 long nsymbols; // Number of symbols in object file
1855 char * ptr; // Object data base pointer
1856 char * sfix; // Symbol fixup table pointer
1857 char * sstr; // Symbol string table pointer
1858 long index; // String index
1859 long type; // Symbol type
1860 long value; // Symbol value
1861 struct HREC * hptr; // Hash record pointer
1862 char symbol[SYMLEN];
1865 printf("Add symbols for file %s\n", Ofile->o_name);
1867 ptr = Ofile->o_image + 32 // Get base pointer, start of sym fixups
1868 + Ofile->o_header.tsize
1869 + Ofile->o_header.dsize
1870 + Ofile->o_header.absrel.reloc.tsize
1871 + Ofile->o_header.absrel.reloc.dsize;
1872 sfix = ptr; // Set symbol fixup pointer
1873 sstr = sfix + Ofile->o_header.ssize; // Set symbol table pointer
1874 nsymbols = Ofile->o_header.ssize / 12; // Obtain number of symbols
1878 index = getlong(sfix); // Get symbol string index
1879 type = getlong(sfix + 4); // Get symbol type
1880 value = getlong(sfix + 8); // Get symbol value
1881 memset(symbol, 0, SYMLEN);
1882 strcpy(symbol, sstr + index);
1884 // If this is a global/external
1889 // Then add to hash table
1890 if (hash_add(symbol, type, value, Ofile))
1892 return 1; // Error if addition failed
1897 // If value is zero and in hash table
1898 if ((hptr = lookup(symbol)) != NULL)
1900 hptr->h_ofile->o_flags |= O_USED; // Mark symbol as used
1902 // Otherwise add to unresolved list
1903 else if (add_unresolved(symbol, Ofile))
1905 return 1; // Error if addition failed
1910 sfix += 12; // Increment symbol fixup pointer
1911 nsymbols--; // Decrement num of symbols to process
1914 // Success loading symbols
1920 // Process Object File for Symbols
1922 int doobj(char * fname, char * ptr, char * aname, int flags)
1924 struct OFILE * Ofile; // Object record pointer
1925 char * temp; // Temporary data pointer
1927 // Allocate memory for object record ptr
1928 if ((Ofile = new_ofile()) == NULL)
1930 printf("Out of memory processing %s\n",fname);
1934 // Starting after all pathnames, etc., copy .o file name to Ofile
1935 temp = path_tail(fname);
1937 // Check filename length
1938 if (strlen(temp) > FNLEN - 1)
1940 printf("File name too long: %s\n", temp);
1944 // Check archive name length
1945 if (strlen(aname) > FNLEN - 1)
1947 printf("Archive name too long: %s\n", aname);
1951 strcpy(Ofile->o_name, temp); // Store filename
1952 strcpy(Ofile->o_arname, aname); // Store archive name
1954 Ofile->o_next = NULL; // Initialise object record information
1958 Ofile->o_flags = flags;
1959 Ofile->o_image = ptr;
1961 // Don't do anything if this is just an ARCHIVE marker, just add the file
1963 if (!(flags & O_ARCHIVE))
1965 Ofile->o_header.magic = getlong(ptr);
1966 Ofile->o_header.tsize = getlong(ptr+4);
1967 Ofile->o_header.dsize = getlong(ptr+8);
1968 Ofile->o_header.bsize = getlong(ptr+12);
1969 Ofile->o_header.ssize = getlong(ptr+16);
1970 Ofile->o_header.absrel.reloc.tsize = getlong(ptr+24);
1971 Ofile->o_header.absrel.reloc.dsize = getlong(ptr+28);
1973 // Round BSS off to alignment boundary
1974 Ofile->o_header.bsize = (Ofile->o_header.bsize + secalign) & ~secalign;
1976 if ((Ofile->o_header.dsize & 7) && wflag)
1978 printf("Warning: data segment size of ");
1980 printf(" is not a phrase multiple\n");
1983 // Check for odd segment sizes
1984 if ((Ofile->o_header.tsize & 1) || (Ofile->o_header.dsize & 1)
1985 || (Ofile->o_header.bsize & 1))
1987 printf("Error: odd-sized segment in ");
1989 printf("; link aborted.\n");
1993 if (add_symbols(Ofile))
1997 // Add this file to the olist
2001 olast->o_next = Ofile;
2009 // Remove Elements from Unresolved List which are Resolvable
2013 struct HREC * uptr; // Unresolved hash record pointer
2014 struct HREC * prev = NULL; // Previous hash record pointer
2015 struct HREC * htemp; // Temporary hash record pointer
2016 struct OFILE * ptemp; // Temporary object file record pointer
2018 // Process object file list
2019 while (plist != NULL)
2021 if (doobj(plist->o_name, plist->o_image, plist->o_arname, plist->o_flags))
2025 plist = plist->o_next;
2029 // Process unresolved list
2030 for(uptr=unresolved; uptr!=NULL; )
2033 printf("lookup(%s) => ",uptr->h_sym);
2035 if ((htemp = lookup(uptr->h_sym)) != NULL)
2038 printf("%s in %s (=$%06X)\n", isglobal(htemp->h_type) ? "global" : "common", htemp->h_ofile->o_name, htemp->h_value);
2040 htemp->h_ofile->o_flags |= O_USED;
2044 unresolved = uptr->h_next;
2050 prev->h_next = uptr->h_next;
2052 uptr = prev->h_next;
2059 uptr = uptr->h_next;
2068 // Extract Filename from Path
2070 char * path_tail(char * name)
2072 // char * temp = MAX(strrchr(name, '/'), MAX(strrchr(name, ':'), strrchr(name, '\\')));
2073 char * temp = strrchr(name, PATH_DELIMITER);
2075 // Return what was passed in if path delimiter was not found
2084 // Add Input File to Processing List
2086 int pladd(char * ptr, char * fname)
2090 plist = new_ofile(); // First time object record allocation
2091 plast = plist; // Update last object record pointer
2095 plast->o_next = new_ofile(); // Next object record allocation
2096 plast = plast->o_next; // Update last object record pointer
2101 printf("Out of memory.\n"); // Error if memory allocation fails
2105 if (strlen(path_tail(fname)) > FNLEN - 1)
2107 // Error on excessive filename length
2108 printf("File name too long: %s (sorry!)\n", fname);
2112 strcpy(plast->o_name, path_tail(fname)); // Store filename, not path
2113 *plast->o_arname = 0; // No archive name for this file
2114 plast->o_image = ptr; // Store data pointer
2115 plast->o_flags = O_USED; // File is used
2116 plast->o_next = NULL; // Initialise next record pointer
2118 return 0; // Return without errors
2123 // Process in Binary Include Files and Add them to the Processing List. This
2124 // routine takes in the binary file and creates an 'object' file in memory.
2125 // Sym1/Sym2 point to the start and end of data.
2127 // Image size for include files is:
2128 // Header ....... 32 bytes
2129 // Data ......... dsize
2130 // Sym Fixups ... 2 * 12 bytes
2131 // Symbol Size .. 4 bytes (Value to include symbols and terminating null)
2132 // Symbols ...... (strlen(sym1) + 1) + (strlen(sym2) + 1)
2133 // Terminate .... 4 bytes (0x00000000)
2135 int doinclude(char * fname, int handle, char * sym1, char * sym2, int segment)
2137 long fsize, dsize, size; // File, DATA segment and image sizes
2138 char * ptr, * sptr; // Data pointers
2140 int sym1len = 0; // Symbol 1 length
2141 int sym2len = 0; // Symbol 2 length
2142 unsigned symtype = 0;
2144 fsize = FSIZE(handle); // Get size of include file
2145 dsize = (fsize + secalign) & ~secalign; // Round up to a alignment boundary
2147 sym1len = strlen(sym1) + 1; // Get sym1 length + null termination
2148 sym2len = strlen(sym2) + 1; // Get sym2 length + null termination
2150 size = 32 + dsize + 24 + 4 + sym1len + sym2len + 4;
2152 // Use calloc so the header & fixups initialize to zero
2153 // Allocate object image memory
2154 if ((ptr = calloc(size, 1L)) == NULL)
2156 printf("Out of memory while including %s\n", fname);
2161 // Read in binary data
2162 if (read(handle, ptr + 32, fsize) != fsize)
2164 printf("File read error on %s\n", fname);
2170 close(handle); // Close file
2172 strcpy(obj_fname[obj_index], path_tail(fname));
2174 // Build this image's dummy header
2175 putlong(ptr, 0x00000107); // Magic number
2179 putlong(ptr+4, dsize); // Text size
2180 putlong(ptr+8, 0L); // Data size
2181 symtype = 0x05000000;
2182 obj_segsize[obj_index][0] = dsize;
2183 obj_segsize[obj_index][1] = 0;
2184 obj_segsize[obj_index][2] = 0;
2188 putlong(ptr+4, 0L); // Text size
2189 putlong(ptr+8, dsize); // Data size
2190 symtype = 0x07000000;
2191 obj_segsize[obj_index][0] = 0;
2192 obj_segsize[obj_index][1] = dsize;
2193 obj_segsize[obj_index][2] = 0;
2196 obj_index++; // Increment object count
2198 putlong(ptr+12, 0L); // BSS size
2199 putlong(ptr+16, 24); // Symbol table size
2200 putlong(ptr+20, 0L); // Entry point
2201 putlong(ptr+24, 0L); // TEXT relocation size
2202 putlong(ptr+28, 0L); // DATA relocation size
2204 sptr = ptr + 32 + dsize; // Set sptr to symbol table location
2206 putlong(sptr, 4L); // String offset of symbol1
2207 putlong(sptr+4, symtype); // Symbol type
2208 putlong(sptr+8, 0x00000000); // Symbol has no value (START)
2209 putlong(sptr+12, 4L + (sym2len-1)); // String offset of symbol2
2210 putlong(sptr+16, symtype); // Symbol type
2211 putlong(sptr+20, dsize); // Symbol is data size (END)
2213 sptr = ptr + 32 + dsize + 24; // Set sptr to symbol table size loc
2215 putlong(sptr, sym1len + 4L); // Size of symbol table
2217 sptr = ptr + 32 + dsize + 24 + 4; // Set sptr to symbol table location
2219 for(i=0; i<(sym1len-1); i++) // Write symbol1 to string table
2222 sptr += (sym1len-1); // Step past symbol string
2223 *sptr = '\0'; // Terminate symbol string
2224 sptr += 1; // Step past termination
2226 for(i=0; i<(sym2len-1); i++) // Write symbol2 to string table
2229 sptr += (sym2len-1); // Step past symbol string
2230 *sptr = '\0'; // Terminate symbol string
2231 sptr += 1; // Step past termination
2233 putlong(sptr, 0L); // Terminating long for object file
2235 return pladd(ptr, fname);
2240 // Takes a file name, gets in its image, puts it on plist. The image may
2241 // already be in memory: If so, the ptr arg is non-null. If so, the file is
2242 // already closed. Note that the file is already open (from dofile()). RETURNS
2243 // a pointer to the OFILE structure for this file, so you can diddle its flags
2244 // (dofile sets O_USED for files on the command line).
2246 int doobject(char * fname, int fd, char * ptr)
2248 long size; // File size
2252 size = FSIZE(fd); // Get size of input object file
2254 // Allocate memory for file data
2255 if ((ptr = malloc(size)) == NULL)
2257 printf("Out of memory while processing %s\n", fname);
2262 // Read in file data
2263 if (read(fd, ptr, size) != size)
2265 printf("File read error on %s\n", fname);
2271 // SCPCD : get the name of the file instead of all pathname
2272 strcpy(obj_fname[obj_index], path_tail(fname));
2273 obj_segsize[obj_index][0] = (getlong(ptr + 4) + secalign) & ~secalign;
2274 obj_segsize[obj_index][1] = (getlong(ptr + 8) + secalign) & ~secalign;
2275 obj_segsize[obj_index][2] = (getlong(ptr + 12) + secalign) & ~secalign;
2278 close(fd); // Close file
2281 // Now add this image to the list of pending ofiles (plist)
2282 // This routine is shared by doinclude after it builds the image
2283 return pladd(ptr, fname);
2288 // Process In Outstanding Object Files
2290 int flush_handles(void)
2293 char magic[4]; // Magic header number
2296 // Process all handles
2297 for(i=0; i<(int)hd; i++)
2299 // Verbose mode information
2302 printf("Read file %s%s\n", name[i], hflag[i] ? " (include)" : "");
2306 { // Attempt to read file magic number
2308 if (read(handle[i], magic, 4) != 4)
2310 printf("Error reading file %s\n", name[i]);
2315 lseek(handle[i], 0L, 0); // Reset to start of input file
2316 // test = getlong(magic); printf("Magic Number is 0x%08X\n", test);
2318 // Look for RMAC/MAC/GCC ($20107) object files
2319 if ((getlong(magic) == 0x00000107) || (getlong(magic) == 0x00020107))
2321 // Process input object file
2322 if (doobject(name[i], handle[i], 0L))
2327 // Close file and error
2328 printf("%s is not a supported object file\n", name[i]);
2336 // If hflag[i] is 1, include this in the data segment; if 2, put it
2338 if (doinclude(name[i], handle[i], hsym1[i], hsym2[i], hflag[i] - 1))
2343 // Free include, symbol & object handles
2344 for(i=0; i<(int)hd; i++)
2355 // Reset next handle indicator
2362 // Load newargv with Pointers to Arguments Found in the Buffer
2364 int parse(char * buf, char * newargv[])
2369 printf("begin parsing\n");
2373 while (*buf && strchr(",\t\n\r\14 ", *buf))
2377 if (*buf == '\0' || *buf == 26)
2381 printf("No commands in command file\n");
2390 /* test for comment */
2393 /* found a comment; skip to next \n and start over */
2394 while (*buf && *buf != '\n')
2402 printf("Too many arguments in command file\n");
2408 while (!strchr(",\t\n\r\14 ", *buf))
2410 if (*buf == '\0' || *buf == 26)
2412 printf("Finished parsing %d args\n", i);
2422 printf("argv[%d] = \"%s\"\n", i, newargv[i]);
2430 // Process in a Link Command File
2432 int docmdfile(char * fname)
2434 int fd; // File descriptor
2435 unsigned size; // Command file size
2436 char * ptr; // Pointer
2437 int newargc; // New argument count
2438 char * (*newargv)[]; // New argument value array
2440 // Verbose information
2442 printf("docmdfile(%s)\n", fname);
2444 // Allocate memory for new argument values
2445 newargv = malloc((long)(sizeof(char *) * MAXARGS));
2449 printf("Out of memory.\n");
2453 // Attempt to open and read in the command file
2456 if ((fd = open(fname, _OPEN_FLAGS)) < 0)
2458 printf("Cannot open command file %s.\n", fname);
2464 if ((ptr = malloc(size + 1)) == NULL)
2466 printf("Out of memory.\n");
2471 if (read(fd, ptr, size) != (int)size)
2473 printf("Read error on command file %s.\n", fname);
2478 *(ptr + size) = 0; // Null terminate the buffer
2483 printf("No command filename specified\n");
2487 // Parse the command file
2488 if ((newargc = parse(ptr, *newargv)) == -1)
2493 // Process the inputted flags
2494 if (doargs(newargc, *newargv))
2496 printf("docmdfile: doargs returns TRUE\n");
2508 // Take an Argument List and Parse the Command Line
2510 int doargs(int argc, char * argv[])
2512 int i = 1; // Iterator
2513 int c; // Command line character
2514 char * ifile, * isym; // File name and symbol name for -i
2516 // Parse through option switches & files
2519 // Process command line switches
2520 if (argv[i][0] == '-')
2524 printf("Illegal option argument: %s\n\n", argv[i]);
2529 c = argv[i++][1]; // Get next character in command line
2531 // Process command line switch
2534 case '?': // Display usage information
2541 case 'A': // Set absolute linking on
2547 printf("Not enough arguments to -a\n");
2551 aflag = 1; // Set abs link flag
2552 // Segment order is TEXT, DATA, BSS
2553 // Text segment can be 'r', 'x' or a value
2556 if ((*argv[i] == 'r' || *argv[i] == 'R') && !argv[i][1])
2558 ttype = -1; // TEXT segment is relocatable
2560 else if ((*argv[i] == 'x' || *argv[i] == 'X'))
2562 printf("Error in text-segment address: cannot be contiguous\n");
2565 else if ((ttype = 0), getval(argv[i], &tval))
2567 printf("Error in text-segment address: %s is not 'r', 'x' or an address.", argv[i]);
2572 // Data segment can be 'r', 'x' or a value
2575 if ((*argv[i] == 'r' || *argv[i] == 'R') && !argv[i][1])
2577 dtype = -1; // DATA segment is relocatable
2579 else if ((*argv[i] == 'x' || *argv[i] == 'X'))
2581 dtype = -2; // DATA follows TEXT
2583 else if ((dtype = 0), getval(argv[i],&dval))
2585 printf("Error in data-segment address: %s is not 'r', 'x' or an address.", argv[i]);
2592 // BSS segment can be 'r', 'x' or a value
2593 if ((*argv[i] == 'r' || *argv[i] == 'R') && !argv[i][1])
2595 btype = -1; // BSS segment is relocatable
2597 else if ((*argv[i] == 'x' || *argv[i] == 'X'))
2599 btype = -3; // BSS follows DATA
2601 else if ((btype = 0), getval(argv[i],&bval))
2603 printf("Error in bss-segment address: %s is not 'r', 'x[td]', or an address.", argv[i]);
2610 case 'B': // Don't remove muliply defined locals
2617 case 'C': // Process a command file
2620 printf("Not enough arguments to -c\n");
2624 if (docmdfile(argv[i++]))
2631 case 'D': // Wait for "return" before exiting
2639 case 'E': // Output COFF (absolute only)
2643 case 'G': // Output source level debugging
2644 printf("\'g\' flag not currently implemented\n");
2647 if (gflag) warn('g', 1);
2652 case 'I': // Include binary file
2655 printf("Not enough arguments to -i\n");
2662 // handle -ii (No truncation)
2663 if ((argv[i-3][2] == 'i') || (argv[i-3][2] == 'I'))
2666 printf("warning: (-ii) COFF format output not specified\n");
2668 // handle -i (Truncation)
2671 if (strlen(isym) > 7)
2675 // Place include files in the DATA segment only
2676 if (dofile(ifile, DSTSEG_D, isym))
2681 case 'L': // Add local symbols
2688 case 'M': // Produce load symbol map
2695 case 'N': // Output no header to .abs file
2702 case 'O': // Specify an output file
2710 printf("No output filename following -o switch\n");
2714 if (strlen(argv[i]) > FARGSIZE - 5)
2716 printf("Output file name too long (sorry!)\n");
2720 strcpy(ofile, argv[i++]);
2723 case 'R': // Section alignment size
2729 switch (argv[i-1][2])
2731 case 'w': case 'W': secalign = 1; break; // Word alignment
2732 case 'l': case 'L': secalign = 3; break; // Long alignment
2733 case 'p': case 'P': secalign = 7; break; // Phrase alignment
2734 case 'd': case 'D': secalign = 15; break; // Double phrase alignment
2735 case 'q': case 'Q': secalign = 31; break; // Quad phrase alignment
2736 default: secalign = 7; break; // Default phrase alignment
2741 case 'S': // Output only global symbols
2748 case 'V': // Verbose information
2749 if (!vflag && !versflag)
2757 case 'W': // Show warnings flag
2764 case 'Z': // Suppress banner flag
2771 printf("unknown option argument `%c'\n", c);
2777 // Not a switch, then process as a file
2778 if (dofile(argv[i++], 0, NULL))
2783 if (!oflag && vflag)
2785 strcpy(ofile, "output");
2786 printf("Output file is %s[.ext]\n", ofile);
2790 printf("Output file is %s\n", ofile);
2795 // No problems encountered
2801 // Display Version Information
2803 void display_version(void)
2805 if (displaybanner)// && vflag)
2807 printf("\nReboot's Linker for Atari Jaguar\n");
2808 printf("Copyright (c) 199x Allan K. Pratt, 2014 Reboot\n");
2809 printf("V%i.%i.%i %s (%s)\n\n", MAJOR, MINOR, PATCH, __DATE__, PLATFORM);
2815 // Display Command Line Help
2817 void display_help(void)
2820 printf(" %s [-options] file(s)\n", cmdlnexec);
2822 printf("Options:\n");
2823 printf(" -? or -h display usage information\n");
2824 printf(" -a <text> <data> <bss> output absolute file\n");
2825 printf(" hex value: segment address\n");
2826 printf(" r: relocatable segment\n");
2827 printf(" x: contiguous segment\n");
2828 printf(" -b don't remove multiply defined local labels\n");
2829 printf(" -c <fname> add contents of <fname> to command line\n");
2830 printf(" -d wait for key after link\n");
2831 printf(" -e output COF absolute file\n");
2832 printf(" -g output source-level debugging\n");
2833 printf(" -i <fname> <label> incbin <fname> and set <label>\n");
2834 printf(" -l add local symbols\n");
2835 printf(" -m produce load symbols map\n");
2836 printf(" -n output no file header to .abs file\n");
2837 printf(" -o <fname> set output name\n");
2838 printf(" -r<size> section alignment size\n");
2839 printf(" w: word (2 bytes)\n");
2840 printf(" l: long (4 bytes)\n");
2841 printf(" p: phrase (8 bytes, default alignment)\n");
2842 printf(" d: double phrase (16 bytes)\n");
2843 printf(" q: quad phrase (32 bytes)\n");
2844 printf(" -s output only global symbols\n");
2845 printf(" -v set verbose mode\n");
2846 printf(" -w show linker warnings\n");
2847 printf(" -z suppress banner\n");
2859 // Display link status if verbose mode
2861 printf("Link %s.\n", errflag ? "aborted" : "complete");
2863 // Wait for return key if requested
2866 printf("\nPress the [RETURN] key to continue. ");
2867 fgets(tempbuf, 128, stdin);
2875 // Determine Processor Endianess
2877 int get_endianess(void)
2880 char * p = (char *)&i;
2883 return ENDIANNESS_LITTLE;
2885 return ENDIANNESS_BIG;
2890 // Application Code Starts Here
2892 int main(int argc, char * argv[])
2894 char * s = NULL; // String pointer for "getenv"
2895 struct HREC * utemp; // Temporary hash record pointer
2896 struct OHEADER * header; // Pointer to output header structure
2898 endian = get_endianess(); // Get processor endianess
2899 cmdlnexec = argv[0]; // Obtain executable name
2900 s = getenv("RLNPATH");
2902 if (s) // Attempt to obtain env variable
2903 strcpy(libdir, s); // Store it if found
2905 // Parse the command line
2906 if (doargs(argc, argv))
2912 if (!zflag && !vflag)
2914 display_version(); // Display version information
2915 versflag = 1; // We've dumped the version banner
2918 // Process in specified files/objects
2919 if (flush_handles())
2925 // Remove elements from unresolved list
2932 // Check that there is something to link
2939 // Report unresolved externals
2940 if (unresolved != NULL)
2942 printf("UNRESOLVED SYMBOLS\n");
2944 // Don't list them if two -u's or more
2949 while (utemp != NULL)
2951 printf("\t%s (",utemp->h_sym);
2952 put_name(utemp->h_ofile);
2954 utemp = utemp->h_next;
2965 // Make one output file from input objs
2966 if ((header = make_ofile()) == NULL)
2975 printf("TO DO:Partial linking\n");
2978 // Relocatable linking
2981 printf("TO DO:Relocatable linking\n");
2989 printf("Absolute linking ");
2998 printf("Header magic is 0x%04X\n", (unsigned int)header->magic);
3000 if (write_ofile(header))
3004 if (mflag) // Display the loaded symbols map
3005 if (write_map(header))
3008 // Display segment size summary
3012 printf("+---------+----------+----------+----------+\n");
3013 printf("| Segment | TEXT | DATA | BSS |\n");
3014 printf("| Sizes |----------+----------+----------|\n");
3015 printf("| (Hex) | %8X | %8X | %8X |\n", (unsigned int)header->tsize, (unsigned int)header->dsize, (unsigned int)header->bsize);
3016 printf("+---------+----------+----------+----------+\n\n");
3019 //printf("BIG_ENDIAN = %i, LITTLE_ENDIAN = %i\n", BIG_ENDIAN, LITTLE_ENDIAN);
3021 free(header); // Free allocated memory
3022 rln_exit(); // Perform application exit