Scroll to navigation



rdsquashfs - tool to examine or uncompress SquashFS filesystems


rdsquashfs [OPTIONS] <squashfs-file>


View or extract the contents of a squashfs image.

The following options can be used to specify what operation to perform. One of those has to be present:

Produce a directory listing similar to ls -l for a given path in the SquashFS image.
If the specified path is a regular file in the image, extract it and dump its contents to stdout.
If the inode that the specified path resolves to has extended attributes, dump them as key value pairs to stdout.
Unpack the specified sub directory from the image. To unpack everything, simply specify /.
Produce a file listing from the image compatible with the format consumed by gensquashfs.
Dump all available information about the inode that the path refers to, including SquashFS specific internals such as the on-disk layout of a file or the fast lookup index stored in an extended directory inode.

The following options can be used to control the behaviour of the specified operation:

If used with --unpack-path, this is where the data is unpacked to. If used with --describe, this is used as a prefix for the input path of regular files.
Skip device special files when parsing the filesystem tree.
Skip socket files when parsing the filesystem tree.
Skip named pipes when parsing the filesystem tree.
Skip symbolic links when parsing the filesystem tree.
Skip empty directories, including ones that are empty after applying the above rules.

The following options are specific to unpacking files from a SquashFS image to disk:

Do not create sparse files. Always unpack sparse files by writing blocks of zeros to disk.
Set the extended attributes from the SquashFS image.
Set the create and modify timestamps of the file to the mtime from the SquashFS image.
Change permission flags of unpacked files to those stored in the SquashFS image.
Change ownership of unpacked files to the UID/GID set in the SquashFS image.
Do not print out progress while unpacking.

Other options:

Print help text and exit.
Print version information and exit.


gensquashfs(1), sqfs2tar(1), sqfsdiff(1)


Written by David Oberhollenzer.


Copyright © 2019 David Oberhollenzer License GPLv3+: GNU GPL version 3 or later <>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

May 2019 inspect SquashFS filesystems