1.\" $NetBSD: aout2hux.1,v 1.5 2001/09/11 00:36:57 wiz Exp $ 2.Dd August 13, 1998 3.Dt AOUT2HUX 1 x68k 4.Os 5.Sh NAME 6.Nm aout2hux 7.Nd convert a.out/ELF executable to Human68k .x format 8.Sh SYNOPSIS 9.Nm 10.Op Fl o Ar output_file 11.Ar aout1 12.Ar loadaddr1 13.Ar aout2 14.Ar loadaddr2 15.Sh DESCRIPTION 16.Nm 17reads two 18.Xr a.out 5 19or ELF 20format executables with different load addresses 21and generate Human68k 22.Sq Li \&.x 23format executable. 24.Pp 25If the input files are a.out, they must be static 26.Dv OMAGIC 27/ 28.Dv NMAGIC 29m68k executables. 30If the input files are ELF, they must be static m68k executables. 31Two input executables must be created from the same objects, 32and have different loading addresses. 33Each of the load address is specified by a hexadecimal number. 34Load address shall be multiple of 4 for 35.Xr as 1 36and 37.Xr ld 1 38of 39.Nx Ns Tn /m68k . 40.Pp 41If the output file is not specified by 42.Fl o 43option, the name 44.Pa out.x 45is used. 46.Sh FILES 47.Bl -tag -width out.xxxx -compact 48.It Pa out.x 49default output file. 50.El 51.Sh EXAMPLES 52The following command sequence creates a Human68k executable 53.Pa foo.x 54from object files 55.Pa a.o 56and 57.Pa b.o : 58.Bd -literal -offset indent 59cc -N -nostdlib -static -Wl,-Text,0 -o aout1 a.o b.o 60cc -N -nostdlib -static -Wl,-Text,10203040 -o aout2 a.o b.o 61aout2hux -o foo.x aout1 0 aout2 10203040 62.Ed 63.Pp 64This example uses 0x0 and 0x10203040 as the load addresses. 65.Sh SEE ALSO 66.Xr as 1 , 67.Xr cc 1 , 68.Xr ld 1 , 69.Xr a.out 5 70.Sh HISTORY 71The 72.Nm 73utility first appeared in 74.Nx 1.4 . 75.Sh BUGS 76Symbol and debugging information is not converted. 77.Pp 78The generated executable is not so effective as that of 79Human68k native compiler. 80