REALEMU(8) REALEMU(8)
NAME
realemu - software emulation of /dev/realmode
SYNOPSIS
aux/realemu [ -Dpt ] [ -s srvname ] [ -m mntpt ]
DESCRIPTION
Originally, the kernel provided /dev/realmode and
/dev/realmodemem files via arch(3). These devices provided
access to real mode memory and BIOS calls.
Interrupts were disabled and the processor switched to 16-
bit "real mode" to fit the BIOS api. If BIOS reprograms
hardware in use or reenables interrupts or crashes, the sys-
tem may freeze or reboot with little ability for diagnosis
or recovery. To avoid this, realemu emulates BIOS by inter-
preting the code intercepting dangerous actions that could
compromise the system.
With no arguments, realemu mounts itself before /dev and
serves /dev/realmode. Flag D will enable 9P debugging; flag
p traces i/o port access; t traces instructions. The -s
flag causes realemu to post its channel on /srv/mntpt and
the default mntpt is ignored. If mntpt is given before
srvname argument then it is ignored, otherwise it will be
used.
EXAMPLES
Realemu is only needed when accessing /dev/realmode. To
invoke a subshell so that realemu exits normally after
aux/vga completes:
; @{rfork n; aux/realemu; aux/vga -m vesa -l $vgasize}
SOURCE
/sys/src/cmd/aux/realemu
SEE ALSO
vga(8), arch(3)
Page 1 Plan 9 (printed 12/14/25)