Add sigtimedwait.o and sigwaitinfo.o.
[dragonfly.git] / 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 .