Tools for Bochs and Win32 and/or DOS: Win_Dump

Win_Dump, further known as DUMP, found above, is used to view a file's contents in many formats.

For example, if you are working on your FAT32 code, using an emulator, you will have a FAT disk image. Rather than viewing the image as bytes such as:

  00007E00  EB 5A 90 4D 53 57 49 4E-34 2E 31 00 02 08 20 00     .Z.MSWIN4.1.....
  00007E10  02 00 00 00 00 F8 00 00-3F 00 10 00 3F 00 00 00     ........?...?...
  00007E20  C1 7C 10 00 1F 04 00 00-00 00 00 00 02 00 00 00     .|..............
  00007E30  01 00 06 00 00 00 00 00-00 00 00 00 00 00 00 00     ................
  00007E40  80 00 29 6B 2E EA 1D 4E-4F 20 4E 41 4D 45 20 20     ..)k...NO.NAME..
  00007E50  20 20 46 41 54 33 32 20-20 20 F1 7D FA 33 C9 8E     ..FAT32....}.3..
  00007E60  D1 BC F8 7B 8E C1 BD 78-00 C5 76 00 1E 56 16 55     ...{...x..v..V.U
  00007E70  BF 22 05 89 7E 00 89 4E-02 B1 0B FC F3 A4 8E D9     ."..~..N........

It is much easier to view it as:

FAT32 BIOS Parameter Block (0x00007E00)
                  Jump: EB 5A 90
              OEM Name: MSWIN4.1
      Bytes per Sector: 512
   Sectors per Cluster: 8
      Sectors reserved: 32
                  Fats: 2
          Root Entries: 0
               Sectors: 0
            Descriptor: 0xF8
       Sectors per FAT: 0
     Sectors per Track: 63
                 Heads: 16
        Hidden Sectors: 63
      Sectors Extended: 1080513
    Sectors per FAT 32: 1055
        Extended Flags: 0x0000
            FS Version: 0x0000
   Root Cluster Number: 0x00000002
    Info Sector Number: 1
    Backup boot Sector: 6
                  resv: 00 00 00 00 00 00 00 00 00 00 00 00
             Drive Num: 128
              reserved: 00
                   Sig: 29
                Serial: 1DEA2E6B
                 Label: NO NAME   
              sys type: FAT32   

This makes it a lot easier to find errors in your image.  All you do is supply the
starting offset and choose the BIOS Parameter Block (32) radio item.

See the following image:

As they say on TV, "Wait, that isn't all, there's more." (sorry, couldn't help it), dump will show you where the error is.

FAT32 BIOS Parameter Block (0x00007E00)
                  Jump: EB 5A 90
              OEM Name: MSWIN4.1
      Bytes per Sector: 513    <-- should be a multiple of 2
   Sectors per Cluster: 8
      Sectors reserved: 32
                  Fats: 2
          Root Entries: 0
               Sectors: 0
            Descriptor: 0xF8
       Sectors per FAT: 0
     Sectors per Track: 63
                 Heads: 16
        Hidden Sectors: 63
      Sectors Extended: 1080513
    Sectors per FAT 32: 1055
        Extended Flags: 0x0000
            FS Version: 0x0000
   Root Cluster Number: 0x00000002
    Info Sector Number: 1
    Backup boot Sector: 6
                  resv: 00 00 00 00 00 00 00 00 00 00 00 00
             Drive Num: 128
              reserved: 00
                   Sig: 29
                Serial: 1DEA2E6B
                 Label: NO NAME   
              sys type: FAT32   

Many formats are included:  FAT12/16/32, etc., well you can see which ones are supported by the image above.

As you can see, I have left room for other formats.  If you have a request, and an image file of that format, please let me know.

I also use this utility for other formats other than File Systems.  You can see that I have OHCI as a format.  In my work, I dump the OHCI's registers to a file, then view them with this utility.

The dump results is simply text that can be modified and printed just like a text editor.

I haven't written dump to be fast or a do all utility.  I have just added the function as I needed it.  I am releasing it for others to use if they so desire.

If you have any comments or find any errors, you can contact me here.