RDSQUASHFS
Section: User Commands (1)
Updated: May 2019
Page Index
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.