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 .\"
  14 .Dd July 26, 1999
  15 .Dt ELF2EXE 8 Alpha
  16 .Os
  17 .Sh NAME
  18 .Nm elf2exe
  19 .Nd convert Alpha ELF executable to AlphaBIOS / ARCS format
  20 .Sh SYNOPSIS
  21 .Nm
  22 .Ar infile
  23 .Ar outfile
  24 .Sh DESCRIPTION
  25 The
  26 .Nm
  27 utility
  28 creates an executable that can be loaded by the AlphaBIOS or ARCS consoles
  29 as found on systems designed for
  30 .Tn Windows/NT .
  31 The input file must have been
  32 created as a non-relocatable standalone binary with a load address within
  33 the memory range available for user programs (0x80000000 to 0x806fdfff
  34 and 0x80900000 to at least 0x80ffffff).
  35 .Pp
  36 The command prints a list of sections found in the ELF executable and the
  37 section sizes and offsets of the output file for diagnostic purposes.
  38 .Pp
  39 Given an object file
  40 .Pa src.o
  41 the following two commands will create a binary for ARCS:
  42 .Bd -literal -offset indent
  43 ld -o a.out -M -N -Ttext 0x80900000 src.o
  44 elf2exe a.out a.exe
  45 .Ed
  46 .Sh BUGS
  47 The
  48 .Nm
  49 utility
  50 does not even attempt to verify that the input file matches the requirements
  51 for an ARC executable.
  52 .Sh HISTORY
  53 The
  54 .Nm
  55 utility appeared in
  56 .Fx 4.0 .