ref: 2a46d5c4f96294786a5cfab4b382e75c57b08744
parent: f9c1d16835f3c006b24e204b38255e617cf0edb4
author: cinap_lenrek <cinap_lenrek@localhost>
date: Tue Apr 12 13:48:02 EDT 2011
remove realemu manpage from src dir
--- a/sys/src/cmd/aux/realemu/mkfile
+++ b/sys/src/cmd/aux/realemu/mkfile
@@ -1,7 +1,6 @@
</$objtype/mkfile
BIN=/$objtype/bin/aux
-MAN=/sys/man/8
TARG=realemu
OFILES=decode.$O arg.$O xec.$O fmt.$O pit.$O main.$O
@@ -8,6 +7,3 @@
HFILES=dat.h fns.h
</sys/src/cmd/mkone
-
-install:V:
- cp $TARG.man $MAN/$TARG
--- a/sys/src/cmd/aux/realemu/realemu.man
+++ /dev/null
@@ -1,104 +1,0 @@
-.TH realemu 8
-.SH NAME
-realemu \- software emulation of /dev/realmode
-.SH SYNOPSIS
-.B aux/realemu
-[
-.B -Dpt
-] [
-.B -s
-.I srvname
-] [
-.B -m
-.I mountpoint
-]
-.SH DESCRIPTION
-.PP
-Originally, kernel provided
-.B /dev/realmode
-files with the
-.IR arch (3)
-device to access and call the
-.SM BIOS.
-.PP
-Interrupts had to be disabled and the processor was switched in the
-legacy 16-bit
-.SM realmode
-with memory protection disabled to execute
-.SM BIOS
-code.
-.PP
-This is problematic in case the
-.SM BIOS
-reprograms hardware currently
-used by the operating system or when it reenables interrupts or just
-crashes. This will freeze or reboot the machine with no way to
-recover or diagnose the problem.
-.PP
-To avoid this,
-.I realemu
-is used to emulate the execution of the
-.SM BIOS
-routines by interpreting the machine instructions and intercepting
-dangerous actions that would compromise the systems stability.
-.PP
-Running
-.I realemu
-with no arguments, it mounts itself before
-.B /dev
-and
-replaces the original
-.B /dev/realmode
-file in the current namespace.
-.PP
-Then programs like
-.IR vga (8)
-can use it to make ther
-.SM BIOS
-calls.
-.PP
-The
-.B D
-flag will enable debug messages for 9P. The
-.B p
-and
-.B t
-flags
-control tracing of i/o port access and cpu instructions to
-stderr (fd 2).
-.PP
-When a
-.I srvname
-is given with the
-.B s
-argument, the default
-.I mountpoint
-is ignored and a
-.SM 9P
-channel is created in
-.B /srv
-that can be used to mount
-the filesystem from another namespace. If a
-.I mountpoint
-is given before
-the
-.I srvname
-argument then it is ignored, otherwise it will be used.
-.SH EXAMPLES
-The
-.I realemu
-process is only needed when accessing
-.B /dev/realmode.
-To invoke a subshell so that
-.I realemu
-exits normally after
-.B aux/vga
-completes:
-.IP
-.EX
-% @{rfork n; aux/realemu; aux/vga -m vesa -l $vgasize}
-.SH SOURCE
-.B /sys/src/cmd/aux/realemu
-.SH "SEE ALSO"
-.IR vga (8),
-.IR arch (3)