From 5edbdc57413c009ffd1abf0793fc9cd1380a7fe0 Mon Sep 17 00:00:00 2001
From: Bryce Denney <bryce@tlw.com>
Date: Tue, 13 Nov 2001 00:01:57 +0000
Subject: [PATCH] - copied Volker's instructions on mounting a disk image in
 Linux from   misc.txt into the user guide.

---
 bochs/doc/docbook/misc.txt      | 62 ++-------------------------------
 bochs/doc/docbook/user/user.dbk | 61 +++++++++++++++++++++++++++++---
 2 files changed, 59 insertions(+), 64 deletions(-)

diff --git a/bochs/doc/docbook/misc.txt b/bochs/doc/docbook/misc.txt
index 9297e0f86..152629b3b 100644
--- a/bochs/doc/docbook/misc.txt
+++ b/bochs/doc/docbook/misc.txt
@@ -1,66 +1,8 @@
-$Id: misc.txt,v 1.3 2001-10-31 20:53:18 bdenney Exp $
+$Id: misc.txt,v 1.4 2001-11-13 00:01:57 bdenney Exp $
 
 This is a temporary place to paste in stuff that should go into the docs one
 day.  When it is transferred into docbook, let's remove it from misc.txt.
 
---------------------------------------------------------------------------
-From Volker.Ruppert@t-online.de Wed Oct 31 14:48:58 2001
-Date: Sat, 13 Oct 2001 21:43:02 +0200
-From: Volker Ruppert <Volker.Ruppert@t-online.de>
-To: Bryce Denney <bryce@tlw.com>
-Subject: Bochs documentation: loop device
-
-    [ The following text is in the "iso-8859-1" character set. ]
-    [ Your display is set for the "US-ASCII" character set.  ]
-    [ Some characters may be displayed incorrectly. ]
-
-Hello Bryce,
-
-today I have made some tests with the loop device, because I want to exchange 
-files with the bochs disk images. This part of the bochs documentation is 
-still missing. This is what I found out:
-
-1.  In the bochs documentation appears the term "loopback". That's not O.K.,
-    because the loopback device is a network device. To prevent a mistake, it
-    should be renamed.
-
-2.  Using Floppy images is easy, because there is no partition table:
-
-    losetup /dev/loop0 /usr/local/bochs/dlxlinux/floppya.img
-
-    Now you can use the image like a real floppy:
-
-    - format           : mkfs.minix /dev/loop0
-    - filesystem check : fsck.minix /dev/loop0
-    - mount            : mount /dev/loop0 -o loop /mnt/floppy
-
-    Before you want to restart bochs you must do this:
-
-    losetup -d /dev/loop0
-
-    Don't forget to umount before.
-
-3.  If you want access to a harddisk image, you have to calculate the size of
-    the first cylinder. This value is the offset argument for losetup.
-
-    offset = bytes per sector * sectors per cylinder
-
-    The command for dlxlinux image looks like this:
-
-    losetup /dev/loop0 /usr/local/bochs/dlxlinux/hd10meg.img -o 8704
-
-    For images created by bximage you must use the value 32256.
-
-4.  The harddisk image access doesn't work if the image contains more than
-    one partition.
-
-5.  I have made this tests with linux and I don't know how
-    this could be done with other operating systems.
-
--- 
-Bye
-
-Volker
 --------------------------------------------------------------------------
 --------------------------------------------------------------------------
 --------------------------------------------------------------------------
@@ -91,7 +33,7 @@ following prompt:
 ========================================================================
                                 bximage
                   Disk Image Creation Tool for Bochs
-         $Id: misc.txt,v 1.3 2001-10-31 20:53:18 bdenney Exp $
+         $Id: misc.txt,v 1.4 2001-11-13 00:01:57 bdenney Exp $
 ========================================================================
 
 Do you want to create a floppy disk image or a hard disk image?
diff --git a/bochs/doc/docbook/user/user.dbk b/bochs/doc/docbook/user/user.dbk
index 929e7c070..998154588 100644
--- a/bochs/doc/docbook/user/user.dbk
+++ b/bochs/doc/docbook/user/user.dbk
@@ -1,7 +1,7 @@
 <!--
 ================================================================
 doc/docbook/user/user.dbk
-$Id: user.dbk,v 1.13 2001-11-12 21:51:10 vasudeva Exp $
+$Id: user.dbk,v 1.14 2001-11-13 00:01:57 bdenney Exp $
 
 This is the top level file for the Bochs Users Manual.
 ================================================================
@@ -2022,10 +2022,63 @@ and 0 turns it off.
 
 <chapter><title>Tips and Techniques</title>
     <para>
-	Mount disk image in loopback
-        Using two hard disks
-	[...]
+      <screen>
+Ideas:
+- Using two hard disks
+      </screen>
     </para>
+
+<section> <title>Linux: Mounting a disk image using the loop device</title>
+<para>
+This section was contributed by Volker Ruppert.  It describes how to
+access a floppy or hard disk image within Linux using the loop device.
+Why would you want to do this?  Let's say you have made a small Linux 
+disk image for Bochs, and you want to install some more software on it.
+You have already downloaded the software onto your real system, so now
+you want to transfer it to the Bochs disk image.  A fast way to transfer
+the files is to mount the disk image using the loop device.
+</para>
+<para>
+Here is what Volker writes:
+<screen>
+Today I have made some tests with the loop device, because I want to exchange 
+files with the bochs disk images.  This is what I found out:
+
+1.  Using Floppy images is easy, because there is no partition table:
+
+    losetup /dev/loop0 /usr/local/bochs/dlxlinux/floppya.img
+
+    Now you can use the image like a real floppy:
+
+    - format           : mkfs.minix /dev/loop0
+    - filesystem check : fsck.minix /dev/loop0
+    - mount            : mount /dev/loop0 -o loop /mnt/floppy
+
+    Before you want to restart bochs you must do this:
+
+    losetup -d /dev/loop0
+
+    Don't forget to umount before.
+
+2.  If you want access to a harddisk image, you have to calculate the size of
+    the first cylinder. This value is the offset argument for losetup.
+
+    offset = bytes per sector * sectors per cylinder
+
+    The command for dlxlinux image looks like this:
+
+    losetup /dev/loop0 /usr/local/bochs/dlxlinux/hd10meg.img -o 8704
+
+    For images created by bximage you must use the value 32256.
+
+3.  The harddisk image access doesn't work if the image contains more than
+    one partition.
+
+4.  I have made this tests with linux and I don't know how
+    this could be done with other operating systems.
+</screen>
+</para>
+</section>
 </chapter>
 <chapter><title>Guest operating systems</title>
 	<section><title>Linux</title>