1999-07-28 20:09:52 +00:00
|
|
|
.\" Copyright (c) 1999 Stefan Esser
|
|
|
|
|
.\"
|
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
|
.\" are met:
|
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
|
.\"
|
1999-08-28 01:35:59 +00:00
|
|
|
.\" $FreeBSD$
|
1999-07-28 20:09:52 +00:00
|
|
|
.\"
|
|
|
|
|
.Dd July 26, 1999
|
2002-05-23 07:38:51 +00:00
|
|
|
.Dt ELF2EXE 8 Alpha
|
2001-07-10 15:12:08 +00:00
|
|
|
.Os
|
1999-07-28 20:09:52 +00:00
|
|
|
.Sh NAME
|
|
|
|
|
.Nm elf2exe
|
|
|
|
|
.Nd convert Alpha ELF executable to AlphaBIOS / ARCS format
|
|
|
|
|
.Sh SYNOPSIS
|
2000-11-20 20:10:44 +00:00
|
|
|
.Nm
|
1999-07-28 20:09:52 +00:00
|
|
|
.Ar infile
|
|
|
|
|
.Ar outfile
|
|
|
|
|
.Sh DESCRIPTION
|
2002-07-14 14:47:15 +00:00
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
utility
|
1999-07-28 20:09:52 +00:00
|
|
|
creates an executable that can be loaded by the AlphaBIOS or ARCS consoles
|
2001-07-15 08:06:20 +00:00
|
|
|
as found on systems designed for
|
1999-07-28 20:09:52 +00:00
|
|
|
.Tn Windows/NT .
|
2001-07-15 08:06:20 +00:00
|
|
|
The input file must have been
|
|
|
|
|
created as a non-relocatable standalone binary with a load address within
|
1999-07-28 20:09:52 +00:00
|
|
|
the memory range available for user programs (0x80000000 to 0x806fdfff
|
|
|
|
|
and 0x80900000 to at least 0x80ffffff).
|
|
|
|
|
.Pp
|
2001-07-15 08:06:20 +00:00
|
|
|
The command prints a list of sections found in the ELF executable and the
|
1999-07-28 20:09:52 +00:00
|
|
|
section sizes and offsets of the output file for diagnostic purposes.
|
|
|
|
|
.Pp
|
2001-07-15 08:06:20 +00:00
|
|
|
Given an object file
|
2000-12-27 15:30:30 +00:00
|
|
|
.Pa src.o
|
1999-08-02 17:45:21 +00:00
|
|
|
the following two commands will create a binary for ARCS:
|
2001-08-20 08:29:55 +00:00
|
|
|
.Bd -literal -offset indent
|
|
|
|
|
ld -o a.out -M -N -Ttext 0x80900000 src.o
|
|
|
|
|
elf2exe a.out a.exe
|
|
|
|
|
.Ed
|
1999-07-28 20:09:52 +00:00
|
|
|
.Sh BUGS
|
2002-07-14 14:47:15 +00:00
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
utility
|
2001-07-15 08:06:20 +00:00
|
|
|
does not even attempt to verify that the input file matches the requirements
|
1999-07-28 20:09:52 +00:00
|
|
|
for an ARC executable.
|
|
|
|
|
.Sh HISTORY
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
2002-07-14 14:47:15 +00:00
|
|
|
utility appeared in
|
1999-08-02 17:45:21 +00:00
|
|
|
.Fx 4.0 .
|
