Cross binutils vasm/vlink - Revision history

Migario: fixed typo for vasm CPU target option (it should read m68k instead of 68k)

2023-02-26T19:50:29Z

fixed typo for vasm CPU target option (it should read m68k instead of 68k)

Migario: /* Installation */ apparantly vasm/vlnk does not support aros i386

2020-05-16T18:58:22Z

Installation: apparantly vasm/vlnk does not support aros i386

Migario: /* Installation */ update instructions to match correct target(s)

2020-05-16T18:36:16Z

Installation: update instructions to match correct target(s)

Migario: /* Usage */ rewording

2020-05-16T18:20:04Z

Usage: rewording

Migario: /* Usage */ typo's

2020-05-16T18:18:51Z

Usage: typo's

Migario: /* Instructions */ added/corrected target x86

2020-05-16T18:17:57Z

Instructions: added/corrected target x86

Migario: creating vasm/vlink utils from scratch

2020-05-16T17:40:46Z

creating vasm/vlink utils from scratch

New page

How to create binutils (vasm, vlink) needed for FreePascal crosscompiling on a linux system.

These instructions apply for the targets Amiga (m68k), AmigaOS (ppc), MorphOS (ppc) and AROS (i386)

= Requirements =

* working linux with gcc (e.g. ubuntu: sudo apt install build-essentials)
* latest sources of vasm/vlink

= Instructions =
# create a working dir (e.g. <code>mkdir build</code>)
# enter the directory (e.g. <code>cd build</code>)
# create a directory that will store the results (e.g. <code>mkdir release</code>)
# Vasm assembler: Retrieve sources, create and build
#* retrieve the latest sources for vasm
#: <code>wget -N "http://sun.hasenbraten.de/vasm/release/vasm.tar.gz"</code>
#* extract the sources for vasm
#: <code>tar -xvzf "vasm.tar.gz"</code>
#* enter the vasm sources directory
#: <code>cd vasm</code>
#* create vasm
#: for powerpc : <code>make -f Makefile CPU=ppc SYNTAX=std</code>
#: for m68k <code>make -f Makefile CPU=68k SYNTAX=std</code>
#* copy vasm executables to the release folder.
#: for powerpc: <code>cp "vasmppc_std" "../release"</code>
#: for m68k:<code>cp "vasmm68k_std" "../release"</code>
#: for i386:<code>cp "vasmppc_std" "../release"</code>
#* enter your work directory again
#: <code>cd ..</code>
# Vlink linker: Retrieve sources, create and build
#* retrieve the latest sources for vasm
#: <code>wget -N "http://sun.hasenbraten.de/vasm/release/vlink.tar.gz"</code>
#* extract the sources for vasm
#: <code>tar -xvzf "vlink.tar.gz"</code>
#* enter the vlink sources directory
#: <code>cd vlink</code>
#* create vlink
#: <code>make -f Makefile</code>
#* copy vlink executable to the release folder.
#: <code>cp "vlink" "../release"</code>
#* enter your work directory again
#: <code>cd ..</code>

The compiled tools do now reside in the work/release directory. Note that the vlink linker is only generated once because it supports all targets as mentioned.

= Installation =

install vasm assembler and vlink linker in your system
# copy and rename the assembler to /usr/bin with prefix powerpc-morphos (e.g. cp gas/as-new /usr/bin/powerpc-morphos-as)
# copy and rename the linker to /usr/bin with prefix powerpc-morphos (e.g. cp ld/ld-new /usr/bin/powerpc-morphos-ld)

'''editors note: add the missing platforms and use/correct the right naming scheme.

= Usage =

The vasm/vlink combination with Free Pascal can nor be used by providing the additional command-line options -XV and -Avasm to the fpc commandline compiler.

NOTE/WARNING:
You can not mix vasm/vlink compiled units with those generated by gnu ld/as

in order to create the fpc cross-compiler use the additional make options: CROSSOPT="-XV -Avasm"

@@ Line 21: / Line 21: @@
 #* create vasm
 #: for powerpc: <code>make -f Makefile CPU=ppc SYNTAX=std</code>
-#: for m68k <code>make -f Makefile CPU=68k SYNTAX=std</code>
+#: for m68k <code>make -f Makefile CPU=m68k SYNTAX=std</code>
 #: for x86 <code>make -f Makefile CPU=x86 SYNTAX=std</code>
 #* copy vasm executables to the release folder.

@@ Line 51: / Line 51: @@
 *: for Amiga: m68k-amiga (e.g. <code>cp work/release/vasmppc_std /usr/bin/m68k-amiga-vasmppc_std</code>)
 *: for AmigaOS4: powerpc-amigaos (e.g. <code>cp work/release/vasmppc_std /usr/bin/powerpc-amigaos-vasmppc_std</code>)
-*: for Aros: i386-aros (e.g. <code>cp work/release/vasmppc_std /usr/bin/i386-aros-vasmppc_std</code>)
+*: <del>for Aros: i386-aros (e.g. <code>cp work/release/vasmppc_std /usr/bin/i386-aros-vasmppc_std</code>)</del>
 *: for MorphOS: powerpc-morphos (e.g. <code>cp work/release/vasmppc_std /usr/bin/powerpc-morphos-vasmppc_std</code>)
 * copy and rename the linker to <code>/usr/bin</code> with required target prefix:
 *: for Amiga: m68k-amiga (e.g. <code>cp work/release/vlink /usr/bin/m68k-amiga-vlink</code>)
 *: for AmigaOS4: powerpc-amigaos (e.g. <code>cp work/release/vlink /usr/bin/powerpc-amigaos-vlink</code>)
-*: for Aros: i386-aros (e.g. <code>cp work/release/vlink /usr/bin/i386-aros-vlink</code>)
+*: <del>for Aros: i386-aros (e.g. <code>cp work/release/vlink /usr/bin/i386-aros-vlink</code>)</del>
 *: for MorphOS: powerpc-morphos (e.g. <code>cp work/release/vlink /usr/bin/powerpc-morphos-vlink</code>)

@@ Line 58: / Line 58: @@
 NOTE/WARNING:
-You can not mix vasm/vlink compiled units with those generated by gnu ld/as
+It is not possible to mix vasm/vlink compiled units/objects with those generated by gnu binutils ld/as
 In order to create the fpc cross-compiler use the additional make options: CROSSOPT="-XV -Avasm"

@@ Line 48: / Line 48: @@
 install vasm assembler and vlink linker in your system
-# copy and rename the assembler to /usr/bin with prefix powerpc-morphos (e.g. cp gas/as-new /usr/bin/powerpc-morphos-as)
+* copy and rename the assembler to <code>/usr/bin</code> with required target prefix:
-# copy and rename the linker to /usr/bin with prefix powerpc-morphos (e.g. cp ld/ld-new /usr/bin/powerpc-morphos-ld)
+*: for Amiga: m68k-amiga (e.g. <code>cp work/release/vasmppc_std /usr/bin/m68k-amiga-vasmppc_std</code>)
-'''editors note: add the missing platforms and use/correct the right naming scheme.
+Note that it is probably better/easier to use links for the specific targets and point that to the one single executable (that fits that target).
 = Usage =

@@ Line 20: / Line 20: @@
 #: <code>cd vasm</code>
 #* create vasm
-#: for powerpc : <code>make -f Makefile CPU=ppc SYNTAX=std</code>
+#: for powerpc: <code>make -f Makefile CPU=ppc SYNTAX=std</code>
 #: for m68k <code>make -f Makefile CPU=68k SYNTAX=std</code>
 #* copy vasm executables to the release folder.
 #: for powerpc: <code>cp "vasmppc_std" "../release"</code>
 #: for m68k:<code>cp "vasmm68k_std" "../release"</code>
-#: for i386:<code>cp "vasmppc_std" "../release"</code>
+#: for x86:<code>cp "vasmx86_std" "../release"</code>
 #* enter your work directory again
 #: <code>cd ..</code>