.SH SYNOPSIS
.B 5e
[
-.B -npb
+.B -npbF
]
.I text
[
.I 5e
simulates the execution of an ARM binary in a Plan 9 environment.
Unlike its predecessor
-.IR 5i (1)
+.IR vi (1)
it supports, among others, the syscalls
-.IR rfork (2)
+rfork (see
+.IR fork (2))
and
.IR exec (2),
-i.e. it allows execution of threaded programs, e.g.
+which allows for the execution of threaded programs (e.g.,
.IR rio (1)
or
-.IR catclock (1).
+.IR catclock (1)).
.PP
.I 5e
executes the specified binary
.BR /rc/bin .
.PP
Unlike
-.IR 5i (1),
+.IR vi (1),
.IR 5e (1)
does not provide built-in debugging facilities.
It
causes failing processes to call
.IR abort (2)
instead of
-.IR sysfatal (2),
-but see below.
+.I sysfatal.
+See below.
+.TP
+.B -F
+Disable emulation of VFP floating point instructions.
.SH SOURCE
.B /sys/src/cmd/5e
.SH SEE ALSO
-.IR 5i (1)
+.IR vi (1)
.SH BUGS
The host is required to be little endian and is assumed to have a floating point implementation conforming to IEEE 754.
notes.
Obscure opcodes, in particular uncommon operations on R15, are not implemented.
-Careless use of the
-.B LDREX
-and
-.B STREX
-instructions can lead to deadlock, however a real processor is supposed behave undefined in these cases.
-Accesses spanning segment boundaries will be treated like page faults.
-Many syscalls like
+Accesses spanning segment boundaries will be treated as page faults.
+Many syscalls such as
.IR pread (2)
-will shuffle data around (in most cases unnecessarily), if invoked on potentially shared segments of variable length, in particular the bss segment.
+will shuffle data around (in most cases unnecessarily) if invoked on potentially shared segments of variable length, in particular the bss segment.
-FPA emulation leaves much to desire, rounding modes are ignored, all calculations are performed at extended precision.
+FPA emulation leaves much to be desired, rounding modes are ignored, all calculations are performed at extended precision.
Floating point exceptions crash the emulator.
Several syscalls, most notably the
The
.I text
-argument should behave more like it would if it was entered in
+argument should behave more like it would if it had been entered as an argument to
.IR rc (1).
+.SH HISTORY
+.I 5e
+first appeared in 9front (June, 2011).