/usr/bin/unsquashfs --help — Chainguard OS Manuals

From squashfs-tools 4.7.5-r3 (enterprise-packages), captured 2026-11-08 by running unsquashfs -help (exit 0) · terse output. permalink

SYNTAX: unsquashfs [OPTIONS] FILESYSTEM [files to extract or exclude (with
-excludes) or cat (with -cat )]

Run
  "unsquashfs -help-option <regex>" to get help on all options matching <regex>

Or run
  "unsquashfs -help-section <section-name>" to get help on these sections
	SECTION NAME		SECTION
	extraction		Filesystem extraction (filtering) options:
	information		Filesystem information and listing options:
	xattrs			Filesystem extended attribute (xattrs) options:
	runtime			Unsquashfs runtime options:
	help			Help options:
	misc			Miscellaneous options:
	environment		Environment:
	exit			Exit status:
	extra			See also (extra information elsewhere):
	decompressors		Decompressors available:

Or run
  "unsquashfs -help-all" to get help on all the sections

Options (55)

Option	Description	Source
`-d, -dest` PATHNAME	extract to PATHNAME, default "squashfs-root".	man
`-max, -max-depth` LEVELS	descend at most LEVELS of directories when extracting.	man
`-excludes`	treat files on command line as exclude files.	man
`-ex, -exclude-list`	list of files to be excluded, terminated with ;	man
`-extract-file` FILE	list of directories or files to extract.	man
`-exclude-file` FILE	list of directories or files to exclude.	man
`-match`	abort if any extract file does not match on anything, and can not be resolved.	man
`-follow, -follow-symlinks`	follow symlinks in extract files, and add all files/symlinks needed to resolve extract file.	man
`-missing, -missing-symlinks`	Unsquashfs will abort if any symlink can't be resolved in -follow-symlinks.	man
`-no-wild, -no-wildcards`	do not use wildcard matching in extract and exclude names.	man
`-r, -regex`	treat extract names as POSIX regular expressions rather than use the default shell wildcard expansion (globbing).	man
`-all, -all-time` TIME	set all file timestamps to TIME, rather than the time stored in the filesystem inode.	man
`-cat`	cat the files on the command line to stdout.	man
`-f, -force`	if destination directory already exists, descend into it and any sub-directories, and unlink (delete) files if they already exist before extracting to them.	man
`-pf` FILE	output a pseudo file equivalent of the input Squashfs filesystem, use - for stdout.	man
`-s, -stat`	display filesystem superblock information.	man
`-i, -info`	print files as they are extracted.	man
`-li, -linfo`	print files as they are extracted with file attributes (like ls -l output).	man
`-l, -ls`	list filesystem, but do not extract files.	man
`-ll, -lls`	list filesystem with file attributes (like ls -l output), but do not extract files.	man
`-lln, -llnumeric`	same as -lls but with numeric uids and gids.	man
`-lc`	list filesystem concisely, displaying only files and empty directories.	man
`-llc`	list filesystem concisely with file attributes, displaying only files and empty directories.	man
`-full, -full-precision`	use full precision when displaying times including seconds.	man
`-UTC`	use UTC rather than local time zone when displaying time.	man
`-mkfs-time`	display filesystem superblock time, which is an unsigned 32-bit int representing the time in seconds since the epoch (1970-01-01).	man
`-no, -no-xattrs`	do not extract xattrs in file system.	man
`-x, -xattrs`	extract xattrs in file system (default).	man
`-xattrs-exclude` REGEX	exclude any xattr names matching REGEX.	man
`-xattrs-include` REGEX	include any xattr names matching REGEX.	man
`-v, -version`	print version, licence and copyright information.	man
`-p, -processors` NUMBER	use NUMBER processors.	man
`-mem` SIZE	use SIZE physical memory for caches.	man
`-mem-percent` PERCENT	use PERCENT physical memory for caches.	man
`-q, -quiet`	no verbose output.	man
`-n, -no-progress`	do not display the progress bar.	man
`-percentage`	display a percentage rather than the full progress bar.	man
`-ig, -ignore-errors`	treat errors writing files to output as non-fatal.	man
`-st, -strict-errors`	treat all errors as fatal.	man
`-no-exit, -no-exit-code`	do not set exit code (to nonzero) on non-fatal errors.	man
`-h, -help`	print help summary information to pager (or stdout if not a terminal).	man
`-help-option` REGEX	print the help information for options matching REGEX to pager (or stdout if not a terminal).	man
`-help-section` SECTION	print the help information for section SECTION to pager (or stdout if not a terminal).	man
`-help-all`	print help information for all Unsquashfs options and sections to pager (or stdout if not a terminal).	man
`-ho` REGEX	shorthand alternative to -help-option.	man
`-hs` SECTION	shorthand alternative to -help-section.	man
`-ha`	shorthand alternative to -help-all.	man
`-no-pager`	do not use a pager to output help information.	man
`-cols` WIDTH	use WIDTH columns to output help information.	man
`-o, -offset` BYTES	skip BYTES at start of FILESYSTEM.	man
`-fstime`	synonym for -mkfs-time.	man
`-e, -ef` EXTRACT	synonym for -extract-file.	man
`-exc, -excf` EXCLUDE	synonym for -exclude-file.	man
`-L`	synonym for -follow-symlinks.	man
`-pseudo-file` FILE	alternative name for -pf.	man

Exit status (3) from the manual page

`0`	The filesystem listed or extracted OK.
`1`	FATAL errors occurred, e.g. filesystem corruption, I/O errors.
`2`	Non-fatal errors occurred, e.g. no support for XATTRs, Symbolic links in output filesystem or couldn't write permissions to output filesystem.

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.