mirror of https://github.com/bochs-emu/Bochs
Updated formatting to work better under man 2.3.0 (SuSE 7.1), and
hopefully other versions of man. I also added reference to Bryce's new Linux getting started guide.
This commit is contained in:
parent
2c66148a10
commit
aa982d8e7e
|
@ -1,5 +1,5 @@
|
||||||
.\Document Author: Timothy R. Butler - tbutler@uninetsolutions.com
|
.\Document Author: Timothy R. Butler - tbutler@uninetsolutions.com
|
||||||
.TH bochs-dlx 1 "The Bochs Project bochs-dlx 2 Jun 2001"
|
.TH bochs-dlx 1 "The Bochs Project bochs-dlx 3 Jun 2001"
|
||||||
.\"SKIP_SECTION"
|
.\"SKIP_SECTION"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
bochs-dlx \- Runs DLX-Linux under the Bochs x86 Emulator
|
bochs-dlx \- Runs DLX-Linux under the Bochs x86 Emulator
|
||||||
|
@ -37,6 +37,9 @@ bochs(1), bochsrc(1), bximage(1)
|
||||||
.nf
|
.nf
|
||||||
The Bochs IA-32 Emulator site on the World Wide Web:
|
The Bochs IA-32 Emulator site on the World Wide Web:
|
||||||
http://bochs.sourceforge.net
|
http://bochs.sourceforge.net
|
||||||
|
|
||||||
|
The Getting Started Guide for Bochs on Linux:
|
||||||
|
/usr/local/bochs/@VERSION@/DOC-linux.html
|
||||||
.fi
|
.fi
|
||||||
.\"SKIP_SECTION"
|
.\"SKIP_SECTION"
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
|
|
|
@ -51,6 +51,9 @@ bochsrc(1), bochs-dlx(1), bximage(1)
|
||||||
.nf
|
.nf
|
||||||
The Bochs IA-32 Emulator site on the World Wide Web:
|
The Bochs IA-32 Emulator site on the World Wide Web:
|
||||||
http://bochs.sourceforge.net
|
http://bochs.sourceforge.net
|
||||||
|
|
||||||
|
The Getting Started Guide for Bochs on Linux:
|
||||||
|
/usr/local/bochs/@VERSION@/DOC-linux.html
|
||||||
.fi
|
.fi
|
||||||
.\"SKIP_SECTION"
|
.\"SKIP_SECTION"
|
||||||
.SH AUTHORS
|
.SH AUTHORS
|
||||||
|
|
|
@ -19,10 +19,12 @@ home directory.
|
||||||
.TP
|
.TP
|
||||||
.I "romimage:"
|
.I "romimage:"
|
||||||
You need to load a ROM BIOS into F0000-FFFFF.
|
You need to load a ROM BIOS into F0000-FFFFF.
|
||||||
The BIOS controls what the PC does when it first powers on. Normally, you can
|
The BIOS controls what the PC does when it
|
||||||
use a precompiled BIOS in the
|
first powers on. Normally, you can use a
|
||||||
|
precompiled BIOS in the
|
||||||
.B bios/
|
.B bios/
|
||||||
directory, named BIOS-bochs-latest.
|
directory, named
|
||||||
|
BIOS-bochs-latest.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
romimage: file=bios/BIOS-bochs-970717
|
romimage: file=bios/BIOS-bochs-970717
|
||||||
|
@ -34,7 +36,8 @@ memory you want to emulate. You may also pass
|
||||||
the
|
the
|
||||||
.B 'megs:N'
|
.B 'megs:N'
|
||||||
option to bochs. The default
|
option to bochs. The default
|
||||||
is 32MB, since most OS's won't need more than that.
|
is 32MB, since most OS's won't need more than
|
||||||
|
that.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
megs: 32
|
megs: 32
|
||||||
|
@ -48,13 +51,19 @@ Example:
|
||||||
vgaromimage: bios/VGABIOS-elpin-2.40
|
vgaromimage: bios/VGABIOS-elpin-2.40
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.I "floppya/floppyb:"
|
.I "floppya:"
|
||||||
Point this to the pathname of a floppy image file or device. Floppya is the
|
or
|
||||||
first drive, and floppyb is the second drive. If you're booting from a floppy,
|
.I "floppyb:"
|
||||||
floppya should point to a bootable disk.
|
|
||||||
|
|
||||||
You can set the initial status of the media to 'ejected' or 'inserted'.
|
Point this to the pathname of a floppy image
|
||||||
Usually you will probably want 'inserted'.
|
file or device. Floppya is the first drive,
|
||||||
|
and floppyb is the second drive. If you're
|
||||||
|
booting from a floppy, floppya should point to
|
||||||
|
a bootable disk.
|
||||||
|
|
||||||
|
You can set the initial status of the media to
|
||||||
|
'ejected' or 'inserted'. Usually you will want
|
||||||
|
to use 'inserted'.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
|
|
||||||
|
@ -71,7 +80,10 @@ Example:
|
||||||
floppya: 720k=path, status=inserted
|
floppya: 720k=path, status=inserted
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.I "diskc/diskd:"
|
.I "diskc:"
|
||||||
|
or
|
||||||
|
.I "diskd:"
|
||||||
|
|
||||||
Point this at the disk image you want to use
|
Point this at the disk image you want to use
|
||||||
as for a hard disk. If you use bximage(1) to
|
as for a hard disk. If you use bximage(1) to
|
||||||
create the image, it will give you the
|
create the image, it will give you the
|
||||||
|
@ -83,9 +95,9 @@ second hard drive.
|
||||||
You cannot use both diskd and cdromd together.
|
You cannot use both diskd and cdromd together.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
diskc: file=10M.i, cyl=306, heads=4, spt=17
|
diskc: file=10M.i, cyl=306, heads=4, spt=17
|
||||||
diskc: file=112M.i, cyl=900, heads=15, spt=17
|
diskc: file=112M.i, cyl=900, heads=15, spt=17
|
||||||
diskd: file=483.i, cyl=1024, heads=15, spt=63
|
diskd: file=483.i, cyl=1024, heads=15, spt=63
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.I "cdromd:"
|
.I "cdromd:"
|
||||||
|
@ -133,18 +145,24 @@ Example:
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.I "panic:"
|
.I "panic:"
|
||||||
If Bochs reaches a condition where it cannot emulate correctly, it does a
|
If Bochs reaches a condition where it cannot
|
||||||
panic. This can be a configuration problem (like a misspelled bochsrc line) or
|
emulate correctly, it does a panic. This can
|
||||||
an emulation problem (like an unsupported video mode). The "panic" setting in
|
be a configuration problem (like a misspelled
|
||||||
bochsrc tells Bochs how to respond to a panic. You can set this to fatal
|
bochsrc line) or an emulation problem (like an
|
||||||
(terminate the session), report (print information to the console), or
|
unsupported video mode). The "panic" setting
|
||||||
ignore (do nothing).
|
in bochsrc tells Bochs how to respond to a
|
||||||
|
panic. You can set this to fatal (terminate
|
||||||
|
the session), report (print information to
|
||||||
|
the console), or ignore (do nothing).
|
||||||
|
|
||||||
The safest setting is action=fatal. If you are getting panics, you can try
|
The safest setting is action=fatal. If you are
|
||||||
action=report instead. If you allow Bochs to continue after a panic, don't be
|
getting panics, you can try action=report
|
||||||
surprised if you get strange behavior or crashes if a panic occurs. Please
|
instead. If you allow Bochs to continue after
|
||||||
report panic messages unless it is just a configuration problem like "could not
|
a panic, don't be surprised if you get strange
|
||||||
find hard drive image."
|
behavior or crashes if a panic occurs. Please
|
||||||
|
report panic messages unless it is just a
|
||||||
|
configuration problem like "could not find
|
||||||
|
hard drive image."
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
panic: action=fatal
|
panic: action=fatal
|
||||||
|
@ -152,38 +170,48 @@ Example:
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.I "error:"
|
.I "error:"
|
||||||
Bochs produces an an error message when it finds a condition that really
|
Bochs produces an error message when it finds
|
||||||
shouldn't happen, but doesn't endanger the simulation. An example of an
|
a condition that really shouldn't happen, but
|
||||||
error might be if the emulated software produces an illegal disk command.
|
doesn't endanger the simulation. An example of
|
||||||
|
an error might be if the emulated software
|
||||||
|
produces an illegal disk command.
|
||||||
|
|
||||||
The "error:" setting tells Bochs how to respond to an error condition. You
|
The "error" setting tells Bochs how to respond
|
||||||
can set this to fatal (terminate the session) , report (print information to
|
to an error condition . You can set this to
|
||||||
the console), or ignore (do nothing).
|
fatal (terminate the session), report (print
|
||||||
|
information to the console), or ignore (do
|
||||||
|
nothing).
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
error: action=report
|
error: action=report
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.I "info:"
|
.I "info:"
|
||||||
This setting tells Bochs what to do when an event occurs that generates
|
This setting tells Bochs what to do when an
|
||||||
informational messages. You can set this to fatal (that would not be very
|
event occurs that generates informational
|
||||||
smart though), report (print information to the console), or ignore (do
|
messages. You can set this to fatal (that
|
||||||
nothing). For general usage, the "report" option is probably a good choice.
|
would not be very smart though), report (print
|
||||||
|
information to the console), or ignore (do
|
||||||
|
nothing). For general usage, the "report"
|
||||||
|
option is probably a good choice.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
info: action=report
|
info: action=report
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.I "debug:"
|
.I "debug:"
|
||||||
This setting tells Bochs what to do with messages intended to assist in
|
This setting tells Bochs what to do with
|
||||||
debugging. You can set this to fatal (but you shouldn't), report (print
|
messages intended to assist in debugging. You
|
||||||
information to the console), or ignore (do nothing). You should
|
can set this to fatal (but you shouldn't),
|
||||||
generally set this to ignore, unless you are trying to diagnose a particular
|
report (print information to the console), or
|
||||||
problem.
|
ignore (do nothing). You should generally set
|
||||||
|
this to ignore, unless you are trying to
|
||||||
|
diagnose a particular problem.
|
||||||
|
|
||||||
.B NOTE:
|
.B NOTE:
|
||||||
When action=report, Bochs may spit out thousands of debug messages per
|
When action=report, Bochs may spit out
|
||||||
second, which can impact performance and fill up your disk.
|
thousands of debug messages per second, which
|
||||||
|
can impact performance and fill up your disk.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
debug: action=ignore
|
debug: action=ignore
|
||||||
|
@ -304,9 +332,11 @@ using instructions included in config.h (in
|
||||||
the source code), to find your workstation's
|
the source code), to find your workstation's
|
||||||
capability.
|
capability.
|
||||||
|
|
||||||
IPS is used to calibrate many time-dependent events within the bochs
|
IPS is used to calibrate many time-dependent
|
||||||
simulation. For example, changing IPS affects the frequency of VGA updates, the
|
events within the bochs simulation. For
|
||||||
duration of time before a key starts to autorepeat, and the measurement of
|
example, changing IPS affects the frequency of
|
||||||
|
VGA updates, the duration of time before a key
|
||||||
|
starts to autorepeat, and the measurement of
|
||||||
BogoMips and other benchmarks.
|
BogoMips and other benchmarks.
|
||||||
|
|
||||||
Example Specifications[1]
|
Example Specifications[1]
|
||||||
|
@ -315,9 +345,9 @@ Example Specifications[1]
|
||||||
650Mhz Athlon K-7 with Linux 2.4.x 2 to 2.5
|
650Mhz Athlon K-7 with Linux 2.4.x 2 to 2.5
|
||||||
400Mhz Pentium II with Linux 2.0.x 1 to 1.8
|
400Mhz Pentium II with Linux 2.0.x 1 to 1.8
|
||||||
166Mhz 64bit Sparc with Solaris 2.x 0.75
|
166Mhz 64bit Sparc with Solaris 2.x 0.75
|
||||||
200Mhz Pentium with Linux 2.x 0.5
|
200Mhz Pentium with Linux 2.x 0.5
|
||||||
|
|
||||||
[1] Mips are dependant on OS and compiler
|
[1] Mips are dependant on OS and compiler
|
||||||
configuration in addition to processor clock
|
configuration in addition to processor clock
|
||||||
speed.
|
speed.
|
||||||
|
|
||||||
|
@ -369,7 +399,10 @@ bochs(1), bochs-dlx(1), bximage(1)
|
||||||
.PP
|
.PP
|
||||||
.nf
|
.nf
|
||||||
The Bochs IA-32 Emulator site on the World Wide Web:
|
The Bochs IA-32 Emulator site on the World Wide Web:
|
||||||
http://bochs.sourceforge.net
|
http://bochs.sourceforge.net
|
||||||
|
|
||||||
|
The Getting Started Guide for Bochs on Linux:
|
||||||
|
/usr/local/bochs/@VERSION@/DOC-linux.html
|
||||||
.fi
|
.fi
|
||||||
.\"SKIP_SECTION"
|
.\"SKIP_SECTION"
|
||||||
.SH AUTHORS
|
.SH AUTHORS
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
.\Document Author: Timothy R. Butler - tbutler@uninetsolutions.com
|
.\Document Author: Timothy R. Butler - tbutler@uninetsolutions.com
|
||||||
.TH bximage 1 "The Bochs Project bximage 2 Jun 2001"
|
.TH bximage 1 "The Bochs Project bximage 3 Jun 2001"
|
||||||
.\"SKIP_SECTION"
|
.\"SKIP_SECTION"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
bximage \- Interactive Disk Image Creator for Bochs
|
bximage \- Interactive Disk Image Creator for Bochs
|
||||||
|
@ -31,11 +31,14 @@ bochs(1), bochsrc(1), bochs-dlx(1)
|
||||||
.nf
|
.nf
|
||||||
The Bochs IA-32 Emulator site on the World Wide Web:
|
The Bochs IA-32 Emulator site on the World Wide Web:
|
||||||
http://bochs.sourceforge.net
|
http://bochs.sourceforge.net
|
||||||
|
|
||||||
|
The Getting Started Guide for Bochs on Linux:
|
||||||
|
/usr/local/bochs/@VERSION@/DOC-linux.html
|
||||||
.fi
|
.fi
|
||||||
.\"SKIP_SECTION"
|
.\"SKIP_SECTION"
|
||||||
.SH AUTHORS
|
.SH AUTHORS
|
||||||
Bximage was written by Bryce Denney, based on several similar
|
Bximage was written by Bryce Denney, based on several
|
||||||
tools from the bochs-developers list.
|
similar tools from the bochs-developers list.
|
||||||
.\"SKIP_SECTION"
|
.\"SKIP_SECTION"
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
Please report all bugs to the bug tracker on our web
|
Please report all bugs to the bug tracker on our web
|
||||||
|
|
Loading…
Reference in New Issue