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:
Timothy R.Butler 2001-06-03 22:35:07 +00:00
parent 2c66148a10
commit aa982d8e7e
4 changed files with 94 additions and 52 deletions

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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