AOUT2HUX(1) (x68k)

AOUT2HUX(1) | General Commands Manual (x68k) | AOUT2HUX(1)

# NAME

`aout2hux` —
convert a.out/ELF executable to Human68k .x format

# SYNOPSIS

`aout2hux` | [`-o` output_file] aout1 loadaddr1 aout2 loadaddr2

# DESCRIPTION

`aout2hux` reads two a.out(5) or ELF format executables with different load addresses and generates a Human68k ‘`.x`’ format executable.

If the input files are a.out, they must be static `OMAGIC` / `NMAGIC` m68k executables. If the input files are ELF, they must be static m68k executables. The two input executables must be created from the same objects, but use different load addresses. The load address is specified as a hexadecimal number. Load addresses are a multiple of 4 for as(1) and ld(1) from NetBSD/m68k.

If output_file is not specified with the `-o` option, the default name out.x is used.

# FILES

out.x
  default output file.

# EXAMPLES

The following command sequence creates a Human68k executable foo.x from object files a.o and b.o:

    cc -N -nostdlib -static -Wl,-Text,0        -o aout1 a.o b.o
    cc -N -nostdlib -static -Wl,-Text,10203040 -o aout2 a.o b.o
    aout2hux -o foo.x aout1 0 aout2 10203040

This example uses 0x0 and 0x10203040 as the load addresses.

# SEE ALSO

as(1), cc(1), ld(1), a.out(5)

# HISTORY

The `aout2hux` utility first appeared in NetBSD 1.4.

# BUGS

Symbol and debugging information is not converted.

The generated executable is not as effective as that of Human68k native compiler.

September 1, 2019 | NetBSD 10.1