.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH UNSQUASHFS "1" "March 2026" "unsquashfs version 4.7.5" "دستورهای کاربری"
.SH "نام (NAME)"
unsquashfs \- ابزاری برای از حالت فشرده خارج کردن، استخراج و فهرست کردن سیستم‌فایل‌های squashfs
.SH "خلاصه دستور (SYNOPSIS)"
.B unsquashfs
[\fI\,OPTIONS\/\fR] \fI\,FILESYSTEM \/\fR[\fI\,files to extract or exclude (with -excludes) or cat (with -cat )\/\fR]
.SH "توضیحات (DESCRIPTION)"
سیستم‌فایل Squashfs یک سیستم‌فایل فقط‌خواندنی به‌شدت فشرده برای لینوکس است.
این سیستم‌فایل از فشرده‌سازی gzip/xz/lzo/lz4/zstd برای فشرده‌سازی فایل‌ها، inodeها
و دایرکتوری‌ها استفاده می‌کند. Inodeها در این سیستم بسیار کوچک هستند و تمامی بلوک‌ها
برای به حداقل رساندن بار اضافی داده‌ها فشرده و بسته‌بندی می‌شوند. اندازه‌های بلوک بزرگ‌تر از 4K
تا حداکثر 1Mbytes پشتیبانی می‌شوند (اندازه بلوک پیش‌فرض 128K است).
.PP
سیستم‌فایل Squashfs برای استفاده عمومی به عنوان سیستم‌فایل فقط‌خواندنی، مصارف آرشیوی
(مانند مواردی که ممکن است از یک فایل .tar.gz استفاده شود)، و در سیستم‌های دارای محدودیت
حافظه/دستگاه بلوکی (مانند سیستم‌های جاسازی‌شده) که نیاز به بار سربار کم دارند، در نظر گرفته شده است.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های استخراج (فیلتر کردن) سیستم‌فایل:"
.TP
\fB\-d\fR PATHNAME, \fB\-dest\fR PATHNAME
استخراج در PATHNAME، پیش‌فرض "squashfs\-root". این گزینه همچنین پیشوند مورد استفاده هنگام فهرست کردن سیستم‌فایل را تنظیم می‌کند.
.TP
\fB\-max\fR LEVELS, \fB\-max\-depth\fR LEVELS
پیمایش به عمق حداکثر LEVELS دایرکتوری هنگام استخراج.
.TP
\fB\-excludes\fR
فایل‌های مشخص‌شده در خط فرمان را به عنوان فایل‌های مستثنی‌شده (exclude) در نظر بگیرد.
.TP
\fB\-ex\fR, \fB\-exclude\-list\fR
فهرستی از فایل‌ها برای مستثنی شدن، خاتمه‌یافته با ; مانند file1 file2 ;.
.TP
\fB\-extract\-file\fR FILE
فهرستی از دایرکتوری‌ها یا فایل‌ها برای استخراج. یک مورد در هر سطر.
.TP
\fB\-exclude\-file\fR FILE
فهرستی از دایرکتوری‌ها یا فایل‌ها برای مستثنی شدن. یک مورد در هر سطر.
.TP
\fB\-match\fR
در صورتی که هر فایل استخراج با هیچ موردی تطابق نداشته باشد و قابل حل نباشد، عملیات لغو شود. به صورت ضمنی گزینه‌های \fB\-missing\-symlinks\fR و \fB\-no\-wildcards\fR را فعال می‌کند.
.TP
\fB\-follow\fR, \fB\-follow\-symlinks\fR
دنبال کردن پیوندهای نمادین در فایل‌های استخراج، و افزودن تمامی فایل‌ها/پیوندهای نمادین مورد نیاز برای حل فایل استخراج. به صورت ضمنی گزینه \fB\-no\-wildcards\fR را فعال می‌کند.
.TP
\fB\-missing\fR, \fB\-missing\-symlinks\fR
در صورت عدم امکان حل هرگونه پیوند نمادین در \fB\-follow\-symlinks\fR، ابزار Unsquashfs متوقف و لغو خواهد شد.
.TP
\fB\-no\-wild\fR, \fB\-no\-wildcards\fR
عدم استفاده از تطبیق با نویسه‌های عمومی (wildcard) در نام‌های استخراج و مستثنی‌سازی.
.TP
\fB\-r\fR, \fB\-regex\fR
در نظر گرفتن نام‌های استخراج به عنوان عبارات باقاعده POSIX به جای استفاده از بسط پیش‌فرض الگوهای عام پوسته (globbing).
.TP
\fB\-all\fR TIME, \fB\-all\-time\fR TIME
تنظیم برچسب زمانی تمام فایل‌ها روی TIME، به جای زمان ذخیره‌شده در inode سیستم‌فایل. مقدار TIME می‌تواند یک عدد صحیح ۳۲ بیتی بدون علامت بیانگر ثانیه‌های پس از مبدا یونیکس (1970\-01\-01) باشد، یا مقداری رشته‌ای که برای پردازش به دستور "date" ارسال می‌شود. هر مقدار رشته‌ای که دستور date تشخیص دهد قابل استفاده است، مانند "now"، "last week" یا "Wed Feb 15 21:02:39 GMT 2023".
.TP
\fB\-cat\fR
ارسال محتوای فایل‌های مشخص‌شده در خط فرمان به خروجی استاندارد (stdout).
.TP
\fB\-f\fR, \fB\-force\fR
در صورتی که دایرکتوری مقصد از قبل وجود داشته باشد، به درون آن و تمامی زیردایرکتوری‌های آن وارد شده و در صورت وجود فایل‌ها، پیش از استخراج روی آن‌ها، فایل‌های موجود حذف (unlink) شوند.
.TP
\fB\-pf\fR FILE
تولید معادل یک شبه‌فایل (pseudo file) از سیستم‌فایل ورودی Squashfs؛ از \- برای خروجی استاندارد (stdout) استفاده کنید.
.SS "گزینه‌های اطلاعات و فهرست کردن سیستم‌فایل:"
.TP
\fB\-s\fR, \fB\-stat\fR
نمایش اطلاعات ابربلوک (superblock) سیستم‌فایل.
.TP
\fB\-max\fR LEVELS, \fB\-max\-depth\fR LEVELS
پیمایش به عمق حداکثر LEVELS دایرکتوری هنگام فهرست کردن.
.TP
\fB\-i\fR, \fB\-info\fR
چاپ نام فایل‌ها هنگام استخراج شدن آن‌ها.
.TP
\fB\-li\fR, \fB\-linfo\fR
چاپ فایل‌ها هنگام استخراج همراه با ویژگی‌های فایل (مشابه خروجی ls \fB\-l\fR).
.TP
\fB\-l\fR, \fB\-ls\fR
فهرست کردن محتویات سیستم‌فایل بدون استخراج فایل‌ها.
.TP
\fB\-ll\fR, \fB\-lls\fR
فهرست کردن سیستم‌فایل همراه با ویژگی‌های فایل (مشابه خروجی ls \fB\-l\fR) بدون استخراج فایل‌ها.
.TP
\fB\-lln\fR, \fB\-llnumeric\fR
مشابه \fB\-lls\fR اما با شناسه‌های عددی uid و gid.
.TP
\fB\-lc\fR
فهرست کردن موجز سیستم‌فایل و نمایش فقط فایل‌ها و دایرکتوری‌های خالی، بدون استخراج فایل‌ها.
.TP
\fB\-llc\fR
فهرست کردن موجز سیستم‌فایل همراه با ویژگی‌های فایل، نمایش فقط فایل‌ها و دایرکتوری‌های خالی، بدون استخراج فایل‌ها.
.TP
\fB\-full\fR, \fB\-full\-precision\fR
استفاده از دقت کامل شامل ثانیه‌ها هنگام نمایش زمان‌ها. قابل استفاده با \fB\-linfo\fR، \fB\-lls\fR، \fB\-lln\fR و \fB\-llc\fR.
.TP
\fB\-UTC\fR
استفاده از ساعت هماهنگ جهانی (UTC) به جای منطقه زمانی محلی هنگام نمایش زمان.
.TP
\fB\-mkfs\-time\fR
نمایش زمان ساخت ابربلوک سیستم‌فایل که یک عدد صحیح ۳۲ بیتی بدون علامت بیانگر زمان بر حسب ثانیه‌های سپری‌شده از مبدا (1970\-01\-01) است.
.SS "گزینه‌های ویژگی‌های گسترده سیستم‌فایل (xattrs):"
.TP
\fB\-no\fR, \fB\-no\-xattrs\fR
عدم استخراج xattrها در سیستم‌فایل.
.TP
\fB\-x\fR, \fB\-xattrs\fR
استخراج xattrها در سیستم‌فایل (پیش‌فرض).
.TP
\fB\-xattrs\-exclude\fR REGEX
مستثنی کردن تمام نام‌های xattr منطبق با REGEX. مقدار REGEX یک عبارت باقاعده POSIX است؛ برای مثال \fB\-xattrs\-exclude\fR '^user.' ویژگی‌های گسترده فضای نام کاربر را مستثنی می‌کند.
.TP
\fB\-xattrs\-include\fR REGEX
شامل کردن تمام نام‌های xattr منطبق با REGEX. مقدار REGEX یک عبارت باقاعده POSIX است؛ برای مثال \fB\-xattrs\-include\fR '^user.' ویژگی‌های گسترده فضای نام کاربر را شامل می‌شود.
.SS "گزینه‌های زمان اجرای Unsquashfs:"
.TP
\fB\-v\fR, \fB\-version\fR
چاپ اطلاعات نسخه، مجوز و حق نشر.
.TP
\fB\-p\fR NUMBER, \fB\-processors\fR NUMBER
استفاده از NUMBER پردازنده. به طور پیش‌فرض از تمام پردازنده‌های موجود استفاده خواهد شد.
.TP
\fB\-mem\fR SIZE
استفاده از SIZE حافظه فیزیکی برای حافظه‌های موقت (کش). از K، M یا G به ترتیب برای تعیین کیلوبایت، مگابایت یا گیگابایت استفاده کنید. پیش‌فرض 512 Mbytes است.
.TP
\fB\-mem\-percent\fR PERCENT
استفاده از PERCENT درصد از حافظه فیزیکی برای حافظه‌های موقت (کش).
.TP
\fB\-q\fR, \fB\-quiet\fR
بدون خروجی پرحجم (verbose).
.TP
\fB\-n\fR, \fB\-no\-progress\fR
عدم نمایش نوار پیشرفت.
.TP
\fB\-percentage\fR
نمایش درصد پیشرفت به جای نوار پیشرفت کامل. قابل استفاده با dialog \fB\-\-gauge\fR و غیره.
.TP
\fB\-ig\fR, \fB\-ignore\-errors\fR
غیرمرگبار تلقی کردن خطاهای مربوط به نوشتن فایل‌ها در خروجی.
.TP
\fB\-st\fR, \fB\-strict\-errors\fR
مرگبار تلقی کردن تمامی خطاها.
.TP
\fB\-no\-exit\fR, \fB\-no\-exit\-code\fR
عدم تنظیم کد خروج (به مقدار غیرصفر) در صورت بروز خطاهای غیرمرگبار.
.SS "گزینه‌های راهنما:"
.TP
\fB\-h\fR, \fB\-help\fR
چاپ خلاصه اطلاعات راهنما در صفحه‌بندی‌کننده (یا stdout در صورت عدم اتصال به ترمینال).
.TP
\fB\-help\-option\fR REGEX
چاپ اطلاعات راهنما برای گزینه‌های منطبق با REGEX در صفحه‌بندی‌کننده (یا stdout در صورت عدم اتصال به ترمینال).
.TP
\fB\-help\-section\fR SECTION
چاپ اطلاعات راهنما برای بخش SECTION در صفحه‌بندی‌کننده (یا stdout در صورت عدم اتصال به ترمینال). اگر SECTION دقیقاً با نام یک بخش مطابقت نداشته باشد، به عنوان یک عبارت باقاعده در نظر گرفته شده و تمام بخش‌های منطبق نمایش داده می‌شوند. از "list" به عنوان نام بخش برای دریافت فهرست بخش‌ها و نام‌های آن‌ها استفاده کنید.
.TP
\fB\-help\-all\fR
چاپ اطلاعات راهنما برای تمامی گزینه‌ها و بخش‌های Unsquashfs در صفحه‌بندی‌کننده (یا stdout در صورت عدم اتصال به ترمینال).
.TP
\fB\-ho\fR REGEX
نام کوتاه جایگزین برای \fB\-help\-option\fR.
.TP
\fB\-hs\fR SECTION
نام کوتاه جایگزین برای \fB\-help\-section\fR.
.TP
\fB\-ha\fR
نام کوتاه جایگزین برای \fB\-help\-all\fR.
.TP
\fB\-no\-pager\fR
عدم استفاده از صفحه‌بندی‌کننده برای نمایش اطلاعات راهنما.
.TP
\fB\-cols\fR WIDTH
استفاده از WIDTH ستون برای نمایش اطلاعات راهنما. زمانی که خروجی به ترمینال ارسال نمی‌شود مفید است.
.SS "گزینه‌های متفرقه:"
.TP
\fB\-o\fR BYTES, \fB\-offset\fR BYTES
صرف‌نظر کردن از BYTES بایت در ابتدای FILESYSTEM. به صورت اختیاری می‌توان پسوند K، M یا G را به ترتیب برای تعیین کیلوبایت، مگابایت یا گیگابایت اضافه کرد (پیش‌فرض 0 بایت).
.TP
\fB\-fstime\fR
مترادف \fB\-mkfs\-time\fR.
.TP
\fB\-e\fR, \fB\-ef\fR EXTRACT FILE
مترادف \fB\-extract\-file\fR.
.TP
\fB\-exc\fR, \fB\-excf\fR EXCLUDE FILE
مترادف \fB\-exclude\-file\fR.
.TP
\fB\-L\fR
مترادف \fB\-follow\-symlinks\fR.
.TP
\fB\-pseudo\-file\fR FILE
نام جایگزین برای \fB\-pf\fR.
.SH "وضعیت خروج (EXIT STATUS)"
.TP
0
سیستم‌فایل با موفقیت فهرست یا استخراج شد.
.TP
1
خطاهای مرگبار رخ داد، مانند خرابی سیستم‌فایل یا خطاهای ورودی/خروجی (I/O). ابزار Unsquashfs ادامه نداد و متوقف شد.
.TP
2
خطاهای غیرمرگبار رخ داد، مانند عدم پشتیبانی از XATTRها، پیوندهای نمادین در سیستم‌فایل خروجی یا عدم امکان نوشتن مجوزها در سیستم‌فایل خروجی. ابزار Unsquashfs ادامه داد و متوقف نشد.
.PP
برای نحوه تأثیرگذاری گزینه‌های \fB\-ignore\-errors\fR، \fB\-strict\-errors\fR و \fB\-no\-exit\-code\fR بر وضعیت خروج، به توضیحات آن‌ها مراجعه کنید.
.SH "فشرده‌سازهای موجود (DECOMPRESSORS AVAILABLE)"
gzip, lzo, lz4, xz, zstd, lzma
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
SQFS_CMDLINE
در صورت مقداردهی، به عنوان دایرکتوری برای نوشتن فایل sqfs_cmdline استفاده می‌شود که حاوی آرگومان‌های خط فرمان ارائه‌شده به Unsquashfs است. هر آرگومان خط فرمان درون نقل‌قول قرار می‌گیرد تا در صورت وجود فاصله در آرگومان‌ها، هیچ ابهامی وجود نداشته باشد. اگر فایل از قبل موجود باشد، خط فرمان به انتهای فایل اضافه می‌شود.
.TP
PAGER
در صورت مقداردهی، به عنوان نام برنامه‌ای که برای نمایش متن راهنما استفاده می‌شود به کار می‌رود. این مقدار می‌تواند یک دستور ساده یا یک مسیر کامل باشد. پیش‌فرض \fI\,/usr/bin/pager\/\fP است.
.SH "مثال‌ها (EXAMPLES)"
.TP
unsquashfs IMAGE.SQFS
استخراج IMAGE.SQFS در "squashfs\-root" درون دایرکتوری کاری فعلی.
.TP
unsquashfs -d output IMAGE.SQFS
استخراج IMAGE.SQFS در پوشه "output" درون دایرکتوری کاری فعلی.
.TP
unsquashfs -d . IMAGE.SQFS
استخراج IMAGE.SQFS در دایرکتوری کاری فعلی.
.TP
unsquashfs -linfo IMAGE.SQFS
نمایش فهرستی از IMAGE.SQFS همراه با ویژگی‌های فایل در خروجی استاندارد (stdout)، همزمان با استخراج سیستم‌فایل در "squashfs\-root".
.TP
unsquashfs -lls IMAGE.SQFS
نمایش فهرستی از IMAGE.SQFS همراه با ویژگی‌های فایل در خروجی استاندارد (stdout)، اما بدون استخراج سیستم‌فایل. در ابتدای نام موارد فهرست، پیشوند "squashfs\-root" قرار می‌گیرد.
.TP
unsquashfs -d "" -lls IMAGE.SQFS
نمایش فهرستی از IMAGE.SQFS همراه با ویژگی‌های فایل در خروجی استاندارد (stdout)، اما بدون استخراج سیستم‌فایل. در ابتدای نام موارد فهرست، پیشوند "squashfs\-root" قرار نمی‌گیرد.
.TP
unsquashfs IMAGE.SQFS fs/squashfs
استخراج منحصراً دایرکتوری "fs/squashfs".
.TP
unsquashfs IMAGE.SQFS "[Tt]est/example*"
استخراج تمام فایل‌هایی که با "example" شروع می‌شوند در دایرکتوری‌های سطح بالا به نام "Test" یا "test".
.TP
unsquashfs -excludes IMAGE.SQFS "test/*data*.gz"
این دستور تمام موارد را به جز فایل‌های منطبق با *data*.gz در دایرکتوری test استخراج می‌کند. گزینه \-excludes به Unsquashfs می‌گوید فایل‌های مشخص‌شده در خط فرمان را به جای استخراج، مستثنی کند.
.TP
unsquashfs -excludes IMAGE.SQFS "... *.gz"
این دستور تمام موارد را به جز فایل‌های منطبق با *.gz در هر کجای تصویر استخراج می‌کند. علامت "..." نشان می‌دهد که این یک الگوی مستثنی‌سازی بدون لنگر (غیر مقید به مسیر خاص) است که در هر نقطه‌ای تطابق داده می‌شود.
.TP
unsquashfs -ex "test/*data*.gz" \; IMAGE.SQFS test
این دستور از هر دو گزینه استخراج و مستثنی‌سازی استفاده می‌کند تا به Unsquashfs بگوید فقط دایرکتوری "test" را استخراج کرده و هر فایلی درون آن را که با *data*.gz مطابقت دارد مستثنی نماید.
.TP
unsquashfs -ex "... *.gz" IMAGE.SQFS test
این دستور از هر دو گزینه استخراج و مستثنی‌سازی استفاده می‌کند تا به Unsquashfs بگوید فقط دایرکتوری "test" را استخراج کرده و فایل‌های منطبق با "*.gz" در هر نقطه‌ای از دایرکتوری "test" یا زیردایرکتوری‌های آن را مستثنی سازد.
.TP
unsquashfs -dest output -max-depth 2 IMAGE.SQFS
استخراج فقط دو سطح نخست از IMAGE.SQFS در دایرکتوری "output".
.TP
unsquashfs -max-depth 2 IMAGE.SQFS "test/*.gz"
استخراج تنها فایل‌های gzipped درون دایرکتوری test.
.TP
unsquashfs -llc -max-depth 2 IMAGE.SQFS "test/*.gz"
نمایش فهرستی از فایل‌های gzipped درون دایرکتوری test در خروجی استاندارد (stdout)، اما بدون استخراج آن‌ها.
.TP
unsquashfs -no-xattrs IMAGE.SQFS
عدم استخراج هرگونه ویژگی گسترده. هر ویژگی گسترده در سیستم‌فایل نادیده گرفته خواهد شد.
.TP
unsquashfs -xattrs-include "^user." IMAGE.SQFS
فیلتر کردن ویژگی‌های گسترده و فقط استخراج ویژگی‌های گسترده در فضای نام کاربر از سیستم‌فایل Squashfs.
.TP
unsquashfs -xattrs-exclude "^user." IMAGE.SQFS
فیلتر کردن ویژگی‌های گسترده و عدم استخراج هرگونه ویژگی گسترده در فضای نام کاربر از سیستم‌فایل Squashfs.
.PP
توجه: هنگام ارسال نام‌های دارای نویسه عمومی (wildcard) به Unsquashfs، آن‌ها باید درون علامت نقل‌قول قرار گیرند (مانند مثال‌های فوق) تا اطمینان حاصل شود که توسط پوسته پردازش نمی‌شوند.
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Phillip Lougher <phillip@squashfs.org.uk>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2026 Phillip Lougher <phillip@squashfs.org.uk>
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو»
منتشرشده توسط بنیاد نرم‌افزارهای آزاد؛ نسخه ۲ یا (به انتخاب خودتان) هر نسخه بالاتری،
دوباره توزیع کنید یا تغییر دهید.
.PP
این برنامه به این امید توزیع می‌شود که مفید باشد، اما بدون هرگونه ضمانت؛
حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص.
برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را مشاهده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR mksquashfs (1),
.BR sqfstar (1),
.BR sqfscat (1)
.PP
فایل README برای انتشار نسخه 4.7.5 بسته Squashfs\-tools و توصیف قابلیت‌های جدید در این نشانی قابل مطالعه است: https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7.5/README.md
.PP
راهنمای استفاده از Unsquashfs در این نشانی قابل مطالعه است: https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7.5/USAGE\-UNSQUASHFS.md
.PP
فایل تغییرات (CHANGELOG) برای ابزارهای Squashfs در این نشانی قابل دسترسی است: https://github.com/plougher/squashfs\-tools/blob/master/CHANGES.md