usr.sbin/elf2exe/elf2exe.8

   1 .\" Copyright (c) 1999 Stefan Esser
   2 .\"
   3 .\" Redistribution and use in source and binary forms, with or without
   4 .\" modification, are permitted provided that the following conditions
   5 .\" are met:
   6 .\" 1. Redistributions of source code must retain the above copyright
   7 .\"    notice, this list of conditions and the following disclaimer.
   8 .\" 2. Redistributions in binary form must reproduce the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer in the
  10 .\"    documentation and/or other materials provided with the distribution.
  11 .\"
  12 .\" $FreeBSD: src/usr.sbin/elf2exe/elf2exe.8,v 1.3.2.8 2003/03/11 21:13:48 trhodes Exp $
  13 .\" $DragonFly: src/usr.sbin/elf2exe/Attic/elf2exe.8,v 1.2 2003/06/17 04:29:53 dillon Exp $
  14 .\"
  15 .Dd July 26, 1999
  16 .Dt ELF2EXE 8 Alpha
  17 .Os
  18 .Sh NAME
  19 .Nm elf2exe
  20 .Nd convert Alpha ELF executable to AlphaBIOS / ARCS format
  21 .Sh SYNOPSIS
  22 .Nm
  23 .Ar infile
  24 .Ar outfile
  25 .Sh DESCRIPTION
  26 The
  27 .Nm
  28 utility
  29 creates an executable that can be loaded by the AlphaBIOS or ARCS consoles
  30 as found on systems designed for
  31 .Tn Windows/NT .
  32 The input file must have been
  33 created as a non-relocatable standalone binary with a load address within
  34 the memory range available for user programs (0x80000000 to 0x806fdfff
  35 and 0x80900000 to at least 0x80ffffff).
  36 .Pp
  37 The command prints a list of sections found in the ELF executable and the
  38 section sizes and offsets of the output file for diagnostic purposes.
  39 .Pp
  40 Given an object file
  41 .Pa src.o
  42 the following two commands will create a binary for ARCS:
  43 .Bd -literal -offset indent
  44 ld -o a.out -M -N -Ttext 0x80900000 src.o
  45 elf2exe a.out a.exe
  46 .Ed
  47 .Sh BUGS
  48 The
  49 .Nm
  50 utility
  51 does not even attempt to verify that the input file matches the requirements
  52 for an ARC executable.
  53 .Sh HISTORY
  54 The
  55 .Nm
  56 utility appeared in
  57 .Fx 4.0 .