- added some documentation for the 'vvfat' disk image mode (to be completed)
This commit is contained in:
Volker Ruppert
parent
9c4cca1144
commit
e809889d2a
@ -346,7 +346,7 @@ ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x360, irq=9
|
||||
# biosdetect= type of biosdetection [none|auto], only for disks on ata0 [cmos]
|
||||
# translation=type of translation of the bios, only for disks [none|lba|large|rechs|auto]
|
||||
# model= string returned by identify device command
|
||||
# journal= optional filename of the redolog for undoable and volatile disks
|
||||
# journal= optional filename of the redolog for undoable, volatile and vvfat disks
|
||||
#
|
||||
# Point this at a hard disk image file, cdrom iso file, or physical cdrom
|
||||
# device. To create a hard disk image, try running bximage. It will help you
|
||||
@ -384,6 +384,7 @@ ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x360, irq=9
|
||||
ata0-master: type=disk, mode=flat, path="30M.sample"
|
||||
#ata0-master: type=disk, mode=flat, path="30M.sample", cylinders=615, heads=6, spt=17
|
||||
#ata0-master: type=disk, mode=flat, path="c.img", cylinders=0 # autodetect
|
||||
#ata0-slave: type=disk, mode=vvfat, path=/bochs/images/vvfat, journal=vvfat.redolog
|
||||
#ata0-slave: type=cdrom, path=D:, status=inserted
|
||||
#ata0-slave: type=cdrom, path=/dev/cdrom, status=inserted
|
||||
#ata0-slave: type=cdrom, path="drive", status=inserted
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
<!--
|
||||
================================================================
|
||||
doc/docbook/user/user.dbk
|
||||
$Id: user.dbk,v 1.284 2010-12-11 08:25:39 vruppert Exp $
|
||||
$Id: user.dbk,v 1.285 2011-01-05 22:53:44 vruppert Exp $
|
||||
|
||||
This is the top level file for the Bochs Users Manual.
|
||||
================================================================
|
||||
@ -3308,7 +3308,7 @@ This defines the type and characteristics of all attached ata devices:
|
||||
<row>
|
||||
<entry> mode </entry>
|
||||
<entry> image type, only valid for disks </entry>
|
||||
<entry> [flat | concat | external | dll | sparse | vmware3 | vmware4 | undoable | growing | volatile ]</entry>
|
||||
<entry> [flat | concat | external | dll | sparse | vmware3 | vmware4 | undoable | growing | volatile | vvfat ]</entry>
|
||||
</row>
|
||||
<row> <entry> cylinders </entry> <entry> only valid for disks </entry> </row>
|
||||
<row> <entry> heads </entry> <entry> only valid for disks </entry> </row>
|
||||
@ -3317,6 +3317,7 @@ This defines the type and characteristics of all attached ata devices:
|
||||
<row> <entry> biosdetect </entry> <entry> type of biosdetection </entry> <entry> [none | auto], only for disks on ata0 [cmos] </entry> </row>
|
||||
<row> <entry> translation </entry> <entry> type of translation done by the BIOS (legacy int13), only for disks </entry> <entry> [none | lba | large | rechs | auto] </entry> </row>
|
||||
<row> <entry> model </entry> <entry> string returned by identify device ATA command </entry> </row>
|
||||
<row> <entry> journal </entry> <entry> optional filename of the redolog for undoable, volatile and vvfat disks </entry> </row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
@ -3407,6 +3408,9 @@ growing : growing file
|
||||
<listitem><para>
|
||||
volatile : flat file with volatile redolog
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
vvfat: local directory appears as read-only VFAT disk (with volatile redolog)
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
Please see <xref linkend="harddisk-modes"> for a discussion on disk modes.
|
||||
</para>
|
||||
@ -7352,6 +7356,11 @@ If unspecified, the default "mode" is flat.
|
||||
always rollbacked
|
||||
</entry>
|
||||
</row>
|
||||
<row> <entry> vvfat </entry> <entry> local directory appears as read-only VFAT disk (with volatile redolog) </entry>
|
||||
<entry>
|
||||
always rollbacked
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
@ -7917,6 +7926,66 @@ The flat disk images must be created with the bximage utility
|
||||
</section>
|
||||
</section>
|
||||
|
||||
<section><title>vvfat</title>
|
||||
<para>
|
||||
</para>
|
||||
<section><title>description</title>
|
||||
<para>
|
||||
The "vvfat" disk image mode is a port of Qemu's "virtual VFAT" block driver.
|
||||
It currently supports the read-only part of this implementation plus some
|
||||
additions. The structures of the virtual disk are created from the contents
|
||||
of the specified local directory when Bochs is starting. Writes to this
|
||||
virtual disk go to a volatile redolog, so they will be lost when Bochs
|
||||
quits and the files of the local directory are not modified.
|
||||
</para>
|
||||
<para>
|
||||
In addition to Qemu's "vvfat" implementation the Bochs one supports configurable
|
||||
disk geometry, FAT32 and reading MBR and/or boot sector from file. When using
|
||||
the autodetection feature, the CHS values 1024/16/63 (Qemu defaults) are used.
|
||||
To use an MBR image file from a real disk it must be named <filename>vvfat_mbr.bin</filename>
|
||||
and placed in the specified directory. Bochs uses the geometry and file system
|
||||
type from this file and doesn't show it on the virtual disk. The same applies
|
||||
to a boot sector image file, but it must be named <filename>vvfat_boot.bin</filename>.
|
||||
Using both image file is also possible.
|
||||
</para>
|
||||
<para>
|
||||
&FIXME; to be completed
|
||||
</para>
|
||||
</section>
|
||||
<section><title>image creation</title>
|
||||
<para>
|
||||
Not necessary. The directory must exist before running Bochs.
|
||||
</para>
|
||||
</section>
|
||||
<section><title>path</title>
|
||||
<para>
|
||||
The "path" option of the ataX-xxx directive in the configuration file
|
||||
must point to an existing local directory. The redolog name can be set
|
||||
with the "journal" option of the same directive. If not set, the redolog
|
||||
name is created by adding the filename "vvfat.dir.redolog" to the path.
|
||||
A random suffix is also appended to the redolog name.
|
||||
</para>
|
||||
</section>
|
||||
<section><title>external tools</title>
|
||||
<para>
|
||||
You can use your favourite file manager to copy file to the directory you'd
|
||||
like to use. The directory should not be modified while Bochs is running.
|
||||
</para>
|
||||
</section>
|
||||
<section><title>typical use</title>
|
||||
<para>
|
||||
Access to files of the host hard drive...
|
||||
&FIXME; to be completed
|
||||
</para>
|
||||
</section>
|
||||
<section><title>limitations</title>
|
||||
<para>
|
||||
No real write support present yet...
|
||||
&FIXME; to be completed
|
||||
</para>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
<!--
|
||||
<section><title>generic</title>
|
||||
<para>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
.\"Document Author: Timothy R. Butler - tbutler@uninetsolutions.com"
|
||||
.TH bochsrc 5 "11 Dec 2010" "bochsrc" "The Bochs Project"
|
||||
.TH bochsrc 5 "5 Jan 2011" "bochsrc" "The Bochs Project"
|
||||
.\"SKIP_SECTION"
|
||||
.SH NAME
|
||||
bochsrc \- Configuration file for Bochs.
|
||||
@ -377,7 +377,7 @@ This defines the type and characteristics of all attached ata devices:
|
||||
biosdetect= type of biosdetection [none|auto], only for disks on ata0 [cmos]
|
||||
translation=type of translation of the bios, only for disks [none|lba|large|rechs|auto]
|
||||
model= string returned by identify device command
|
||||
journal= optional filename of the redolog for undoable and volatile disks
|
||||
journal= optional filename of the redolog for undoable, volatile and vvfat disks
|
||||
|
||||
Point this at a hard disk image file, cdrom iso file,
|
||||
or a physical cdrom device.
|
||||
@ -404,6 +404,7 @@ The mode option defines how the disk image is handled. Disks can be defined as:
|
||||
- undoable : flat file with commitable redolog
|
||||
- growing : growing file
|
||||
- volatile : flat file with volatile redolog
|
||||
- vvfat: local directory appears as read-only VFAT disk (with volatile redolog)
|
||||
|
||||
The disk translation scheme (implemented in legacy int13 bios functions, and used by
|
||||
older operating systems like MS-DOS), can be defined as:
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user