diff --git a/bochs/doc/docbook/user/user.dbk b/bochs/doc/docbook/user/user.dbk index 7f51005bb..420fffdd8 100644 --- a/bochs/doc/docbook/user/user.dbk +++ b/bochs/doc/docbook/user/user.dbk @@ -6098,7 +6098,7 @@ You will be greeted with the following prompt: ======================================================================== bximage Disk Image Creation / Conversion / Resize and Commit Tool for Bochs - $Id$ + $ID: bximage.cc 11906 2013-10-23 08:35:21Z vruppert $ ======================================================================== 1. Create new floppy or hard disk image @@ -8041,8 +8041,9 @@ in lba order.
image creation -Disk images for the usage in 'concat' mode can be created with the bximage -utility (see for more information). +Disk images for the usage in 'concat' mode can be created as 'flat' mode image +files with the bximage utility (see for more +information).
path @@ -8716,38 +8717,107 @@ Other arguments: filename2 convert/resize: destination image file commit: redolog (journal) file +Bximage: supported disk images modes (formats) + + + + Mode + Create / Resize / Convert target + Convert source / Commit base + + + + + flat + Yes + Yes + + + concat + Create only + No + + + dll + No + No + + + sparse + Yes + Yes + + + vmware3 + No + Yes + + + vmware4 + No + Yes + + + growing + Yes + Yes + + + vpc + Yes + Yes + + + +
Create image -&FIXME; Not yet written. +This function can be used to create several disk image formats for the +use with Bochs. See the table above for supported formats (modes). For an example of the usage, refer to .
Convert image -&FIXME; Not yet written. +With this function a disk image can be converted from one mode (format) +to another. The type of the source image is auto-detected. For the target +format it supports the same disk image modes as the create function. If the +name of the new image file is not specified and you decided not to remove +the source file, it will still be present with it's original name plus the +suffix ".orig".
Resize image -&FIXME; Not yet written. +This function can be used to increase the virtual disk size of an image. +It supports the same disk image modes as the create function. +Making a disk image smaller is not supported, since it may damage the +disk and data will be lost. If the name of the new image file is not +specified and you decided not to remove the source file, it will +still be present with it's original name plus the suffix ".orig".
Commit 'undoable' redolog to base image -&FIXME; Not yet written. For now see . +The type of the base image is auto-detected. The name of the redolog +file only needs to be specified if it is not based on the base image. +Removing the redolog file after commit is optional, but we recommend +to do that. Otherwise Bochs will complain about an unexpected modification +time of the base image. The legacy tool to commit redologs into flat files +is still supported, so please see .
Using the bxcommit tool -This tool can commit redologs into flat images. +This legacy tool has been designed to commit redologs into flat images. -For now, only "undoable" redologs to flat image commits and "growing" to flat -image conversion (and vice versa) are supported. Commiting / converting other -disk image types may be added in the future. +It supports committing 'undoable' redologs to 'flat' or 'growing' base images +and 'growing' to 'flat' image conversion (and vice versa). Committing / converting +other disk image types is supported by the new bximage utility (). This tool is completely interactive if no command line arguments are used. @@ -8766,7 +8836,7 @@ Supported options: -q quiet mode (don't prompt for user input) --help display this help and exit -The first filename parameter specifies the name of the flat image that will be +The first filename parameter specifies the name of the base image that will be created or modified. The second one specifies the name of the redolog. @@ -8779,7 +8849,7 @@ $ ./bxcommit Growing / Undoable Disk Image Commit Tool for Bochs ======================================================================== -1. Commit 'undoable' redolog to 'flat' file +1. Commit 'undoable' redolog to 'flat' or 'growing' mode base image 2. Create 'flat' disk image from 'growing' disk image 3. Create 'growing' disk image from 'flat' disk image @@ -8802,7 +8872,6 @@ Should the redolog been removed afterwards? - Guest operating systems In the past several tweaks were necessary to install a guest OS inside of Bochs.