This chapter describes the Xfile output module which can be selected with the -Fxfile option. Refer to the TOS output module for generating absolute Z-file executables.

Legal
=====

This module is written in 2018,2020,2021,2024 by Frank Wille and is covered by the vasm copyright without modifications.

Additional options for this module
==================================

-exec=<symbol>
     Use the given label <symbol> as entry point of the program. Omitting this option will define the execution address to be the same as the code section's base address.

-loadhigh
     Set the load mode in the header to high address (2).

General
=======

This module outputs the Xfile executable file format, which is used on Sharp X68000 16/32-bit computer with 68000 up to 68040 CPU.

Restrictions
============

  - The source must not define more than one code, data and bss section each. More complex sources with .rdata or .stack sections require a linker.

  - All symbols must be defined, otherwise the generation of the executable fails. Unknown symbols are listed by vasm.

  - The only relocations allowed in this format are 32-bit absolute.

Known Problems
==============

Some known problems of this module at the moment:

  - None.

Error Messages
==============

This module has the following error messages:

  - 3004: section attributes <attr> not supported

  - 3005: reloc type %d, size %d, mask 0x%lx (symbol %s + 0x%lx) not supported

  - 3006: reloc type %d not supported

  - 3007: undefined symbol <%s>

  - 3008: output module doesn't allow multiple sections of the same type

  - 3009: undefined symbol <%s> at %s+%#lx, reloc type %d

  - 3011: weak symbol <%s> not supported by output format, treating as global

  - 3024: section <%s>: maximum size of 0x%llx bytes exceeded (0x%llx)