/[gxemul]/trunk/doc/misc.html
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /trunk/doc/misc.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 37 by dpavlin, Mon Oct 8 16:21:17 2007 UTC revision 38 by dpavlin, Mon Oct 8 16:21:53 2007 UTC
# Line 10  Line 10 
10    
11  <!--  <!--
12    
13  $Id: misc.html,v 1.66 2006/12/30 13:30:51 debug Exp $  $Id: misc.html,v 1.67 2007/03/24 06:39:29 debug Exp $
14    
15  Copyright (C) 2003-2007  Anders Gavare.  All rights reserved.  Copyright (C) 2003-2007  Anders Gavare.  All rights reserved.
16    
# Line 51  SUCH DAMAGE. Line 51  SUCH DAMAGE.
51          developing firmware, using GXemul</a>          developing firmware, using GXemul</a>
52    <li><a href="#compilercontruct">Using GXemul in compiler contruction courses</a>    <li><a href="#compilercontruct">Using GXemul in compiler contruction courses</a>
53    <li><a href="#disk">How to start the emulator with a disk image</a>    <li><a href="#disk">How to start the emulator with a disk image</a>
54      <li><a href="#tape_images">How to start the emulator with tape images</a>
55      <li><a href="#disk_overlays">How to use disk image overlays</a>
56    <li><a href="#filexfer">Transfering files to/from the guest OS</a>    <li><a href="#filexfer">Transfering files to/from the guest OS</a>
57    <li><a href="#largeimages">How to extract large gzipped disk images</a>    <li><a href="#largeimages">How to extract large gzipped disk images</a>
58    <li><a href="#userland">Running userland binaries</a>    <li><a href="#userland">Running userland binaries</a>
# Line 197  use it as a CD-ROM directly accessible f Line 199  use it as a CD-ROM directly accessible f
199  </pre>  </pre>
200  It is probably possible to use harddisks as well this way, but I would not  It is probably possible to use harddisks as well this way, but I would not
201  recommend it.  recommend it.
202  <p>  
203    
204    
205    
206    
207    
208    <p><br>
209    <a name="tape_images"></a>
210    <h3>How to start the emulator with tape images:</h3>
211    
212  Using emulated tape drives is a bit more complicated than disks, because a  Using emulated tape drives is a bit more complicated than disks, because a
213  tape can be made up of several "files" with space in between. The solution  tape can be made up of several "files" with space in between. The solution
214  I have choosen is to have one file in the host's file system space for each  I have choosen is to have one file in the host's file system space for each
# Line 247  every time a tape is rewound, it is reop Line 258  every time a tape is rewound, it is reop
258  on the command line. By changing what the symbolic name points to,  on the command line. By changing what the symbolic name points to,
259  you can "switch tapes" without quiting and restarting the emulator.  you can "switch tapes" without quiting and restarting the emulator.
260    
261    <p>
262    <font color="#ff0000">Note: Tape support is most likely very buggy,
263    because it has not been tested much, and has probably also suffered
264    from bit-rot by now.</font>
265    
266    
267    
268    
269    
270    
271    <p><br>
272    <a name="disk_overlays"></a>
273    <h3>How to use disk image overlays:</h3>
274    
275    This is most likely best understood by an example:
276    
277    <p><ul>
278      <li>Install e.g. <a href="guestoses.html#netbsdcatsinstall">NetBSD/cats</a>.
279            You will end up with a disk image called
280            <tt>nbsd_cats.img</tt>.
281      <p>
282      <li>Running the following command will boot straight from the disk
283            image, with no overlay images:<pre>
284            <b>gxemul -XEcats -d nbsd_cats.img netbsd.aout-GENERIC.gz</b>
285    
286    </pre>
287      <li>You may now create an overlay file, a corresponding map file,
288            and start the emulator with the overlay image connected to
289            the same (explicit) ID as the base disk image:<pre>
290            <b>touch overlay.img overlay.img.map
291            gxemul -XEcats -d 0:nbsd_cats.img -d V0:overlay.img netbsd.aout-GENERIC.gz</b>
292    
293    </pre>
294      <li>Any changes to the filesystem you perform when using the overlay
295            will only be written to that overlay. For example, to perform
296            a "roll back", you can do the following:<pre>
297            <b>rm -f overlay.img overlay.img.map
298            touch overlay.img overlay.img.map</b>
299    
300    </pre>
301            and then simply start the emulator again, with the newly created
302            overlay image.
303    </ul>
304    
305    <p>It is also possible to add multiple overlays. In that case, writes
306    always go the the <i>last</i> added overlay.
307    
308    <p>GXemul uses Unix' way of supporting files with "holes",
309    so even if <tt>ls -l overlay.img</tt> says that the overlay is several
310    gigabytes large, <tt>du overlay.img</tt> should reveal that only the
311    blocks that have actually been written to have been stored in the
312    overlay, e.g.:<pre>
313            <b>$ ls -l
314            ..
315            -rw-r--r--  1 debug  wheel  3072319488 Mar 24 11:59 nbsd_cats.img
316            -rw-r--r--  1 debug  wheel     2465354 Mar 24 11:44 netbsd.aout-GENERIC.gz
317            -rw-r--r--  1 debug  wheel  2930841600 Mar 24 14:02 overlay.img
318            -rw-r--r--  1 debug  wheel      715538 Mar 24 14:02 overlay.img.map
319            $ du overlay.img
320            864     overlay.img
321    </b>
322    </pre>
323    
324    <p>The .map file is simply a raw bitmap telling which blocks of the
325    overlay file that are in use.
326    
327    
328    

Legend:
Removed from v.37  
changed lines
  Added in v.38

  ViewVC Help
Powered by ViewVC 1.1.26