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