remove realemu manpage from src dir
This commit is contained in:
cinap_lenrek
parent
f9c1d16835
commit
2a46d5c4f9
2 changed files with 0 additions and 108 deletions
|
|
@ -1,13 +1,9 @@
|
||||||
</$objtype/mkfile
|
</$objtype/mkfile
|
||||||
|
|
||||||
BIN=/$objtype/bin/aux
|
BIN=/$objtype/bin/aux
|
||||||
MAN=/sys/man/8
|
|
||||||
|
|
||||||
TARG=realemu
|
TARG=realemu
|
||||||
OFILES=decode.$O arg.$O xec.$O fmt.$O pit.$O main.$O
|
OFILES=decode.$O arg.$O xec.$O fmt.$O pit.$O main.$O
|
||||||
HFILES=dat.h fns.h
|
HFILES=dat.h fns.h
|
||||||
|
|
||||||
</sys/src/cmd/mkone
|
</sys/src/cmd/mkone
|
||||||
|
|
||||||
install:V:
|
|
||||||
cp $TARG.man $MAN/$TARG
|
|
||||||
|
|
|
||||||
|
|
@ -1,104 +0,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)
|
|
||||||
Loading…
Reference in a new issue