share/man/man1/man1.x68k/aout2hux.1

   1 .\"     $NetBSD: aout2hux.1,v 1.4 2001/04/21 14:30:18 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
  17 reads two
  18 .Xr a.out 5
  19 or ELF
  20 format executables with different load addresses
  21 and generate Human68k
  22 .Sq Li \&.x
  23 format executable.
  24 .Pp
  25 If the input files are a.out, they must be static
  26 .Dv OMAGIC
  27 /
  28 .Dv NMAGIC
  29 m68k executables.
  30 If the input files are ELF, they must be static m68k executables.
  31 Two input executables must be created from the same objects,
  32 and have different loading addresses.
  33 Each of the load address is specified by a hexadecimal number.
  34 Load address shall be multiple of 4 for
  35 .Xr as 1
  36 and
  37 .Xr ld 1
  38 of
  39 .Nx Ns Tn /m68k .
  40 .Pp
  41 If the output file is not specified by
  42 .Fl o
  43 option, the name
  44 .Pa out.x
  45 is used.
  46 .Sh FILES
  47 .Bl -tag -width out.xxxx -compact
  48 .It Pa out.x
  49 default output file.
  50 .El
  51 .Sh EXAMPLES
  52 The following command sequence creates a Human68k executable
  53 .Pa foo.x
  54 from object files
  55 .Pa a.o
  56 and
  57 .Pa b.o :
  58 .Bd -literal -offset indent
  59 cc -N -nostdlib -static -Wl,-Text,0        -o aout1 a.o b.o
  60 cc -N -nostdlib -static -Wl,-Text,10203040 -o aout2 a.o b.o
  61 aout2hux -o foo.x aout1 0 aout2 10203040
  62 .Ed
  63 .Pp
  64 This 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
  71 The
  72 .Nm
  73 utility first appeared in
  74 .Nx 1.4 .
  75 .Sh BUGS
  76 Symbol and debugging information is not converted.
  77 .Pp
  78 The generated executable is not so effective as that of
  79 Human68k native compiler.