» WIT: Wiimms ISO Tools » wdf: Wiimms WDF Tool » wdf dump

# wdf dump

Dump the data structure of WDF, WIA, CISO and GCZ images and ignore other files. This is the default command, when the program contains the sub string 'dump' in any case. »wdf +DUMP« replaces the old tool wdf-dump.

## 1. Syntax

    wdf +DUMP [option]... files...

## 2. Options

Options
Option | Param | Description
--- | --- | ---
`-d` | `--dest` | path | Define a destination path (directory/file).
`-D` | `--DEST` | path | Like --dest, but create the directory path automatically.
`-o` | `--overwrite` |  | Overwrite already existing files without warning.
| `--chunk` |  | Print table with chunk header too.
`-l` | `--long` |  | Same as --chunk
`-1` | `--minus-1` |  | If set the end address is the last address of a range. The standard is to print the first address that is not part of the address of a range.

## 3. Description

This command dumps the data structure of WDF, WIA and CISO files for analysis. A usual dump looks like this:

    WDF dump of file wch.wdf

      Header:

        Magic             : "WII.DISC"  57 49 49 01  44 49 53 43
        wdf_version       :          1/hex =          1
         - header size    :         38/hex =         56
        split_file_id     :   11200185/hex =  287310213
        split_file_index  :          0/hex =          0
        split_file_num_of :          1/hex =          1
        file_size         :  118240000/hex = 4699979776
         - WDF file size  :    180333c/hex =   25178940  0.54%
        data_size         :    1803008/hex =   25178120
        chunk_split_file  :          0/hex =          0
        chunk_n           :         1b/hex =         27
        chunk_off         :    1803040/hex =   25178176

      File Parts:

        Header            :          0 ..         38 [        38]
        Data              :         38 ..    1803040 [   1803008]
        Chunk-Magic       :    1803040 ..    1803048 [         8]
        Chunk-Table       :    1803048 ..    180333c [       2f4]

If adding the option --long and chunk table is printed too:

      Chunk Table:

        idx        WDF file offset  data len     virtual ISO offset  hole size
       ------------------------------------------------------------------------
         0.         38..        98        60          0..        60      3ffa0
         1.         98..        c4        2c      40000..     4002c       dfd4
         2.         c4..        e4        20      4e000..     4e020       1fdc
         3.         e4..        e8         4      4fffc..     50000    f7b0000
         4.         e8..       1ec       104    f800000..   f800104         3c
         5.        1ec..       208        1c    f800140..   f80015c         60
         6.        208..       234        2c    f8001bc..   f8001e8         38
         7.        234..       258        24    f800220..   f800244         60
         8.        258..       378       120    f8002a4..   f8003c4         3c
         9.        378..       394        1c    f800400..   f80041c         28
        10.        394..       3ac        18    f800444..   f80045c         40
        11.        3ac..       5f4       248    f80049c..   f8006e4         3c
        12.        5f4..       5f8         4    f800720..   f800724         3c
        13.        5f8..       608        10    f800760..   f800770         34
        14.        608..       710       108    f8007a4..   f8008ac         34
        15.        710..       814       104    f8008e0..   f8009e4         3c
        16.        814..       824        10    f800a20..   f800a30         30
        17.        824..       834        10    f800a60..   f800a70         34
        18.        834..       93c       108    f800aa4..   f800bac         34
        19.        93c..       a40       104    f800be0..   f800ce4         3c
        20.        a40..       a50        10    f800d20..   f800d30         30
        21.        a50..       a60        10    f800d60..   f800d70         34
        22.        a60..       b68       108    f800da4..   f800eac       7154
        23.        b68..      b040      a4d8    f808000..   f8124d8       db28
        24.       b040..    2fb040    2f0000    f820000..   fb10000  1063a8000
        25.     2fb040..   1803040   1508000  115eb8000.. 1173c0000     e80000
        26.    1803040..   1803040         0  118240000.. 118240000          0

### 3.1 Set command +DUMP as default

If the tool wdf is called with an program name that contains the string dump (like in wdf-dump or wdfdump) then the +DUMP command is the default. The best way is to link (soft or hard) it to the new name. Expamples

    ln wdf wdf-dump
    ln -s wdf wdf-dump
    cp -l wdf wdf-dump

The unix installation script does it for you.

## 4. Usual error/exit codes:

    OK
    NO_WDF
    WDF_VERSION
    WDF_SPLIT
    WDF_INVALID
    CANT_OPEN
    READ_FAILED
    WRITE_FAILED
    INTERNAL