dumpifs

Runs on:

QNX OS, Linux, Microsoft Windows

Options:

-?

Print a usage message. Note that if you intend to run Windows executable files, you can't use the use utility to print the usage message.

-b

When using the -f or -x option, extract to the basenames of the files.

-d dir

The directory to which to extract files. The default is the current working directory.

-f file

Extract the named file. You can use the -f option more than once. If you use this option with the -b option, the argument of the -f is treated as a basename, and the dumpifs will extract all files with that basename. If you use this option without the -b option, you need to specify the full path of the file.

-m

Display the MD5 checksum of each file in the image filesystem.

-u file

If the image is compressed, put an uncompressed copy in file.

-V file

Output a comma-separated listing of the IFS content to file. Specify a dash (-) to send the information to standard output.

-v

Verbose operation. Specify more than one v to display more information.

-x

Extract the files specified after the image. If you don't specify the -x, dumpifs displays information on individual files instead of unpacking them. If you don't specify the file name, all files will be extracted.

-z

Disable the imagefs header sanity check while searching for the startup header. The dumpifs utility checks that certain fields in the header are valid, in order to be sure that it's found the header. If you set these fields to some other value, you'll need to specify this option.

file

The basename of a file, directory, device, or link to display or extract. If there are several files, use spaces to separate them.

Description:

The dumpifs utility dumps the contents of an image filesystem.

You can also use dumpifs with the -f or -x option to extract files from the image filesystem. The files are extracted into the current working directory, or into the directory you specify with the -d option. If you specify -b, the files are put directly into the directory; if you don't specify -b, the files are extracted to the pathname specified in the image.

This program uses the OpenSSL library for cryptography services.

License checking

The dumpifs utility checks for a valid QNX license key before performing any operation. If the license check fails, the utility stops running and displays a diagnostic message. A license check may fail if the license key is expired, missing, or not currently activated, or if the key doesn’t contain the permissions needed to run the utility.

Examples:

$ dumpifs shell.ifs
   Offset     Size  Name
        0      288  *.boot
      288      100  Startup-header flags1=0x1 paddr_bias=0
      388     6008  startup.*
     6390       59  Image-header mountpoint=/
     63ec      1ac  Image-directory
     ----     ----  Root-dirent
     6598       8c  proc/boot/data1
     6624       5c  proc/boot/.script
     6680       14  proc/boot/data2
     7000    2c02c  proc/boot/procnto
    34000    12ad0  proc/boot/devc-con
    47000     b66c  proc/boot/esh
    53000     d7fc  proc/boot/ls
    61000     7394  proc/boot/cat
Checksums: image=0x6d5fb484 startup=0x274d7c89

Caveats:

This utility will not work on an image that has been built using a filter such as srec (for more information on image filters, see mkifs). If you wanted to run dumpifs on such an image, you would build the image omitting the filter stage in your mkifs buildfile (you would then need to run the filter by hand later in order to make a viable image for your target).