1 /* ------------------------------------------------------------------------- */
2 /* "files" : File handling for source code, the transcript file and the */
3 /* debugging information file; file handling and splicing of */
6 /* Note that filenaming conventions are left to the top-level */
7 /* routines in "inform.c", since they are tied up with ICL */
8 /* settings and are very host OS-dependent. */
10 /* Copyright (c) Graham Nelson 1993 - 2020 */
12 /* This file is part of Inform. */
14 /* Inform is free software: you can redistribute it and/or modify */
15 /* it under the terms of the GNU General Public License as published by */
16 /* the Free Software Foundation, either version 3 of the License, or */
17 /* (at your option) any later version. */
19 /* Inform is distributed in the hope that it will be useful, */
20 /* but WITHOUT ANY WARRANTY; without even the implied warranty of */
21 /* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the */
22 /* GNU General Public License for more details. */
24 /* You should have received a copy of the GNU General Public License */
25 /* along with Inform. If not, see https://gnu.org/licenses/ */
27 /* ------------------------------------------------------------------------- */
31 int total_files; /* Number of files so far, including
32 #include and #origsource files */
33 int total_input_files; /* Number of source files so far
34 (excludes #origsource) */
35 int current_input_file; /* Most recently-opened source file */
36 static int current_origsource_file; /* Most recently-used #origsource */
38 int32 total_chars_read; /* Characters read in (from all
39 source files put together) */
41 static int checksum_low_byte, /* For calculating the Z-machine's */
42 checksum_high_byte; /* "verify" checksum */
44 static int32 checksum_long; /* For the Glulx checksum, */
45 static int checksum_count; /* similarly */
47 /* ------------------------------------------------------------------------- */
48 /* Most of the information about source files is kept by "lexer.c"; this */
49 /* level is only concerned with file names and handles. */
50 /* ------------------------------------------------------------------------- */
52 FileId *InputFiles=NULL; /* Ids for all the source files */
53 static char *filename_storage, /* Translated filenames */
55 static int filename_storage_left;
57 /* ------------------------------------------------------------------------- */
58 /* When emitting debug information, we won't have addresses of routines, */
59 /* sequence points, Glulx objects (addresses of Z-machine objects aren't */
60 /* needed), globals, arrays, or grammar lines. We only have their */
61 /* offsets from base addresses, which won't be known until the end of */
62 /* compilation. Since everything else in the relevant debug records is */
63 /* known much earlier and is less convenient to store up, we emit the */
64 /* debug records with a placeholder value and then backpatch these */
65 /* placeholders. The following structs each store either an offset or a */
66 /* symbol index and the point in the debug information file where the */
67 /* corresponding address should be written once the base address is known. */
68 /* ------------------------------------------------------------------------- */
70 #define INITIAL_DEBUG_INFORMATION_BACKPATCH_ALLOCATION 65536
72 typedef struct value_and_backpatch_position_struct
74 fpos_t backpatch_position;
75 } value_and_backpatch_position;
77 typedef struct debug_backpatch_accumulator_struct
78 { int32 number_of_values_to_backpatch;
79 int32 number_of_available_backpatches;
80 value_and_backpatch_position *values_and_backpatch_positions;
81 int32 (* backpatching_function)(int32);
82 } debug_backpatch_accumulator;
84 static debug_backpatch_accumulator object_backpatch_accumulator;
85 static debug_backpatch_accumulator packed_code_backpatch_accumulator;
86 static debug_backpatch_accumulator code_backpatch_accumulator;
87 static debug_backpatch_accumulator global_backpatch_accumulator;
88 static debug_backpatch_accumulator array_backpatch_accumulator;
89 static debug_backpatch_accumulator grammar_backpatch_accumulator;
91 /* ------------------------------------------------------------------------- */
92 /* File handles and names for temporary files. */
93 /* ------------------------------------------------------------------------- */
95 FILE *Temp1_fp=NULL, *Temp2_fp=NULL, *Temp3_fp=NULL;
96 char Temp1_Name[PATHLEN], Temp2_Name[PATHLEN], Temp3_Name[PATHLEN];
98 /* ------------------------------------------------------------------------- */
99 /* Opening and closing source code files */
100 /* ------------------------------------------------------------------------- */
102 #if defined(PC_WIN32) && defined(HAS_REALPATH)
104 char *realpath(const char *path, char *resolved_path)
106 return GetFullPathNameA(path,PATHLEN,resolved_path,NULL) != 0 ? resolved_path : 0;
110 extern void load_sourcefile(char *filename_given, int same_directory_flag)
112 /* Meaning: open a new file of Inform source. (The lexer picks up on
113 this by noticing that input_file has increased.) */
117 char absolute_name[PATHLEN];
122 if (total_files == MAX_SOURCE_FILES)
123 memoryerror("MAX_SOURCE_FILES", MAX_SOURCE_FILES);
126 { x = translate_in_filename(x, name, filename_given, same_directory_flag,
127 (total_files==0)?1:0);
128 handle = fopen(name,"r");
129 } while ((handle == NULL) && (x != 0));
131 if (filename_storage_left <= (int)strlen(name))
132 memoryerror("MAX_SOURCE_FILES", MAX_SOURCE_FILES);
134 filename_storage_left -= strlen(name)+1;
135 strcpy(filename_storage_p, name);
136 InputFiles[total_files].filename = filename_storage_p;
138 filename_storage_p += strlen(name)+1;
140 if (debugfile_switch)
141 { debug_file_printf("<source index=\"%d\">", total_files);
142 debug_file_printf("<given-path>");
143 debug_file_print_with_entities(filename_given);
144 debug_file_printf("</given-path>");
146 if (realpath(name, absolute_name))
147 { debug_file_printf("<resolved-path>");
148 debug_file_print_with_entities(absolute_name);
149 debug_file_printf("</resolved-path>");
152 debug_file_printf("<language>Inform 6</language>");
153 debug_file_printf("</source>");
156 InputFiles[total_files].handle = handle;
157 if (InputFiles[total_files].handle==NULL)
158 fatalerror_named("Couldn't open source file", name);
160 InputFiles[total_files].is_input = TRUE;
162 if (line_trace_level > 0) printf("\nOpening file \"%s\"\n",name);
166 current_input_file = total_files;
169 static void close_sourcefile(int file_number)
171 if (InputFiles[file_number-1].handle == NULL) return;
173 /* Close this file. */
175 if (ferror(InputFiles[file_number-1].handle))
176 fatalerror_named("I/O failure: couldn't read from source file",
177 InputFiles[file_number-1].filename);
179 fclose(InputFiles[file_number-1].handle);
181 InputFiles[file_number-1].handle = NULL;
183 if (line_trace_level > 0) printf("\nClosing file\n");
186 extern void close_all_source(void)
188 for (i=0; i<total_files; i++) close_sourcefile(i+1);
191 /* ------------------------------------------------------------------------- */
192 /* Register an #origsource filename. This goes in the InputFiles table, */
193 /* but we do not open the file or advance current_input_file. */
194 /* ------------------------------------------------------------------------- */
196 extern int register_orig_sourcefile(char *filename)
200 /* If the filename has already been used as an origsource filename,
201 return that entry. We check the most-recently-used file first, and
202 then search the list. */
203 if (current_origsource_file > 0 && current_origsource_file <= total_files) {
204 if (!strcmp(filename, InputFiles[current_origsource_file-1].filename))
205 return current_origsource_file;
208 for (ix=0; ix<total_files; ix++) {
209 if (InputFiles[ix].is_input)
211 if (!strcmp(filename, InputFiles[ix].filename)) {
212 current_origsource_file = ix+1;
213 return current_origsource_file;
217 /* This filename has never been used before. Allocate a new InputFiles
220 char *name = filename; /* no translation */
222 if (total_files == MAX_SOURCE_FILES)
223 memoryerror("MAX_SOURCE_FILES", MAX_SOURCE_FILES);
225 if (filename_storage_left <= (int)strlen(name))
226 memoryerror("MAX_SOURCE_FILES", MAX_SOURCE_FILES);
228 filename_storage_left -= strlen(name)+1;
229 strcpy(filename_storage_p, name);
230 InputFiles[total_files].filename = filename_storage_p;
232 filename_storage_p += strlen(name)+1;
234 if (debugfile_switch)
235 { debug_file_printf("<source index=\"%d\">", total_files);
236 debug_file_printf("<given-path>");
237 debug_file_print_with_entities(filename);
238 debug_file_printf("</given-path>");
239 debug_file_printf("<language>Inform 7</language>");
240 debug_file_printf("</source>");
243 InputFiles[total_files].handle = NULL;
244 InputFiles[total_files].is_input = FALSE;
247 current_origsource_file = total_files;
248 return current_origsource_file;
251 /* ------------------------------------------------------------------------- */
252 /* Feeding source code up into the lexical analyser's buffer */
253 /* (see "lexer.c" for its specification) */
254 /* ------------------------------------------------------------------------- */
256 extern int file_load_chars(int file_number, char *buffer, int length)
258 int read_in; FILE *handle;
260 if (file_number-1 > total_files)
261 { buffer[0] = 0; return 1; }
263 handle = InputFiles[file_number-1].handle;
265 { buffer[0] = 0; return 1; }
267 read_in = fread(buffer, 1, length, handle);
268 total_chars_read += read_in;
270 if (read_in == length) return length;
272 close_sourcefile(file_number);
274 if (file_number == 1)
275 { buffer[read_in] = 0;
276 buffer[read_in+1] = 0;
277 buffer[read_in+2] = 0;
278 buffer[read_in+3] = 0;
281 { buffer[read_in] = '\n';
282 buffer[read_in+1] = ' ';
283 buffer[read_in+2] = ' ';
284 buffer[read_in+3] = ' ';
287 return(-(read_in+4));
290 /* ------------------------------------------------------------------------- */
291 /* Final assembly and output of the story file/module. */
292 /* ------------------------------------------------------------------------- */
296 static void sf_put(int c)
300 /* The checksum is the unsigned sum mod 65536 of the bytes in the
301 story file from 0x0040 (first byte after header) to the end.
303 The link data does not contribute to the checksum of a module. */
305 checksum_low_byte += c;
306 if (checksum_low_byte>=256)
307 { checksum_low_byte-=256;
308 if (++checksum_high_byte==256) checksum_high_byte=0;
314 /* The checksum is the unsigned 32-bit sum of the entire story file,
315 considered as a list of 32-bit words, with the checksum field
318 switch (checksum_count) {
320 checksum_long += (((int32)(c & 0xFF)) << 24);
323 checksum_long += (((int32)(c & 0xFF)) << 16);
326 checksum_long += (((int32)(c & 0xFF)) << 8);
329 checksum_long += ((int32)(c & 0xFF));
333 checksum_count = (checksum_count+1) & 3;
340 /* Recursive procedure to generate the Glulx compression table. */
342 static void output_compression(int entnum, int32 *size, int *count)
344 huffentity_t *ent = &(huff_entities[entnum]);
354 val = Write_Strings_At + huff_entities[ent->u.branch[0]].addr;
355 sf_put((val >> 24) & 0xFF);
356 sf_put((val >> 16) & 0xFF);
357 sf_put((val >> 8) & 0xFF);
358 sf_put((val) & 0xFF);
360 val = Write_Strings_At + huff_entities[ent->u.branch[1]].addr;
361 sf_put((val >> 24) & 0xFF);
362 sf_put((val >> 16) & 0xFF);
363 sf_put((val >> 8) & 0xFF);
364 sf_put((val) & 0xFF);
366 output_compression(ent->u.branch[0], size, count);
367 output_compression(ent->u.branch[1], size, count);
377 cx = (char *)abbreviations_at + ent->u.val*MAX_ABBREV_LENGTH;
387 val = unicode_usage_entries[ent->u.val].ch;
388 sf_put((val >> 24) & 0xFF);
389 sf_put((val >> 16) & 0xFF);
390 sf_put((val >> 8) & 0xFF);
391 sf_put((val) & 0xFF);
395 val = abbreviations_offset + 4 + ent->u.val*4;
396 sf_put((val >> 24) & 0xFF);
397 sf_put((val >> 16) & 0xFF);
398 sf_put((val >> 8) & 0xFF);
399 sf_put((val) & 0xFF);
405 static void output_file_z(void)
406 { FILE *fin=NULL; char new_name[PATHLEN];
407 int32 length, blanks=0, size, i, j, offset;
408 uint32 code_length, size_before_code, next_cons_check;
413 /* At this point, construct_storyfile() has just been called. */
415 /* Enter the length information into the header. */
417 length=((int32) Write_Strings_At) + static_strings_extent;
418 if (module_switch) length += link_data_size +
419 zcode_backpatch_size +
420 zmachine_backpatch_size;
422 while ((length%length_scale_factor)!=0) { length++; blanks++; }
423 length=length/length_scale_factor;
424 zmachine_paged_memory[26]=(length & 0xff00)/0x100;
425 zmachine_paged_memory[27]=(length & 0xff);
427 /* To assist interpreters running a paged virtual memory system, Inform
428 writes files which are padded with zeros to the next multiple of
429 0.5K. This calculates the number of bytes of padding needed: */
431 while (((length_scale_factor*length)+blanks-1)%512 != 511) blanks++;
433 translate_out_filename(new_name, Code_Name);
435 sf_handle = fopen(new_name,"wb");
436 if (sf_handle == NULL)
437 fatalerror_named("Couldn't open output file", new_name);
440 /* Set the type and creator to Andrew Plotkin's MaxZip, a popular
441 Z-code interpreter on the Macintosh */
443 if (!module_switch) fsetfileinfo(new_name, 'mxZR', 'ZCOD');
446 /* (1) Output the paged memory. */
449 fputc(zmachine_paged_memory[i], sf_handle);
451 checksum_low_byte = 0;
452 checksum_high_byte = 0;
454 for (i=64; i<Write_Code_At; i++)
455 { sf_put(zmachine_paged_memory[i]); size++;
458 /* (2) Output the compiled code area. */
460 if (temporary_files_switch)
463 fin=fopen(Temp2_Name,"rb");
465 fatalerror("I/O failure: couldn't reopen temporary file 2");
468 if (!OMIT_UNUSED_ROUTINES) {
469 /* This is the old-fashioned case, which is easy. All of zcode_area
470 (zmachine_pc bytes) will be output. next_cons_check will be
471 ignored, because j will never reach it. */
472 code_length = zmachine_pc;
474 next_cons_check = code_length+1;
477 /* With dead function stripping, life is more complicated.
478 j will run from 0 to zmachine_pc, but only code_length of
479 those should be output. next_cons_check is the location of
480 the next function break; that's where we check whether
481 we're in a live function or a dead one.
482 (This logic is simplified by the assumption that a backpatch
483 marker will never straddle a function break.) */
484 if (zmachine_pc != df_total_size_before_stripping)
485 compiler_error("Code size does not match (zmachine_pc and df_total_size).");
486 code_length = df_total_size_after_stripping;
489 df_prepare_function_iterate();
491 size_before_code = size;
495 for (i=0; i<zcode_backpatch_size; i=i+3)
496 { int long_flag = TRUE;
498 = 256*read_byte_from_memory_block(&zcode_backpatch_table, i+1)
499 + read_byte_from_memory_block(&zcode_backpatch_table, i+2);
500 backpatch_error_flag = FALSE;
502 = read_byte_from_memory_block(&zcode_backpatch_table, i);
503 if (backpatch_marker >= 0x80) long_flag = FALSE;
504 backpatch_marker &= 0x7f;
505 offset = offset + (backpatch_marker/32)*0x10000;
506 while (offset+0x30000 < j) {
508 long_flag = !long_flag;
510 backpatch_marker &= 0x1f;
512 /* All code up until the next backpatch marker gets flushed out
513 as-is. (Unless we're in a stripped-out function.) */
516 while (j<offset && j<next_cons_check) {
517 /* get dummy value */
518 ((temporary_files_switch)?fgetc(fin):
519 read_byte_from_memory_block(&zcode_area, j));
524 while (j<offset && j<next_cons_check) {
526 sf_put((temporary_files_switch)?fgetc(fin):
527 read_byte_from_memory_block(&zcode_area, j));
531 if (j == next_cons_check)
532 next_cons_check = df_next_function_iterate(&use_function);
536 { int32 v = (temporary_files_switch)?fgetc(fin):
537 read_byte_from_memory_block(&zcode_area, j);
538 v = 256*v + ((temporary_files_switch)?fgetc(fin):
539 read_byte_from_memory_block(&zcode_area, j+1));
542 v = backpatch_value(v);
543 sf_put(v/256); sf_put(v%256);
548 { int32 v = (temporary_files_switch)?fgetc(fin):
549 read_byte_from_memory_block(&zcode_area, j);
552 v = backpatch_value(v);
558 if (j > next_cons_check)
559 compiler_error("Backpatch appears to straddle function break");
561 if (backpatch_error_flag)
562 { printf("*** %s zcode offset=%08lx backpatch offset=%08lx ***\n",
563 (long_flag)?"long":"short", (long int) j, (long int) i);
567 /* Flush out the last bit of zcode_area, after the last backpatch
569 offset = zmachine_pc;
572 while (j<offset && j<next_cons_check) {
573 /* get dummy value */
574 ((temporary_files_switch)?fgetc(fin):
575 read_byte_from_memory_block(&zcode_area, j));
580 while (j<offset && j<next_cons_check) {
582 sf_put((temporary_files_switch)?fgetc(fin):
583 read_byte_from_memory_block(&zcode_area, j));
587 if (j == next_cons_check)
588 next_cons_check = df_next_function_iterate(&use_function);
591 if (temporary_files_switch)
593 fatalerror("I/O failure: couldn't read from temporary file 2");
598 if (size_before_code + code_length != size)
599 compiler_error("Code output length did not match");
601 /* (3) Output any null bytes (required to reach a packed address)
602 before the strings area. */
604 while (size<Write_Strings_At) { sf_put(0); size++; }
606 /* (4) Output the static strings area. */
608 if (temporary_files_switch)
611 fin=fopen(Temp1_Name,"rb");
613 fatalerror("I/O failure: couldn't reopen temporary file 1");
614 for (i=0; i<static_strings_extent; i++) sf_put(fgetc(fin));
616 fatalerror("I/O failure: couldn't read from temporary file 1");
619 remove(Temp1_Name); remove(Temp2_Name);
622 for (i=0; i<static_strings_extent; i++) {
623 sf_put(read_byte_from_memory_block(&static_strings_area,i));
627 /* (5) Output the linking data table (in the case of a module). */
629 if (temporary_files_switch)
633 fin=fopen(Temp3_Name,"rb");
635 fatalerror("I/O failure: couldn't reopen temporary file 3");
636 for (j=0; j<link_data_size; j++) sf_put(fgetc(fin));
638 fatalerror("I/O failure: couldn't read from temporary file 3");
646 for (i=0; i<link_data_size; i++)
647 sf_put(read_byte_from_memory_block(&link_data_area,i));
650 { for (i=0; i<zcode_backpatch_size; i++)
651 sf_put(read_byte_from_memory_block(&zcode_backpatch_table, i));
652 for (i=0; i<zmachine_backpatch_size; i++)
653 sf_put(read_byte_from_memory_block(&zmachine_backpatch_table, i));
656 /* (6) Output null bytes to reach a multiple of 0.5K. */
658 while (blanks>0) { sf_put(0); blanks--; }
660 if (ferror(sf_handle))
661 fatalerror("I/O failure: couldn't write to story file");
663 fseek(sf_handle, 28, SEEK_SET);
664 fputc(checksum_high_byte, sf_handle);
665 fputc(checksum_low_byte, sf_handle);
667 if (ferror(sf_handle))
668 fatalerror("I/O failure: couldn't backtrack on story file for checksum");
672 /* Write a copy of the header into the debugging information file
673 (mainly so that it can be used to identify which story file matches
674 with which debugging info file). */
676 if (debugfile_switch)
677 { debug_file_printf("<story-file-prefix>");
678 for (i = 0; i < 63; i += 3)
680 { debug_file_print_base_64_triple
681 (zmachine_paged_memory[27],
685 { debug_file_print_base_64_triple
686 (zmachine_paged_memory[i],
687 zmachine_paged_memory[i + 1],
688 zmachine_paged_memory[i + 2]);
691 debug_file_print_base_64_single(zmachine_paged_memory[63]);
692 debug_file_printf("</story-file-prefix>");
696 { char settype_command[PATHLEN];
697 sprintf(settype_command, "settype %s %s",
698 new_name, riscos_file_type());
699 system(settype_command);
704 InformFiletypes (new_name, INF_MODULE_TYPE);
706 InformFiletypes (new_name, INF_ZCODE_TYPE);
710 static void output_file_g(void)
711 { FILE *fin=NULL; char new_name[PATHLEN];
712 int32 size, i, j, offset;
714 uint32 code_length, size_before_code, next_cons_check;
716 int first_byte_of_triple, second_byte_of_triple, third_byte_of_triple;
720 /* At this point, construct_storyfile() has just been called. */
722 translate_out_filename(new_name, Code_Name);
724 sf_handle = fopen(new_name,"wb+");
725 if (sf_handle == NULL)
726 fatalerror_named("Couldn't open output file", new_name);
729 /* Set the type and creator to Andrew Plotkin's MaxZip, a popular
730 Z-code interpreter on the Macintosh */
732 if (!module_switch) fsetfileinfo(new_name, 'mxZR', 'ZCOD');
738 /* Determine the version number. */
740 VersionNum = 0x00020000;
742 /* Increase for various features the game may have used. */
743 if (no_unicode_chars != 0 || (uses_unicode_features)) {
744 VersionNum = 0x00030000;
746 if (uses_memheap_features) {
747 VersionNum = 0x00030100;
749 if (uses_acceleration_features) {
750 VersionNum = 0x00030101;
752 if (uses_float_features) {
753 VersionNum = 0x00030102;
756 /* And check if the user has requested a specific version. */
757 if (requested_glulx_version) {
758 if (requested_glulx_version < VersionNum) {
759 static char error_message_buff[256];
760 sprintf(error_message_buff, "Version 0x%08lx requested, but \
761 game features require version 0x%08lx", (long)requested_glulx_version, (long)VersionNum);
762 warning(error_message_buff);
765 VersionNum = requested_glulx_version;
769 /* (1) Output the header. We use sf_put here, instead of fputc,
770 because the header is included in the checksum. */
777 /* Version number. */
778 sf_put((VersionNum >> 24));
779 sf_put((VersionNum >> 16));
780 sf_put((VersionNum >> 8));
781 sf_put((VersionNum));
783 sf_put((Write_RAM_At >> 24));
784 sf_put((Write_RAM_At >> 16));
785 sf_put((Write_RAM_At >> 8));
786 sf_put((Write_RAM_At));
787 /* EXTSTART, or game file size */
788 sf_put((Out_Size >> 24));
789 sf_put((Out_Size >> 16));
790 sf_put((Out_Size >> 8));
792 /* ENDMEM, which the game file size plus MEMORY_MAP_EXTENSION */
793 i = Out_Size + MEMORY_MAP_EXTENSION;
799 sf_put((MAX_STACK_SIZE >> 24));
800 sf_put((MAX_STACK_SIZE >> 16));
801 sf_put((MAX_STACK_SIZE >> 8));
802 sf_put((MAX_STACK_SIZE));
803 /* Initial function to call. Inform sets things up so that this
804 is the start of the executable-code area. */
805 sf_put((Write_Code_At >> 24));
806 sf_put((Write_Code_At >> 16));
807 sf_put((Write_Code_At >> 8));
808 sf_put((Write_Code_At));
809 /* String-encoding table. */
810 sf_put((Write_Strings_At >> 24));
811 sf_put((Write_Strings_At >> 16));
812 sf_put((Write_Strings_At >> 8));
813 sf_put((Write_Strings_At));
814 /* Checksum -- zero for the moment. */
820 size = GLULX_HEADER_SIZE;
822 /* (1a) Output the eight-byte memory layout identifier. */
824 sf_put('I'); sf_put('n'); sf_put('f'); sf_put('o');
825 sf_put(0); sf_put(1); sf_put(0); sf_put(0);
827 /* (1b) Output the rest of the Inform-specific data. */
829 /* Inform version number */
830 sf_put('0' + ((RELEASE_NUMBER/100)%10));
832 sf_put('0' + ((RELEASE_NUMBER/10)%10));
833 sf_put('0' + RELEASE_NUMBER%10);
834 /* Glulx back-end version number */
835 sf_put('0' + ((GLULX_RELEASE_NUMBER/100)%10));
837 sf_put('0' + ((GLULX_RELEASE_NUMBER/10)%10));
838 sf_put('0' + GLULX_RELEASE_NUMBER%10);
839 /* Game release number */
840 sf_put((release_number>>8) & 0xFF);
841 sf_put(release_number & 0xFF);
842 /* Game serial number */
845 write_serial_number(serialnum);
847 sf_put(serialnum[i]);
849 size += GLULX_STATIC_ROM_SIZE;
851 /* (2) Output the compiled code area. */
853 if (temporary_files_switch)
856 fin=fopen(Temp2_Name,"rb");
858 fatalerror("I/O failure: couldn't reopen temporary file 2");
861 if (!OMIT_UNUSED_ROUTINES) {
862 /* This is the old-fashioned case, which is easy. All of zcode_area
863 (zmachine_pc bytes) will be output. next_cons_check will be
864 ignored, because j will never reach it. */
865 code_length = zmachine_pc;
867 next_cons_check = code_length+1;
870 /* With dead function stripping, life is more complicated.
871 j will run from 0 to zmachine_pc, but only code_length of
872 those should be output. next_cons_check is the location of
873 the next function break; that's where we check whether
874 we're in a live function or a dead one.
875 (This logic is simplified by the assumption that a backpatch
876 marker will never straddle a function break.) */
877 if (zmachine_pc != df_total_size_before_stripping)
878 compiler_error("Code size does not match (zmachine_pc and df_total_size).");
879 code_length = df_total_size_after_stripping;
882 df_prepare_function_iterate();
884 size_before_code = size;
888 for (i=0; i<zcode_backpatch_size; i=i+6) {
892 (read_byte_from_memory_block(&zcode_backpatch_table, i+2) << 24)
893 | (read_byte_from_memory_block(&zcode_backpatch_table, i+3) << 16)
894 | (read_byte_from_memory_block(&zcode_backpatch_table, i+4) << 8)
895 | (read_byte_from_memory_block(&zcode_backpatch_table, i+5));
896 backpatch_error_flag = FALSE;
898 read_byte_from_memory_block(&zcode_backpatch_table, i);
900 read_byte_from_memory_block(&zcode_backpatch_table, i+1);
902 /* All code up until the next backpatch marker gets flushed out
903 as-is. (Unless we're in a stripped-out function.) */
906 while (j<offset && j<next_cons_check) {
907 /* get dummy value */
908 ((temporary_files_switch)?fgetc(fin):
909 read_byte_from_memory_block(&zcode_area, j));
914 while (j<offset && j<next_cons_check) {
916 sf_put((temporary_files_switch)?fgetc(fin):
917 read_byte_from_memory_block(&zcode_area, j));
921 if (j == next_cons_check)
922 next_cons_check = df_next_function_iterate(&use_function);
925 /* Write out the converted value of the backpatch marker.
926 (Unless we're in a stripped-out function.) */
930 v = ((temporary_files_switch)?fgetc(fin):
931 read_byte_from_memory_block(&zcode_area, j));
932 v = (v << 8) | ((temporary_files_switch)?fgetc(fin):
933 read_byte_from_memory_block(&zcode_area, j+1));
934 v = (v << 8) | ((temporary_files_switch)?fgetc(fin):
935 read_byte_from_memory_block(&zcode_area, j+2));
936 v = (v << 8) | ((temporary_files_switch)?fgetc(fin):
937 read_byte_from_memory_block(&zcode_area, j+3));
941 v = backpatch_value(v);
942 sf_put((v >> 24) & 0xFF);
943 sf_put((v >> 16) & 0xFF);
944 sf_put((v >> 8) & 0xFF);
950 v = ((temporary_files_switch)?fgetc(fin):
951 read_byte_from_memory_block(&zcode_area, j));
952 v = (v << 8) | ((temporary_files_switch)?fgetc(fin):
953 read_byte_from_memory_block(&zcode_area, j+1));
957 v = backpatch_value(v);
959 printf("*** backpatch value does not fit ***\n");
960 backpatch_error_flag = TRUE;
962 sf_put((v >> 8) & 0xFF);
968 v = ((temporary_files_switch)?fgetc(fin):
969 read_byte_from_memory_block(&zcode_area, j));
973 v = backpatch_value(v);
975 printf("*** backpatch value does not fit ***\n");
976 backpatch_error_flag = TRUE;
983 printf("*** unknown backpatch data len = %d ***\n",
985 backpatch_error_flag = TRUE;
988 if (j > next_cons_check)
989 compiler_error("Backpatch appears to straddle function break");
991 if (backpatch_error_flag) {
992 printf("*** %d bytes zcode offset=%08lx backpatch offset=%08lx ***\n",
993 data_len, (long int) j, (long int) i);
997 /* Flush out the last bit of zcode_area, after the last backpatch
999 offset = zmachine_pc;
1001 if (!use_function) {
1002 while (j<offset && j<next_cons_check) {
1003 /* get dummy value */
1004 ((temporary_files_switch)?fgetc(fin):
1005 read_byte_from_memory_block(&zcode_area, j));
1010 while (j<offset && j<next_cons_check) {
1012 sf_put((temporary_files_switch)?fgetc(fin):
1013 read_byte_from_memory_block(&zcode_area, j));
1017 if (j == next_cons_check)
1018 next_cons_check = df_next_function_iterate(&use_function);
1021 if (temporary_files_switch)
1023 fatalerror("I/O failure: couldn't read from temporary file 2");
1028 if (size_before_code + code_length != size)
1029 compiler_error("Code output length did not match");
1031 /* (4) Output the static strings area. */
1033 if (temporary_files_switch) {
1034 fseek(Temp1_fp, 0, SEEK_SET);
1038 int ch, jx, curbyte, bx;
1039 int depth, checkcount;
1040 huffbitlist_t *bits;
1045 if (compression_switch) {
1047 /* The 12-byte table header. */
1048 lx = compression_table_size;
1049 sf_put((lx >> 24) & 0xFF);
1050 sf_put((lx >> 16) & 0xFF);
1051 sf_put((lx >> 8) & 0xFF);
1052 sf_put((lx) & 0xFF);
1054 sf_put((no_huff_entities >> 24) & 0xFF);
1055 sf_put((no_huff_entities >> 16) & 0xFF);
1056 sf_put((no_huff_entities >> 8) & 0xFF);
1057 sf_put((no_huff_entities) & 0xFF);
1059 lx = Write_Strings_At + 12;
1060 sf_put((lx >> 24) & 0xFF);
1061 sf_put((lx >> 16) & 0xFF);
1062 sf_put((lx >> 8) & 0xFF);
1063 sf_put((lx) & 0xFF);
1067 output_compression(huff_entity_root, &size, &checkcount);
1068 if (checkcount != no_huff_entities)
1069 compiler_error("Compression table count mismatch.");
1072 if (size - origsize != compression_table_size)
1073 compiler_error("Compression table size mismatch.");
1077 for (lx=0, ix=0; lx<no_strings; lx++) {
1078 int escapelen=0, escapetype=0;
1081 if (compression_switch)
1082 sf_put(0xE1); /* type byte -- compressed string */
1084 sf_put(0xE0); /* type byte -- non-compressed string */
1089 if (temporary_files_switch)
1090 ch = fgetc(Temp1_fp);
1092 ch = read_byte_from_memory_block(&static_strings_area, ix);
1094 if (ix > static_strings_extent || ch < 0)
1095 compiler_error("Read too much not-yet-compressed text.");
1097 if (escapelen == -1) {
1102 else if (ch == '0') {
1105 else if (ch == 'A' || ch == 'D' || ch == 'U') {
1112 compiler_error("Strange @ escape in processed text.");
1115 else if (escapelen) {
1116 escapeval = (escapeval << 4) | ((ch-'A') & 0x0F);
1118 if (escapelen == 0) {
1119 if (escapetype == 'A') {
1120 ch = huff_abbrev_start+escapeval;
1122 else if (escapetype == 'D') {
1123 ch = huff_dynam_start+escapeval;
1125 else if (escapetype == 'U') {
1126 ch = huff_unicode_start+escapeval;
1129 compiler_error("Strange @ escape in processed text.");
1146 if (compression_switch) {
1147 bits = &(huff_entities[ch].bits);
1148 depth = huff_entities[ch].depth;
1149 for (bx=0; bx<depth; bx++) {
1150 if (bits->b[bx / 8] & (1 << (bx % 8)))
1151 curbyte |= (1 << jx);
1162 if (ch >= huff_dynam_start) {
1163 sf_put(' '); sf_put(' '); sf_put(' ');
1166 else if (ch >= huff_abbrev_start) {
1170 /* 256, the string terminator, comes out as zero */
1176 if (compression_switch && jx) {
1182 if (size - origsize != compression_string_size)
1183 compiler_error("Compression string size mismatch.");
1187 /* (5) Output static arrays (if any). */
1189 /* We have to backpatch entries mentioned in staticarray_backpatch_table. */
1190 int32 size_before_arrays = size;
1192 for (ix=0, jx=0; ix<staticarray_backpatch_size; ix += 5) {
1193 backpatch_error_flag = FALSE;
1194 backpatch_marker = read_byte_from_memory_block(&staticarray_backpatch_table, ix);
1195 /* datalen is always 4 for array backpatching */
1197 (read_byte_from_memory_block(&staticarray_backpatch_table, ix+1) << 24)
1198 | (read_byte_from_memory_block(&staticarray_backpatch_table, ix+2) << 16)
1199 | (read_byte_from_memory_block(&staticarray_backpatch_table, ix+3) << 8)
1200 | (read_byte_from_memory_block(&staticarray_backpatch_table, ix+4));
1202 sf_put(static_array_area[jx]);
1207 /* Write out the converted value of the backpatch marker. */
1208 val = static_array_area[jx++];
1209 val = (val << 8) | static_array_area[jx++];
1210 val = (val << 8) | static_array_area[jx++];
1211 val = (val << 8) | static_array_area[jx++];
1212 val = backpatch_value(val);
1213 sf_put((val >> 24) & 0xFF);
1214 sf_put((val >> 16) & 0xFF);
1215 sf_put((val >> 8) & 0xFF);
1216 sf_put((val) & 0xFF);
1220 /* Flush out the last bit of static_array_area, after the last backpatch marker. */
1221 offset = static_array_area_size;
1223 sf_put(static_array_area[jx]);
1228 if (size_before_arrays + static_array_area_size != size)
1229 compiler_error("Static array output length did not match");
1232 /* (5.5) Output any null bytes (required to reach a GPAGESIZE address)
1235 while (size % GPAGESIZE) { sf_put(0); size++; }
1237 /* (6) Output RAM. */
1239 for (i=0; i<RAM_Size; i++)
1240 { sf_put(zmachine_paged_memory[i]); size++;
1243 if (ferror(sf_handle))
1244 fatalerror("I/O failure: couldn't write to story file");
1246 fseek(sf_handle, 32, SEEK_SET);
1247 fputc((checksum_long >> 24) & 0xFF, sf_handle);
1248 fputc((checksum_long >> 16) & 0xFF, sf_handle);
1249 fputc((checksum_long >> 8) & 0xFF, sf_handle);
1250 fputc((checksum_long) & 0xFF, sf_handle);
1252 if (ferror(sf_handle))
1253 fatalerror("I/O failure: couldn't backtrack on story file for checksum");
1255 /* Write a copy of the first 64 bytes into the debugging information file
1256 (mainly so that it can be used to identify which story file matches with
1257 which debugging info file). */
1259 if (debugfile_switch)
1260 { fseek(sf_handle, 0L, SEEK_SET);
1261 debug_file_printf("<story-file-prefix>");
1262 for (i = 0; i < 63; i += 3)
1263 { first_byte_of_triple = fgetc(sf_handle);
1264 second_byte_of_triple = fgetc(sf_handle);
1265 third_byte_of_triple = fgetc(sf_handle);
1266 debug_file_print_base_64_triple
1267 (first_byte_of_triple,
1268 second_byte_of_triple,
1269 third_byte_of_triple);
1271 debug_file_print_base_64_single(fgetc(sf_handle));
1272 debug_file_printf("</story-file-prefix>");
1278 { char settype_command[PATHLEN];
1279 sprintf(settype_command, "settype %s %s",
1280 new_name, riscos_file_type());
1281 system(settype_command);
1286 InformFiletypes (new_name, INF_MODULE_TYPE);
1288 InformFiletypes (new_name, INF_ZCODE_TYPE);
1292 extern void output_file(void)
1300 /* ------------------------------------------------------------------------- */
1301 /* Output the text transcript file (only called if there is to be one). */
1302 /* ------------------------------------------------------------------------- */
1304 FILE *transcript_file_handle; int transcript_open;
1306 extern void write_to_transcript_file(char *text)
1307 { fputs(text, transcript_file_handle);
1308 fputc('\n', transcript_file_handle);
1311 extern void open_transcript_file(char *what_of)
1312 { char topline_buffer[256];
1314 transcript_file_handle = fopen(Transcript_Name,"w");
1315 if (transcript_file_handle==NULL)
1316 fatalerror_named("Couldn't open transcript file",
1319 transcript_open = TRUE;
1321 sprintf(topline_buffer, "Transcript of the text of \"%s\"\n\
1322 [From %s]\n", what_of, banner_line);
1323 write_to_transcript_file(topline_buffer);
1326 extern void abort_transcript_file(void)
1327 { if (transcript_switch && transcript_open)
1328 fclose(transcript_file_handle);
1329 transcript_open = FALSE;
1332 extern void close_transcript_file(void)
1333 { char botline_buffer[256];
1336 write_serial_number(sn_buffer);
1337 sprintf(botline_buffer, "\n[End of transcript: release %d.%s]\n",
1338 release_number, sn_buffer);
1339 write_to_transcript_file(botline_buffer);
1341 if (ferror(transcript_file_handle))
1342 fatalerror("I/O failure: couldn't write to transcript file");
1343 fclose(transcript_file_handle);
1344 transcript_open = FALSE;
1347 { char settype_command[PATHLEN];
1348 sprintf(settype_command, "settype %s text",
1350 system(settype_command);
1354 InformFiletypes (Transcript_Name, INF_TEXT_TYPE);
1358 /* ------------------------------------------------------------------------- */
1359 /* Access to the debugging information file. */
1360 /* ------------------------------------------------------------------------- */
1362 static FILE *Debug_fp; /* Handle of debugging info file */
1364 static void open_debug_file(void)
1365 { Debug_fp=fopen(Debugging_Name,"wb");
1367 fatalerror_named("Couldn't open debugging information file",
1371 extern void nullify_debug_file_position(maybe_file_position *position) {
1372 position->valid = 0;
1375 static void close_debug_file(void)
1378 InformFiletypes (Debugging_Name, INF_DEBUG_TYPE);
1382 extern void begin_debug_file(void)
1383 { open_debug_file();
1385 debug_file_printf("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
1386 debug_file_printf("<inform-story-file version=\"1.0\" ");
1387 debug_file_printf("content-creator=\"Inform\" ");
1389 ("content-creator-version=\"%d.%d%d\">",
1390 (VNUMBER / 100) % 10,
1391 (VNUMBER / 10) % 10,
1395 extern void debug_file_printf(const char*format, ...)
1396 { va_list argument_pointer;
1397 va_start(argument_pointer, format);
1398 vfprintf(Debug_fp, format, argument_pointer);
1399 va_end(argument_pointer);
1400 if (ferror(Debug_fp))
1401 { fatalerror("I/O failure: can't write to debugging information file");
1405 extern void debug_file_print_with_entities(const char*string)
1408 for (character = string[index]; character; character = string[++index])
1411 debug_file_printf(""");
1414 debug_file_printf("&");
1417 debug_file_printf("'");
1420 debug_file_printf("<");
1423 debug_file_printf(">");
1426 debug_file_printf("%c", character);
1432 static char base_64_digits[] =
1433 { 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O',
1434 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd',
1435 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's',
1436 't', 'u', 'v', 'w', 'x', 'y', 'z', '0', '1', '2', '3', '4', '5', '6', '7',
1437 '8', '9', '+', '/' };
1439 extern void debug_file_print_base_64_triple
1440 (uchar first, uchar second, uchar third)
1443 base_64_digits[first >> 2],
1444 base_64_digits[((first & 3) << 4) | (second >> 4)],
1445 base_64_digits[((second & 15) << 2) | (third >> 6)],
1446 base_64_digits[third & 63]);
1449 extern void debug_file_print_base_64_pair(uchar first, uchar second)
1452 base_64_digits[first >> 2],
1453 base_64_digits[((first & 3) << 4) | (second >> 4)],
1454 base_64_digits[(second & 15) << 2]);
1457 extern void debug_file_print_base_64_single(uchar first)
1460 base_64_digits[first >> 2],
1461 base_64_digits[(first & 3) << 4]);
1464 static void write_debug_location_internals(debug_location location)
1465 { debug_file_printf("<file-index>%d</file-index>", location.file_index - 1);
1467 ("<file-position>%d</file-position>", location.beginning_byte_index);
1469 ("<line>%d</line>", location.beginning_line_number);
1471 ("<character>%d</character>", location.beginning_character_number);
1472 if (location.beginning_byte_index != location.end_byte_index ||
1473 location.beginning_line_number != location.end_line_number ||
1474 location.beginning_character_number != location.end_character_number)
1476 ("<end-file-position>%d</end-file-position>",
1477 location.end_byte_index);
1479 ("<end-line>%d</end-line>", location.end_line_number);
1481 ("<end-character>%d</end-character>",
1482 location.end_character_number);
1486 static void write_debug_location_origsource_internals(debug_location location)
1488 ("<file-index>%d</file-index>", location.orig_file_index - 1);
1489 if (location.orig_beg_line_number)
1491 ("<line>%d</line>", location.orig_beg_line_number);
1492 if (location.orig_beg_char_number)
1494 ("<character>%d</character>", location.orig_beg_char_number);
1497 extern void write_debug_location(debug_location location)
1498 { if (location.file_index && location.file_index != 255)
1499 { debug_file_printf("<source-code-location>");
1500 write_debug_location_internals(location);
1501 debug_file_printf("</source-code-location>");
1503 if (location.orig_file_index)
1504 { debug_file_printf("<source-code-location>");
1505 write_debug_location_origsource_internals(location);
1506 debug_file_printf("</source-code-location>");
1510 extern void write_debug_locations(debug_locations locations)
1511 { if (locations.next)
1512 { const debug_locations*current = &locations;
1513 unsigned int index = 0;
1514 for (; current; current = current->next, ++index)
1515 { debug_file_printf("<source-code-location index=\"%d\">", index);
1516 write_debug_location_internals(current->location);
1517 debug_file_printf("</source-code-location>");
1519 if (locations.location.orig_file_index)
1520 { debug_file_printf("<source-code-location>");
1521 write_debug_location_origsource_internals(locations.location);
1522 debug_file_printf("</source-code-location>");
1526 { write_debug_location(locations.location);
1530 extern void write_debug_optional_identifier(int32 symbol_index)
1531 { if (stypes[symbol_index] != ROUTINE_T)
1533 ("Attempt to write a replaceable identifier for a non-routine");
1535 if (replacement_debug_backpatch_positions[symbol_index].valid)
1538 &replacement_debug_backpatch_positions[symbol_index].position))
1539 { fatalerror("I/O failure: can't seek in debugging information file");
1542 ("<identifier artificial=\"true\">%s "
1543 "(superseded replacement)</identifier>",
1544 symbs[symbol_index]);
1545 if (fseek(Debug_fp, 0L, SEEK_END))
1546 { fatalerror("I/O failure: can't seek in debugging information file");
1550 (Debug_fp, &replacement_debug_backpatch_positions[symbol_index].position);
1551 replacement_debug_backpatch_positions[symbol_index].valid = TRUE;
1552 debug_file_printf("<identifier>%s</identifier>", symbs[symbol_index]);
1553 /* Space for: artificial="true" (superseded replacement) */
1554 debug_file_printf(" ");
1557 extern void write_debug_symbol_backpatch(int32 symbol_index)
1558 { if (symbol_debug_backpatch_positions[symbol_index].valid) {
1559 compiler_error("Symbol entry incorrectly reused in debug information "
1560 "file backpatching");
1562 fgetpos(Debug_fp, &symbol_debug_backpatch_positions[symbol_index].position);
1563 symbol_debug_backpatch_positions[symbol_index].valid = TRUE;
1564 /* Reserve space for up to 10 digits plus a negative sign. */
1565 debug_file_printf("*BACKPATCH*");
1568 extern void write_debug_symbol_optional_backpatch(int32 symbol_index)
1569 { if (symbol_debug_backpatch_positions[symbol_index].valid) {
1570 compiler_error("Symbol entry incorrectly reused in debug information "
1571 "file backpatching");
1573 /* Reserve space for open and close value tags and up to 10 digits plus a
1574 negative sign, but take the backpatch position just inside the element,
1575 so that we'll be in the same case as above if the symbol is eventually
1577 debug_file_printf("<value>");
1578 fgetpos(Debug_fp, &symbol_debug_backpatch_positions[symbol_index].position);
1579 symbol_debug_backpatch_positions[symbol_index].valid = TRUE;
1580 debug_file_printf("*BACKPATCH*</value>");
1583 static void write_debug_backpatch
1584 (debug_backpatch_accumulator *accumulator, int32 value)
1585 { if (accumulator->number_of_values_to_backpatch ==
1586 accumulator->number_of_available_backpatches)
1587 { my_realloc(&accumulator->values_and_backpatch_positions,
1588 sizeof(value_and_backpatch_position) *
1589 accumulator->number_of_available_backpatches,
1590 2 * sizeof(value_and_backpatch_position) *
1591 accumulator->number_of_available_backpatches,
1592 "values and debug information backpatch positions");
1593 accumulator->number_of_available_backpatches *= 2;
1595 accumulator->values_and_backpatch_positions
1596 [accumulator->number_of_values_to_backpatch].value = value;
1599 &accumulator->values_and_backpatch_positions
1600 [accumulator->number_of_values_to_backpatch].backpatch_position);
1601 ++(accumulator->number_of_values_to_backpatch);
1602 /* Reserve space for up to 10 digits plus a negative sign. */
1603 debug_file_printf("*BACKPATCH*");
1606 extern void write_debug_object_backpatch(int32 object_number)
1608 { write_debug_backpatch(&object_backpatch_accumulator, object_number - 1);
1611 { debug_file_printf("%d", object_number);
1615 static int32 backpatch_object_address(int32 index)
1616 { return object_tree_offset + OBJECT_BYTE_LENGTH * index;
1619 extern void write_debug_packed_code_backpatch(int32 offset)
1620 { write_debug_backpatch(&packed_code_backpatch_accumulator, offset);
1623 static int32 backpatch_packed_code_address(int32 offset)
1625 if (OMIT_UNUSED_ROUTINES) {
1627 offset = df_stripped_offset_for_code_offset(offset, &stripped);
1631 return (code_offset + offset) / scale_factor;
1634 extern void write_debug_code_backpatch(int32 offset)
1635 { write_debug_backpatch(&code_backpatch_accumulator, offset);
1638 static int32 backpatch_code_address(int32 offset)
1640 if (OMIT_UNUSED_ROUTINES) {
1642 offset = df_stripped_offset_for_code_offset(offset, &stripped);
1646 return code_offset + offset;
1649 extern void write_debug_global_backpatch(int32 offset)
1650 { write_debug_backpatch(&global_backpatch_accumulator, offset);
1653 static int32 backpatch_global_address(int32 offset)
1654 { return variables_offset + WORDSIZE * (offset - MAX_LOCAL_VARIABLES);
1657 extern void write_debug_array_backpatch(int32 offset)
1658 { write_debug_backpatch(&array_backpatch_accumulator, offset);
1661 static int32 backpatch_array_address(int32 offset)
1662 { return (glulx_mode ? arrays_offset : variables_offset) + offset;
1665 extern void write_debug_grammar_backpatch(int32 offset)
1666 { write_debug_backpatch(&grammar_backpatch_accumulator, offset);
1669 static int32 backpatch_grammar_address(int32 offset)
1670 { return grammar_table_offset + offset;
1673 extern void begin_writing_debug_sections()
1674 { debug_file_printf("<story-file-section>");
1675 debug_file_printf("<type>header</type>");
1676 debug_file_printf("<address>0</address>");
1679 extern void write_debug_section(const char*name, int32 beginning_address)
1680 { debug_file_printf("<end-address>%d</end-address>", beginning_address);
1681 debug_file_printf("</story-file-section>");
1682 debug_file_printf("<story-file-section>");
1683 debug_file_printf("<type>");
1684 debug_file_print_with_entities(name);
1685 debug_file_printf("</type>");
1686 debug_file_printf("<address>%d</address>", beginning_address);
1689 extern void end_writing_debug_sections(int32 end_address)
1690 { debug_file_printf("<end-address>%d</end-address>", end_address);
1691 debug_file_printf("</story-file-section>");
1694 extern void write_debug_undef(int32 symbol_index)
1695 { if (!symbol_debug_backpatch_positions[symbol_index].valid)
1697 ("Attempt to erase debugging information never written or since "
1700 if (stypes[symbol_index] != CONSTANT_T)
1702 ("Attempt to erase debugging information for a non-constant "
1703 "because of an #undef");
1706 (Debug_fp, &symbol_debug_backpatch_positions[symbol_index].position))
1707 { fatalerror("I/O failure: can't seek in debugging information file");
1709 /* There are 7 characters in ``<value>''. */
1710 if (fseek(Debug_fp, -7L, SEEK_CUR))
1711 { fatalerror("I/O failure: can't seek in debugging information file");
1713 /* Overwrite: <value>*BACKPATCH*</value> */
1714 debug_file_printf(" ");
1715 nullify_debug_file_position
1716 (&symbol_debug_backpatch_positions[symbol_index]);
1717 if (fseek(Debug_fp, 0L, SEEK_END))
1718 { fatalerror("I/O failure: can't seek in debugging information file");
1722 static void apply_debug_information_backpatches
1723 (debug_backpatch_accumulator *accumulator)
1724 { int32 backpatch_index, backpatch_value;
1725 for (backpatch_index = accumulator->number_of_values_to_backpatch;
1729 &accumulator->values_and_backpatch_positions
1730 [backpatch_index].backpatch_position))
1732 ("I/O failure: can't seek in debugging information file");
1735 (*accumulator->backpatching_function)
1736 (accumulator->values_and_backpatch_positions
1737 [backpatch_index].value);
1739 ("%11d", /* Space for up to 10 digits plus a negative sign. */
1744 static void apply_debug_information_symbol_backpatches()
1745 { int backpatch_symbol;
1746 for (backpatch_symbol = no_symbols; backpatch_symbol--;)
1747 { if (symbol_debug_backpatch_positions[backpatch_symbol].valid)
1748 { if (fsetpos(Debug_fp,
1749 &symbol_debug_backpatch_positions
1750 [backpatch_symbol].position))
1752 ("I/O failure: can't seek in debugging information file");
1754 debug_file_printf("%11d", svals[backpatch_symbol]);
1759 static void write_debug_system_constants()
1760 { int *system_constant_list =
1761 glulx_mode ? glulx_system_constant_list : z_system_constant_list;
1762 int system_constant_index = 0;
1764 /* Store system constants. */
1765 for (; system_constant_list[system_constant_index] != -1;
1766 ++system_constant_index)
1767 { int system_constant = system_constant_list[system_constant_index];
1768 debug_file_printf("<constant>");
1770 ("<identifier>#%s</identifier>",
1771 system_constants.keywords[system_constant]);
1773 ("<value>%d</value>",
1774 value_of_system_constant(system_constant));
1775 debug_file_printf("</constant>");
1779 extern void end_debug_file()
1780 { write_debug_system_constants();
1781 debug_file_printf("</inform-story-file>\n");
1784 { apply_debug_information_backpatches(&object_backpatch_accumulator);
1786 { apply_debug_information_backpatches(&packed_code_backpatch_accumulator);
1788 apply_debug_information_backpatches(&code_backpatch_accumulator);
1789 apply_debug_information_backpatches(&global_backpatch_accumulator);
1790 apply_debug_information_backpatches(&array_backpatch_accumulator);
1791 apply_debug_information_backpatches(&grammar_backpatch_accumulator);
1793 apply_debug_information_symbol_backpatches();
1798 /* ------------------------------------------------------------------------- */
1799 /* Temporary storage files: */
1801 /* Temp file 1 is used to hold the static strings area, as compiled */
1802 /* 2 to hold compiled routines of Z-code */
1803 /* 3 to hold the link data table (but only for modules) */
1805 /* (Though annoying, this procedure typically saves about 200K of memory, */
1806 /* an important point for Amiga and sub-386 PC users of Inform) */
1807 /* ------------------------------------------------------------------------- */
1809 extern void open_temporary_files(void)
1810 { translate_temp_filename(1);
1811 Temp1_fp=fopen(Temp1_Name,"wb");
1812 if (Temp1_fp==NULL) fatalerror_named("Couldn't open temporary file 1",
1814 translate_temp_filename(2);
1815 Temp2_fp=fopen(Temp2_Name,"wb");
1816 if (Temp2_fp==NULL) fatalerror_named("Couldn't open temporary file 2",
1819 if (!module_switch) return;
1820 translate_temp_filename(3);
1821 Temp3_fp=fopen(Temp3_Name,"wb");
1822 if (Temp3_fp==NULL) fatalerror_named("Couldn't open temporary file 3",
1826 extern void check_temp_files(void)
1828 if (ferror(Temp1_fp))
1829 fatalerror("I/O failure: couldn't write to temporary file 1");
1830 if (ferror(Temp2_fp))
1831 fatalerror("I/O failure: couldn't write to temporary file 2");
1832 if (module_switch && ferror(Temp3_fp))
1833 fatalerror("I/O failure: couldn't write to temporary file 3");
1836 extern void remove_temp_files(void)
1837 { if (Temp1_fp != NULL) fclose(Temp1_fp);
1839 if (Temp2_fp != NULL) fclose(Temp2_fp);
1841 remove(Temp1_Name); remove(Temp2_Name);
1843 { if (Temp3_fp != NULL) fclose(Temp3_fp);
1849 /* ========================================================================= */
1850 /* Data structure management routines */
1851 /* ------------------------------------------------------------------------- */
1853 extern void init_files_vars(void)
1854 { malloced_bytes = 0;
1855 checksum_low_byte = 0; /* Z-code */
1856 checksum_high_byte = 0;
1857 checksum_long = 0; /* Glulx */
1859 transcript_open = FALSE;
1862 extern void files_begin_prepass(void)
1865 total_input_files = 0;
1866 current_input_file = 0;
1867 current_origsource_file = 0;
1870 extern void files_begin_pass(void)
1871 { total_chars_read=0;
1872 if (temporary_files_switch)
1873 open_temporary_files();
1876 static void initialise_accumulator
1877 (debug_backpatch_accumulator *accumulator,
1878 int32 (* backpatching_function)(int32))
1879 { accumulator->number_of_values_to_backpatch = 0;
1880 accumulator->number_of_available_backpatches =
1881 INITIAL_DEBUG_INFORMATION_BACKPATCH_ALLOCATION;
1882 accumulator->values_and_backpatch_positions =
1884 (sizeof(value_and_backpatch_position) *
1885 accumulator->number_of_available_backpatches,
1886 "values and debug information backpatch positions");
1887 accumulator->backpatching_function = backpatching_function;
1890 extern void files_allocate_arrays(void)
1891 { filename_storage = my_malloc(MAX_SOURCE_FILES*64, "filename storage");
1892 filename_storage_p = filename_storage;
1893 filename_storage_left = MAX_SOURCE_FILES*64;
1894 InputFiles = my_malloc(MAX_SOURCE_FILES*sizeof(FileId),
1895 "input file storage");
1896 if (debugfile_switch)
1898 { initialise_accumulator
1899 (&object_backpatch_accumulator, &backpatch_object_address);
1901 { initialise_accumulator
1902 (&packed_code_backpatch_accumulator,
1903 &backpatch_packed_code_address);
1905 initialise_accumulator
1906 (&code_backpatch_accumulator, &backpatch_code_address);
1907 initialise_accumulator
1908 (&global_backpatch_accumulator, &backpatch_global_address);
1909 initialise_accumulator
1910 (&array_backpatch_accumulator, &backpatch_array_address);
1911 initialise_accumulator
1912 (&grammar_backpatch_accumulator, &backpatch_grammar_address);
1916 static void tear_down_accumulator(debug_backpatch_accumulator *accumulator)
1918 (&(accumulator->values_and_backpatch_positions),
1919 "values and debug information backpatch positions");
1922 extern void files_free_arrays(void)
1923 { my_free(&filename_storage, "filename storage");
1924 my_free(&InputFiles, "input file storage");
1925 if (debugfile_switch)
1927 { tear_down_accumulator(&object_backpatch_accumulator);
1929 { tear_down_accumulator(&packed_code_backpatch_accumulator);
1931 tear_down_accumulator(&code_backpatch_accumulator);
1932 tear_down_accumulator(&global_backpatch_accumulator);
1933 tear_down_accumulator(&array_backpatch_accumulator);
1934 tear_down_accumulator(&grammar_backpatch_accumulator);
1938 /* ========================================================================= */