Manpage logo

rdsquashfs - tool to examine or uncompress SquashFS filesystems

NAME  SYNOPSIS  DESCRIPTION  SEE ALSO  AUTHOR  COPYRIGHT 

NAME

rdsquashfs − tool to examine or uncompress SquashFS filesystems

SYNOPSIS

rdsquashfs [OPTIONS] <squashfs-file>

DESCRIPTION

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:
−−list
, −l <path>

Produce a directory listing similar to ls −l for a given path in the SquashFS image.

−−cat, −c <path>

If the specified path is a regular file in the image, extract it and dump its contents to stdout.

−−xattr, −x <path>

If the inode that the specified path resolves to has extended attributes, dump them as key value pairs to stdout.

−−unpack−path, −u <path>

Unpack the specified sub directory from the image. To unpack everything, simply specify /.

−−describe, −d

Produce a file listing from the image compatible with the format consumed by gensquashfs.

−−stat, −s <path>

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:
−−unpack−root
, −p <path>

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.

−−no−dev, −D

Skip device special files when parsing the filesystem tree.

−−no−sock, −S

Skip socket files when parsing the filesystem tree.

−−no−fifo, −F

Skip named pipes when parsing the filesystem tree.

−−no−slink, −L

Skip symbolic links when parsing the filesystem tree.

−−no−empty−dir, −E

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:
−−no−sparse
, −Z

Do not create sparse files. Always unpack sparse files by writing blocks of zeros to disk.

−−set−xattr, −X

Set the extended attributes from the SquashFS image.

−−set−times, −T

Set the create and modify timestamps of the file to the mtime from the SquashFS image.

−−chmod, −C

Change permission flags of unpacked files to those stored in the SquashFS image.

−−chown, −O

Change ownership of unpacked files to the UID/GID set in the SquashFS image.

−−quiet, −q

Do not print out progress while unpacking.

Other options:
−−help
, −h

Print help text and exit.

−−version, −V

Print version information and exit.

SEE ALSO

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

AUTHOR

Written by David Oberhollenzer.

COPYRIGHT

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


Updated 2026-06-01 - jenkler.se | uex.se