.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH SQFSTAR "1" "March 2026" "sqfstar version 4.7.5" "User Commands"
.SH "نام (NAME)"
sqfstar \- ابزاری برای ایجاد فایل‌سیستم squashfs از یک آرشیو tar
.SH "خلاصه دستور (SYNOPSIS)"
  cat xxx.tar | sqfstar [OPTIONS] FILESYSTEM [exclude files]
  zcat xxx.tgz | sqfstar [OPTIONS] FILESYSTEM [exclude files]
  xzcat xxx.tar.xz | sqfstar [OPTIONS] FILESYSTEM [exclude files]
  zstdcat xxx.tar.zst | sqfstar [OPTIONS] FILESYSTEM [exclude files]
.SH "توضیحات (DESCRIPTION)"
Squashfs یک فایل‌سیستم فقط‌خواندنی با فشرده‌سازی بالا برای لینوکس است.
این ابزار از فشرده‌سازی gzip/xz/lzo/lz4/zstd برای فشرده‌کردن فایل‌ها، inodeها و دایرکتوری‌ها استفاده می‌کند. inodeها در این سیستم بسیار کوچک هستند و تمام بلوک‌ها برای به حداقل رساندن بار اضافی داده بسته‌بندی شده‌اند. اندازه‌های بلوک بزرگ‌تر از 4K تا حداکثر 1Mbytes پشتیبانی می‌شوند (اندازه پیش‌فرض بلوک 128K است).

Squashfs برای کاربردهای عمومی فایل‌سیستم فقط‌خواندنی، استفاده‌های آرشیوی (مانند مواردی که ممکن است یک فایل .tar.gz استفاده شود) و در سیستم‌های دارای محدودیت دستگاه بلوکی/حافظه (مانند سیستم‌های تعبیه‌شده) که بار اضافی کم مورد نیاز است، طراحی شده است.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های فشرده‌سازی فایل‌سیستم (Filesystem compression options):"
.TP
\fB\-b\fR BLOCK\-SIZE
تنظیم بلوک داده به BLOCK\-SIZE. مقدار پیش‌فرض 128 Kbytes است. به‌صورت اختیاری می‌توان از پسوندهای K ،KB ،Kbytes یا M ،MB ،Mbytes به ترتیب برای تعیین Kbytes یا Mbytes استفاده کرد.
.TP
\fB\-comp\fR COMP
انتخاب روش فشرده‌سازی COMP. برای مشاهده گزینه‌های فشرده‌ساز COMP دستور \fB\-help\-comp\fR COMP یا برای تمام فشرده‌سازها ALL را اجرا کنید. فشرده‌سازهای موجود: gzip (پیش‌فرض)، lzo، lz4، xz، zstd، lzma.
.TP
\fB\-noI\fR
جدول inode فشرده‌سازی نشود.
.TP
\fB\-noId\fR
جدول uid/gid فشرده‌سازی نشود (با \fB\-noI\fR اعمال می‌شود).
.TP
\fB\-noD\fR
بلوک‌های داده فشرده‌سازی نشوند.
.TP
\fB\-noF\fR
بلوک‌های قطعه (fragment blocks) فشرده‌سازی نشوند.
.TP
\fB\-noX\fR
ویژگی‌های گسترش‌یافته (extended attributes) فشرده‌سازی نشوند.
.TP
\fB\-no\-compression\fR
هیچ‌کدام از داده‌ها یا متاداده‌ها فشرده‌سازی نشوند. این گزینه معادل مشخص کردن \fB\-noI\fR \fB\-noD\fR \fB\-noF\fR و \fB\-noX\fR است.
.SS "گزینه‌های ساخت فایل‌سیستم (Filesystem build options):"
.TP
\fB\-exports\fR
قابلیت صدور فایل‌سیستم از طریق NFS را فراهم می‌کند.
.TP
\fB\-no\-sparse\fR
فایل‌های کم‌پشت (sparse files) شناسایی نشوند.
.TP
\fB\-no\-fragments\fR
از قطعات (fragments) استفاده نشود.
.TP
\fB\-no\-tailends\fR
انتهای فایل‌ها در قطعات بسته‌بندی نشوند.
.TP
\fB\-no\-duplicates\fR
بررسی فایل‌های تکراری انجام نشود.
.TP
\fB\-no\-hardlinks\fR
فایل‌ها پیوند سخت (hardlink) نشوند، بلکه نسخه‌های تکراری ذخیره گردند.
.TP
\fB\-regex\fR
اجازه استفاده از عبارت‌های باقاعده POSIX در دایرکتوری‌ها/فایل‌های مستثنی‌شده را می‌دهد.
.TP
\fB\-ignore\-zeros\fR
امکان اتصال چند فایل tar به یکدیگر و ارسال آن‌ها به Sqfstar را فراهم می‌کند. به‌طور معمول یک فایل tar دارای دو بلوک ۵۱۲ بایتی متوالی پر از صفر است که نشان‌دهنده EOF بوده و Sqfstar پس از برخورد با آن‌ها خواندن را بعد از اولین فایل tar متوقف می‌کند. این گزینه باعث می‌شود Sqfstar بلوک‌های پر شده با صفر را نادیده بگیرد.
.TP
\fB\-ef\fR EXCLUDE\-FILE
فهرست فایل‌ها/دایرکتوری‌های مستثنی‌شده. در هر خط یک مورد.
.SS "گزینه‌های زمانی فایل‌سیستم (Filesystem time options):"
.TP
\fB\-mkfs\-time\fR TIME
تنظیم برچسب زمانی ساخت فایل‌سیستم به TIME. مقدار TIME می‌تواند "inode" باشد که به معنای استفاده از تازه‌ترین برچسب زمانی inode است، یا یک عدد صحیح ۳۲ بیتی بدون علامت که ثانیه‌های پس از مبدأ زمانی (1970\-01\-01) را مشخص می‌کند، یا یک مقدار رشته‌ای که برای تجزیه به دستور "date" ارسال می‌شود. هر مقدار رشته‌ای که توسط دستور date پشتیبانی شود قابل استفاده است، مانند "now" ،"last week" یا "Wed Feb 15 21:02:39 GMT 2023".
.TP
\fB\-inode\-time\fR TIME
تنظیم تمام برچسب‌های زمانی فایل‌ها و دایرکتوری‌ها به TIME. مقدار TIME می‌تواند "inode" باشد که به معنای استفاده از تازه‌ترین برچسب زمانی inode است، یا یک عدد صحیح ۳۲ بیتی بدون علامت که ثانیه‌های پس از مبدأ زمانی (1970\-01\-01) را مشخص می‌کند، یا یک مقدار رشته‌ای که برای پردازش به دستور "date" ارسال می‌شود. هر مقدار رشته‌ای که توسط دستور date پشتیبانی شود قابل استفاده است، مانند "now" ،"last week" یا "Wed Feb 15 21:02:39 GMT 2025". این گزینه همچنین گزینهٔ \fB\-root\-time\fR را تنظیم کرده و آن را بازنویسی می‌کند.
.TP
\fB\-root\-time\fR TIME
تنظیم زمان دایرکتوری ریشه به TIME. مقدار TIME می‌تواند "inode" باشد که به معنای استفاده از تازه‌ترین برچسب زمانی inode است، یا یک عدد صحیح ۳۲ بیتی بدون علامت که ثانیه‌های پس از مبدأ زمانی (1970\-01\-01) را مشخص می‌کند، یا یک مقدار رشته‌ای که برای پردازش به دستور "date" داده می‌شود. هر مقدار رشته‌ای که توسط دستور date قابل شناسایی باشد می‌تواند استفاده شود، مانند "now" ،"last week" یا "Wed Feb 15 21:02:39 GMT 2025".
.TP
\fB\-repro\fR
ساخت یک ایمیج فایل‌سیستم بازتولیدپذیر (reproducible). این معادل با \fB\-mkfs\-time\fR inode است که با تنظیم زمان ساخت فایل‌سیستم بر روی تازه‌ترین برچسب زمانی inode، بازتولیدپذیری را به دست می‌آورد. بدیهی است در صورت تغییر برچسب‌های زمانی یا محتوا، تصویر فایل‌سیستم بازتولیدپذیر نخواهد بود.
.TP
\fB\-repro\-time\fR TIME
ساخت یک ایمیج فایل‌سیستم بازتولیدپذیر. این گزینه معادل با تعیین هم‌زمان \fB\-mkfs\-time\fR TIME و \fB\-inode\-time\fR TIME است که با تنظیم تمام برچسب‌های زمانی روی TIME، بازتولیدپذیری را ممکن می‌سازد. این گزینه در مواردی که ممکن است برچسب‌های زمانی تغییر کنند و نتوان از \fB\-repro\fR استفاده نمود، کاربرد دارد..SS "گزینه‌های مجوزهای سیستم‌فایل:"
.TP
\fB\-all\-root\fR
مالکیت تمام فایل‌ها و دایرکتوری‌ها را به root اختصاص می‌دهد.
.TP
\fB\-root\-mode\fR MODE
مجوزهای دایرکتوری ریشه را روی MODE تنظیم می‌کند. MODE می‌تواند نمادین یا اکتال باشد (بخش «مشخصات حالت نمادین» را ببینید). حالت پیش‌فرض ریشه ugo=rwx یا 0777 در مبنای هشت است.
.TP
\fB\-root\-uid\fR USER
مالک دایرکتوری ریشه را روی USER مشخص‌شده تنظیم می‌کند؛ USER می‌تواند یک uid عددی یا نام کاربر باشد.
.TP
\fB\-root\-gid\fR GROUP
گروه دایرکتوری ریشه را روی GROUP مشخص‌شده تنظیم می‌کند؛ GROUP می‌تواند یک gid عددی یا نام گروه باشد.
.TP
\fB\-force\-file\-mode\fR MODE
مجوزهای تمام فایل‌ها (غیردایرکتوری) را روی MODE تنظیم می‌کند. MODE می‌تواند نمادین یا اکتال باشد (بخش «مشخصات حالت نمادین» را ببینید).
.TP
\fB\-force\-dir\-mode\fR MODE
مجوزهای تمام دایرکتوری‌ها را روی MODE تنظیم می‌کند. MODE می‌تواند نمادین یا اکتال باشد (بخش «مشخصات حالت نمادین» را ببینید).
.TP
\fB\-force\-uid\fR USER
شناسه کاربری (uid) تمام فایل‌ها و دایرکتوری‌ها را روی USER مشخص‌شده تنظیم می‌کند؛ USER می‌تواند یک uid عددی یا نام کاربر باشد.
.TP
\fB\-force\-gid\fR GROUP
شناسه گروه (gid) تمام فایل‌ها و دایرکتوری‌ها را روی GROUP مشخص‌شده تنظیم می‌کند؛ GROUP می‌تواند یک gid عددی یا نام گروه باشد.
.TP
\fB\-uid\-gid\-offset\fR VALUE
تمام uidها و gidها را به اندازه مقدار مشخص‌شده VALUE جابه‌جا (offset) می‌کند. VALUE باید یک عدد صحیح مثبت باشد.
.TP
\fB\-default\-mode\fR MODE
فایل‌های tar اغلب مجوزهای دایرکتوری‌های میانی را ذخیره نمی‌کنند. این گزینه مجوزهای پیش‌فرض دایرکتوری را روی MODE تنظیم می‌کند. MODE می‌تواند نمادین یا اکتال باشد (بخش «مشخصات حالت نمادین» را ببینید). حالت پیش‌فرض u=rwx,go=rx یا 0755 در مبنای هشت است. این گزینه همچنین حالت دایرکتوری ریشه را تعیین می‌کند.
.TP
\fB\-default\-uid\fR USER
فایل‌های tar اغلب uidهای دایرکتوری‌های میانی را ذخیره نمی‌کنند. این گزینه مالک پیش‌فرض دایرکتوری را به جای کاربری که Sqfstar را اجرا می‌کند، روی USER تنظیم می‌کند. USER می‌تواند یک uid عددی یا نام کاربر باشد. این گزینه همچنین uid دایرکتوری ریشه را تنظیم می‌کند.
.TP
\fB\-default\-gid\fR GROUP
فایل‌های tar اغلب gidهای دایرکتوری‌های میانی را ذخیره نمی‌کنند. این گزینه گروه پیش‌فرض دایرکتوری را به جای گروه کاربری که Sqfstar را اجرا می‌کند، روی GROUP تنظیم می‌کند. GROUP می‌تواند یک gid عددی یا نام گروه باشد. این گزینه همچنین gid دایرکتوری ریشه را تنظیم می‌کند.
.TP
\fB\-numeric\-owner\fR
به جای استفاده از نام کاربر یا نام گروه، از uid و gid عددی موجود در tarfile استفاده می‌کند. این گزینه زمانی کاربرد دارد که نام کاربر یا نام گروه در سیستمی که Sqfstar روی آن اجرا می‌شود به uid یا gid متفاوتی نگاشت شود و این رفتار نگاشت مجدد مورد نظر نباشد.
.SS "گزینه‌های شبه‌فایل سیستم‌فایل:"
.TP
\fB\-p\fR PSEUDO\-DEFINITION
تعریف شبه‌فایل (pseudo file) را اضافه می‌کند. تعریف باید درون علامت نقل‌قول قرار گیرد. برای جزئیات ساختار، بخش «قالب تعریف شبه‌فایل» را ببینید.
.TP
\fB\-pd\fR "d mode uid gid"
یک دایرکتوری شبه پیش‌فرض تعیین می‌کند که اگر دایرکتوری مورد نظر در مسیر وجود نداشته باشد، در تعاریف شبه استفاده خواهد شد. این گزینه همچنین امکان مشخص کردن تعاریف شبه را بدون نیاز به تعریف تمام دایرکتوری‌های موجود در مسیر فراهم می‌کند. تعریف باید داخل نقل‌قول قرار گیرد.
.TP
\fB\-pd\fR "D time mode uid gid"
یک دایرکتوری شبه پیش‌فرض تعیین می‌کند که اگر دایرکتوری مورد نظر در مسیر وجود نداشته باشد، در تعاریف شبه استفاده خواهد شد. نوع D علاوه بر mode، uid و gid، اجازه تعیین برچسب زمانی (timestamp) را نیز می‌دهد.
.TP
\fB\-pf\fR PSEUDO\-FILE
فهرستی از تعاریف شبه‌فایل را اضافه می‌کند. تعاریف شبه‌فایل در pseudo\-fileها نباید درون نقل‌قول قرار گیرند.
.TP
\fB\-pseudo\-override\fR
باعث می‌شود uidها و gidهای شبه‌فایل بر گزینه‌های \fB\-all\-root\fR، \fB\-force\-uid\fR و \fB\-force\-gid\fR اولویت داشته باشند و آن‌ها را بازنویسی کنند.
.SS "گزینه‌های صفات گسترش‌یافته (xattrs) سیستم‌فایل:"
.TP
\fB\-no\-xattrs\fR
صفات گسترش‌یافته را ذخیره نمی‌کند.
.TP
\fB\-xattrs\fR
صفات گسترش‌یافته را ذخیره می‌کند (پیش‌فرض).
.TP
\fB\-xattrs\-exclude\fR REGEX
تمام نام‌های xattr منطبق با REGEX را مستثنی می‌کند. REGEX یک عبارت باقاعده POSIX است؛ برای مثال \fB\-xattrs\-exclude\fR '^user.' صفات xattr را از فضای‌نام user مستثنی می‌کند.
.TP
\fB\-xattrs\-include\fR REGEX
تمام نام‌های xattr منطبق با REGEX را شامل می‌شود. REGEX یک عبارت باقاعده POSIX است؛ برای مثال \fB\-xattrs\-include\fR '^user.' صفات xattr را از فضای‌نام user شامل می‌شود.
.TP
\fB\-xattrs\-add\fR NAME=VAL
صفت xattr با نام NAME و مقدار VAL را به فایل‌ها اضافه می‌کند. اگر یک xattr کاربری (user) باشد، به فایل‌های عادی و دایرکتوری‌ها اضافه خواهد شد (راهنمای man 7 xattr را ببینید). در غیر این صورت به تمام فایل‌ها اضافه می‌شود. VAL به‌طور پیش‌فرض به صورت باینری (یعنی یک دنباله بایت تفسیرنشده) پردازش می‌شود، اما می‌تواند پیشوند 0s داشته باشد که در این صورت با کدگذاری base64 تفسیر می‌شود، یا پیشوند 0x داشته باشد که به صورت هگزادسیمال تفسیر خواهد شد. علاوه بر این می‌تواند پیشوند 0t داشته باشد که این کدگذاری مشابه کدگذاری باینری است، با این تفاوت که با بک‌اسلش‌ها رفتار ویژه‌ای صورت می‌گیرد و یک بک‌اسلش به همراه ۳ رقم اکتال می‌تواند برای کدگذاری هر نویسه ASCII استفاده شود، که طبیعتاً برای کدگذاری کدهای کنترلی نیز کاربرد دارد. این گزینه می‌تواند چندین بار برای افزودن چندین xattr تکرار شود.
.SS "گزینه‌های زمان اجرای Sqfstar:"
.TP
\fB\-version\fR
نسخه، پروانه انتشار و پیام کپی‌رایت را چاپ می‌کند.
.TP
\fB\-force\fR
اجرای Sqfstar را برای نوشتن روی دستگاه بلوکی (block device) یا فایل اجباری می‌کند.
.TP
\fB\-exit\-on\-error\fR
خطاهایی را که معمولاً نادیده گرفته می‌شوند، به عنوان خطای مهلک در نظر می‌گیرد.
.TP
\fB\-quiet\fR
خروجی پرجزئیات نمایش داده نمی‌شود.
.TP
\fB\-info\fR
فایل‌های نوشته‌شده در سیستم‌فایل را در stdout چاپ می‌کند. این گزینه به‌طور خودکار نوار پیشرفت را غیرفعال می‌کند. برای چاپ خروجی در فایل بدون غیرفعال شدن نوار پیشرفت، \fB\-info\-file\fR را ببینید.
.TP
\fB\-info\-file\fR FILE
فایل‌های نوشته‌شده در سیستم‌فایل را در فایل FILE چاپ می‌کند. این گزینه نوار پیشرفت را غیرفعال نمی‌کند.
.TP
\fB\-no\-progress\fR
نوار پیشرفت را نمایش نمی‌دهد.
.TP
\fB\-progress\fR
هنگام استفاده از گزینه \fB\-info\fR، نوار پیشرفت را نمایش می‌دهد.
.TP
\fB\-percentage\fR
به جای نوار پیشرفت کامل، درصد را نمایش می‌دهد. می‌تواند در دستوراتی مانند dialog \fB\-\-gauge\fR و غیره به کار رود.
.TP
\fB\-throttle\fR PERCENTAGE
نرخ ورودی I/O را به میزان درصد داده‌شده مهار می‌کند (throttle). از این گزینه می‌توان برای کاهش مصرف I/O و CPU توسط Sqfstar استفاده کرد.
.TP
\fB\-limit\fR PERCENTAGE
نرخ ورودی I/O را به درصد داده‌شده محدود می‌کند. این گزینه می‌تواند برای کاهش مصرف I/O و CPU توسط Sqfstar استفاده شود (جایگزینی برای \fB\-throttle\fR).
.TP
\fB\-processors\fR NUMBER
از NUMBER پردازنده استفاده می‌کند. به‌طور پیش‌فرض از تمام پردازنده‌های در دسترس استفاده خواهد شد.
.TP
\fB\-mem\fR SIZE
میزان SIZE از حافظه فیزیکی را برای حافظه‌های موقت (کش‌ها) اختصاص می‌دهد. به ترتیب از K، M یا G برای مشخص کردن کیلوبایت، مگابایت یا گیگابایت استفاده کنید.
.TP
\fB\-mem\-percent\fR PERCENT
به میزان PERCENT درصد از حافظه فیزیکی را برای کش‌ها استفاده می‌کند. پیش‌فرض 25% است.
.TP
\fB\-mem\-default\fR
میزان استفاده پیش‌فرض از حافظه را بر حسب مگابایت چاپ می‌کند.
.TP
\fB\-overcommit\fR PERCENT
اجازه می‌دهد تا PERCENT درصد ریسه (thread) بیشتر از تعداد پردازنده‌های موجود به صورت موازی اجرا شوند. این کار ممکن است استفاده از CPU را افزایش دهد. پیش‌فرض 0% است، زیرا در حالت عادی بیش‌تخصیص (overcommitting) به دلیل تکانش شدید حافظه (thrashing) کارایی را کاهش می‌دهد. مقدار درصد بر اساس دانه‌بندی (granularity) تعداد پردازنده‌ها است؛ مثلاً ۴ پردازنده دارای دانه‌بندی درصدی ۲۵٪ و ۲۰ پردازنده دارای دانه‌بندی درصدی ۵٪ هستند..SS "گزینه‌های تخصصی (این گزینه‌ها ممکن است فایل‌سیستم را غیرقابل سوار کردن کنند):"
.TP
\fB\-stream\fR
ارسال خروجی فایل‌سیستم به STDOUT به جای یک فایل. این کار امکان لوله‌کشی (pipe) خروجی را به برنامه‌ای دیگر یا هدایت به مکانی دیگر از طریق ssh فراهم می‌کند. فایل‌سیستم جریانیِ Squashfs حاصل‌شده یک فایل‌سیستم معمولی نخواهد بود، زیرا ابربلاک (super block) در انتهای فایل‌سیستم قرار خواهد گرفت. اما بعداً می‌توان آن را با گزینهٔ \fB\-fix\fR اصلاح کرد و ابزار Unsquashfs نسخهٔ 4.7.3 و جدیدتر می‌تواند فایل‌سیستم‌های جریانی اصلاح‌نشده را مستقیماً بخواند. با استفاده از گزینهٔ \fB\-stream\fR، تشخیص داده‌های تکراری غیرفعال می‌شود.
.TP
\fB\-fix\fR FILESYSTEM
اصلاح FILESYSTEM تولیدشده با استفاده از گزینهٔ \fB\-stream\fR.
.TP
\fB\-nopad\fR
فایل‌سیستم به مضربی از 4K پدگذاری (تراز) نشود.
.TP
\fB\-offset\fR OFFSET
نادیده‌گرفتن OFFSET بایت در ابتدای FILESYSTEM. به صورت اختیاری می‌توان پسوند K، M یا G را به ترتیب برای مشخص کردن کیلوبایت، مگابایت یا گیگابایت به کار برد. پیش‌فرض 0 بایت است.
.TP
\fB\-o\fR OFFSET
مترادفی برای \fB\-offset\fR.
.SS "گزینه‌های راهنما:"
.TP
\fB\-help\fR
چاپ خلاصه اطلاعات راهنما در صفحه‌بند (یا stdout اگر خروجی ترمینال نباشد).
.TP
\fB\-help\-option\fR REGEX
چاپ اطلاعات راهنما برای گزینه‌های منطبق با REGEX در صفحه‌بند (یا stdout اگر خروجی ترمینال نباشد).
.TP
\fB\-help\-section\fR SECTION
چاپ اطلاعات راهنما برای بخش SECTION در صفحه‌بند (یا stdout اگر خروجی ترمینال نباشد). اگر SECTION دقیقاً با نام یک بخش مطابقت نداشته باشد، به عنوان یک عبارت باقاعده (regular expression) در نظر گرفته می‌شود و تمام بخش‌های منطبق نمایش داده می‌شوند. از "list" به عنوان نام بخش برای دریافت فهرستی از بخش‌ها و نام آن‌ها استفاده کنید.
.TP
\fB\-help\-comp\fR COMP
چاپ گزینه‌های فشرده‌ساز برای فشرده‌ساز COMP. از "list" برای دریافت فهرستی از فشرده‌سازهای موجود، و از "all" برای دریافت گزینه‌های فشرده‌ساز همهٔ فشرده‌سازها استفاده کنید.
.TP
\fB\-help\-all\fR
چاپ اطلاعات راهنما برای تمام گزینه‌ها و بخش‌های Sqfstar در صفحه‌بند (یا stdout اگر خروجی ترمینال نباشد).
.TP
\fB\-Xhelp\fR
چاپ گزینه‌های فشرده‌ساز برای فشرده‌ساز انتخاب‌شده.
.TP
\fB\-h\fR
جایگزین کوتاه‌نویسی‌شده برای \fB\-help\fR.
.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
عدم استفاده از صفحه‌بند (pager) برای خروجی اطلاعات راهنما.
.TP
\fB\-cols\fR WIDTH
استفاده از WIDTH ستون برای نمایش اطلاعات راهنما. زمانی که خروجی به ترمینال هدایت نشده باشد مفید است.
.SS "گزینه‌های متفرقه:"
.TP
\fB\-fstime\fR TIME
نام جایگزین برای mkfs\-time.
.TP
\fB\-root\-owned\fR
نام جایگزین برای \fB\-all\-root\fR.
.TP
\fB\-noInodeCompression\fR
نام جایگزین برای \fB\-noI\fR.
.TP
\fB\-noIdTableCompression\fR
نام جایگزین برای \fB\-noId\fR.
.TP
\fB\-noDataCompression\fR
نام جایگزین برای \fB\-noD\fR.
.TP
\fB\-noFragmentCompression\fR
نام جایگزین برای \fB\-noF\fR.
.TP
\fB\-noXattrCompression\fR
نام جایگزین برای \fB\-noX\fR.
.SH "قالب تعریف شبه‌فایل (PSEUDO FILE DEFINITION FORMAT)"
.TP
\fB\-p\fR "filename d mode uid gid"
ایجاد یک دایرکتوری.
.TP
\fB\-p\fR "filename m mode uid gid"
تغییر دادن filename.
.TP
\fB\-p\fR "filename b mode uid gid major minor"
ایجاد یک دستگاه بلوکی.
.TP
\fB\-p\fR "filename c mode uid gid major minor"
ایجاد یک دستگاه نویسه‌ای.
.TP
\fB\-p\fR "filename f mode uid gid command"
ایجاد فایل از خروجی استاندارد (stdout) دستور command.
.TP
\fB\-p\fR "filename s mode uid gid symlink"
ایجاد یک پیوند نمادین.
.TP
\fB\-p\fR "filename i mode uid gid [s|f]"
ایجاد یک سوکت (s) یا FIFO (f).
.TP
\fB\-p\fR "filename x name=val"
ایجاد یک صفت گسترش‌یافته (extended attribute).
.TP
\fB\-p\fR "filename h linkname"
ایجاد یک پیوند سخت به linkname، با دنبال کردن پیوندهای نمادین.
.TP
\fB\-p\fR "filename l linkname"
ایجاد یک پیوند سخت به linkname.
.TP
\fB\-p\fR "filename L pseudo_filename"
مشابه، اما پیوند به یک شبه‌فایل (pseudo file).
.TP
\fB\-p\fR "filename D time mode uid gid"
ایجاد یک دایرکتوری با برچسب زمانی time.
.TP
\fB\-p\fR "filename M time mode uid gid"
تغییر دادن یک فایل با برچسب زمانی time.
.TP
\fB\-p\fR "filename B time mode uid gid major minor"
ایجاد دستگاه بلوکی با برچسب زمانی time.
.TP
\fB\-p\fR "filename C time mode uid gid major minor"
ایجاد دستگاه نویسه‌ای با برچسب زمانی time.
.TP
\fB\-p\fR "filename F time mode uid gid command"
ایجاد فایل با برچسب زمانی time.
.TP
\fB\-p\fR "filename S time mode uid gid symlink"
ایجاد پیوند نمادین با برچسب زمانی time.
.TP
\fB\-p\fR "filename I time mode uid gid [s|f]"
ایجاد سوکت یا FIFO با برچسب زمانی time..SH "مشخصات حالت نمادین (SYMBOLIC MODE SPECIFICATION)"
حالت نمادین در قالب [ugoa]*[[+\-=]PERMS]+ است. PERMS = [rwxXst]+ یا [ugo] است، و این دنباله می‌تواند با کاما جدا شده و تکرار شود.
.PP
ترکیبی از حروف ugoa مشخص می‌کند کدام بیت‌های مجوز تحت تأثیر قرار خواهند گرفت؛ u به معنی کاربر (user)، g به معنی گروه (group)، o به معنی دیگران (other)، و a به معنی همه یا ugo است.
.PP
حرف بعدی +، \- یا = است. حرف + به معنای افزودن به بیت‌های مجوز موجود، \- به معنای حذف بیت‌ها از بیت‌های مجوز موجود، و = به معنای تنظیم بیت‌های مجوز است.
.PP
بیت‌های مجوز (PERMS) ترکیبی از [rwxXst] هستند که آن بیت‌ها را برای ترکیب مشخص‌شده ugoa تنظیم/اضافه/حذف می‌کنند؛ r به معنای خواندن، w به معنای نوشتن و x به معنای اجرا برای فایل‌ها یا پیمایش/جستجو برای دایرکتوری‌ها است. X معنای ویژه‌ای دارد: اگر فایل یک دایرکتوری باشد معادل x یا جستجو است، اما اگر دایرکتوری نباشد، تنها در صورتی اعمال می‌شود که اجازه اجرا از قبل برای کاربر، گروه یا دیگران تنظیم شده باشد. پرچم s شناسه کاربر یا گروه را هنگام اجرا تنظیم می‌کند، و پرچم t روی یک دایرکتوری حذف محدودشده (restricted deletion) را فعال می‌کند، یا از نظر تاریخی در صورت دایرکتوری نبودن فایل را چسبنده (sticky) می‌کند.
.PP
بیت‌های مجوز همچنین می‌توانند u، g یا o باشند که بیت‌های مجوز را به ترتیب از کاربر، گروه یا دیگرانِ فایل برمی‌دارد.
.SH "وضعیت خروج (EXIT STATUS)"
.TP
0
Sqfstar با موفقیت یک فایل‌سیستم تولید کرد.
.TP
1
خطاهای مهلکی رخ داد، Sqfstar متوقف شد و فایل‌سیستمی تولید نکرد.
.SH "فشرده‌سازهای موجود و گزینه‌های ویژه فشرده‌ساز (COMPRESSORS AVAILABLE AND COMPRESSOR SPECIFIC OPTIONS)"
.SS "gzip (پیش‌فرض):"
.TP
\fB\-Xcompression\-level\fR COMPRESSION\-LEVEL
مقدار COMPRESSION\-LEVEL باید ۱ .. ۹ باشد (پیش‌فرض ۹).
.TP
\fB\-Xwindow\-size\fR WINDOW\-SIZE
مقدار WINDOW\-SIZE باید ۸ .. ۱۵ باشد (پیش‌فرض ۱۵).
.TP
\fB\-Xstrategy\fR strategy1,strategy2,...,strategyN
فشرده‌سازی با استفاده از strategy1,strategy2,...,strategyN به نوبت و انتخاب بهترین فشرده‌سازی. راهبردهای موجود: default, filtered, huffman_only, run_length_encoded و fixed.
.SS "lzo:"
.TP
\fB\-Xalgorithm\fR ALGORITHM
جایی که ALGORITHM یکی از موارد زیر است: lzo1x_1, lzo1x_1_11, lzo1x_1_12, lzo1x_1_15, lzo1x_999 (پیش‌فرض).
.TP
\fB\-Xcompression\-level\fR COMPRESSION\-LEVEL
مقدار COMPRESSION\-LEVEL باید ۱ .. ۹ باشد (پیش‌فرض ۸). تنها بر الگوریتم lzo1x_999 اعمال می‌شود.
.SS "lz4:"
.TP
\fB\-Xhc\fR
فشرده‌سازی با استفاده از LZ4 High Compression.
.SS "xz:"
.TP
\fB\-Xbcj\fR filter1,filter2,...,filterN
فشرده‌سازی با استفاده از filter1,filter2,...,filterN به نوبت (علاوه بر حالت بدون فیلتر)، و انتخاب بهترین فشرده‌سازی. فیلترهای موجود: x86, arm, armthumb, arm64, powerpc, sparc, ia64, riscv.
.TP
\fB\-Xdict\-size\fR DICT\-SIZE
استفاده از DICT\-SIZE به عنوان اندازه دیکشنری XZ. اندازه دیکشنری می‌تواند به عنوان درصدی از اندازه بلوک، یا به عنوان یک مقدار مطلق مشخص شود. اندازه دیکشنری باید کمتر یا مساوی اندازه بلوک و ۸۱۹۲ بایت یا بزرگتر باشد. همچنین باید بتوان آن را در سربرگ xz به عنوان 2^n یا 2^n+2^(n+1) ذخیره کرد. مقادیر نمونه برای dict\-size عبارتند از: 75%, 50%, 37.5%, 25%، یا 32K, 16K, 8K و غیره.
.SS "zstd:"
.TP
\fB\-Xcompression\-level\fR COMPRESSION\-LEVEL
مقدار COMPRESSION\-LEVEL باید \fB\-131072\fR .. \fB\-1\fR یا ۱ .. ۲۲ باشد (پیش‌فرض ۱۵). سطوح فشرده‌سازی منفی با گزینه \fB\-\-fast\fR در zstd متناظر هستند.
.SS "lzma:"
.IP
(بدون گزینه) (منسوخ شده \- عدم پشتیبانی در هسته)
.SH "محیط (ENVIRONMENT)"
.TP
SQFS_CMDLINE
در صورت تنظیم، به عنوان دایرکتوری برای نوشتن فایل sqfs_cmdline استفاده می‌شود که حاوی آرگومان‌های خط فرمان داده شده به Sqfstar است. هر آرگومان خط فرمان در گیومه قرار می‌گیرد تا اطمینان حاصل شود هنگام وجود فاصله در آرگومان‌ها ابهامی پیش نمی‌آید. اگر فایل از قبل موجود باشد، خط فرمان به انتهای فایل افزوده می‌شود.
.TP
SOURCE_DATE_EPOCH
در صورت تنظیم، به عنوان برچسب زمانی ایجاد فایل‌سیستم استفاده می‌شود. همچنین هر برچسب زمانی فایلی که پس از SOURCE_DATE_EPOCH باشد به SOURCE_DATE_EPOCH محدود خواهد شد. برای اطلاعات بیشتر <https://reproducible\-builds.org/docs/source\-date\-epoch> را ببینید.
.TP
PAGER
در صورت تنظیم، به عنوان نام برنامه‌ای که برای نمایش متن راهنما به کار می‌رود استفاده می‌شود. این مقدار می‌تواند یک دستور ساده یا یک مسیر کامل باشد. مقدار پیش‌فرض \fI\,/usr/bin/pager\/\fP است.
.SH "مثال‌ها (EXAMPLES)"
.TP
sqfstar IMAGE.SQFS < archive.tar
ایجاد یک فایل‌سیستم Squashfs از فایل فشرده‌نشده tar با نام "archive.tar".
برنامه Sqfstar از فشرده‌ساز پیش‌فرض (معمولاً gzip) و اندازه بلوک ۱۲۸
کیلوبایت استفاده خواهد کرد.
.TP
zcat archive.tgz | sqfstar IMAGE.SQFS
ایجاد یک فایل‌سیستم Squashfs از فایل فشرده tar با نام "archive.tgz". برنامه Sqfstar
از فشرده‌ساز پیش‌فرض (معمولاً gzip) و اندازه بلوک ۱۲۸ کیلوبایت استفاده خواهد کرد.
.TP
sqfstar -b 1M -comp zstd IMAGE.SQFS < archive.tar
استفاده از اندازه بلوک ۱ مگابایت و فشرده‌سازی Zstandard برای ایجاد فایل‌سیستم.
.TP
sqfstar -root-uid 0 -root-gid 0 IMAGE.SQFS < archive.tar
فایل‌های tar تعریفی برای دایرکتوری ریشه ارائه نمی‌دهند، و حالت پیش‌فرض این است
که مالکیت/مالکیت گروهی دایرکتوری به کاربری که Sqfstar را اجرا می‌کند داده شود. دستور
فوق مالکیت/مالکیت گروهی را روی root تنظیم می‌کند.
.TP
sqfstar -root-mode 0755 IMAGE.SQFS < archive.tar
مجوز پیش‌فرض برای دایرکتوری ریشه 0777 (rwxrwxrwx) است. دستور فوق
مجوزها را روی 0755 (rwxr-xr-x) تنظیم می‌کند.
.TP
sqfstar -all-time now IMAGE.SQFS < archive.tar
تنظیم برچسب زمانی همه فایل‌ها و دایرکتوری‌ها روی "now" (زمان فعلی) در فایل‌سیستم.
.TP
sqfstar -force-uid phillip -force-gid phillip IMAGE.SQFS < archive.tar
تنظیم مالکیت تمام فایل‌ها و دایرکتوری‌های فایل‌سیستم برای "phillip".
.TP
sqfstar -force-file-mode ugo+r,go-w IMAGE.SQFS < archive.tar
قابل خواندن کردن تمام فایل‌ها برای همه، ولی فقط قابل نوشتن توسط کاربر، و عدم
تغییر سایر بیت‌های مجوز.
.TP
sqfstar IMAGE.SQFS file1 file2 < archive.tar
مستثنی کردن file1 و file2 از فایل tar هنگام ایجاد فایل‌سیستم.
.TP
sqfstar IMAGE.SQFS "*.gz" < archive.tar
مستثنی کردن تمام فایل‌های موجود در دایرکتوری سطح بالا که با الگوی عمومی
"*.gz" مطابقت دارند.
.TP
sqfstar IMAGE.SQFS "... *.gz" < archive.tar
مستثنی کردن هر فایلی که با الگوی عمومی "*.gz" در هر کجای فایل
tar مطابقت داشته باشد. عبارت اولیه "..." نشان می‌دهد که الگوی عمومی «مهارنشده»
است و در هر مکانی مطابقت خواهد داشت.
.PP
نکته: هنگام ارسال نام‌های دارای نویسه عمومی به Sqfstar، آن‌ها باید در گیومه قرار گیرند (همانند
مثال‌های بالا) تا اطمینان حاصل شود که توسط شل پردازش نمی‌شوند..SS استفاده از تعاریف شبه‌فایل
.TP
sqfstar -p "build_dir d 0644 0 0" IMAGE.SQFS < archive.tar
ایجاد یک دایرکتوری با نام «build_dir» در سیستم‌فایل خروجی.
.TP
sqfstar -p "version.txt l /tmp/build/version" IMAGE.SQFS < archive.tar
ایجاد یک ارجاع به نام «version.txt» به فایلی که در بایگانی tar وجود ندارد، به گونه‌ای که انگار آن فایل درون بایگانی tar قرار دارد رفتار می‌کند.
.TP
sqfstar -p "date.txt f 0644 0 0 date" IMAGE.SQFS < archive.tar
ایجاد فایلی به نام «date.txt» که خروجی استاندارد (stdout) حاصل از اجرای دستور «date» را در خود نگه می‌دارد.
.TP
sqfstar -p "\\"hello world\\" f 0644 0 0 date" IMAGE.SQFS < archive.tar
مشابه بالا، اما نشان می‌دهد که نام فایل‌ها در صورت قرار گرفتن درون نقل‌قول می‌توانند دارای فاصله باشند. نقل‌قول‌ها باید با بک‌اسلش همراه شوند تا از پردازش آن‌ها توسط پوسته محافظت شود.
.TP
sqfstar -p "input f 0644 root root dd if=/dev/sda1 bs=1024" IMAGE.SQFS < archive.tar
ایجاد فایلی حاوی محتویات پارتیشن /dev/sda1. دستور بالا امکان دریافت ورودی از این فایل‌های ویژه و قرار دادن آن در سیستم‌فایل Squashfs را فراهم می‌کند.
.PP
نکته: تعاریف شبه‌فایل باید درون نقل‌قول قرار گیرند (همانند مثال‌های بالا)، تا اطمینان حاصل شود که به عنوان یک آرگومان واحد به Mksquashfs ارسال می‌شوند و توسط پوسته پردازش نمی‌گردند.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Phillip Lougher <phillip@squashfs.org.uk>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
کپی‌رایت \(co 2026 Phillip Lougher <phillip@squashfs.org.uk>
.PP
این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) منتشر شده توسط بنیاد نرم‌افزارهای آزاد؛ نسخهٔ ۲ مجوز یا (به انتخاب خودتان) هر نسخهٔ متأخر دیگری بازتوزیع کرده یا تغییر دهید.
.PP
این برنامه به این امید که مفید واقع شود توزیع شده است، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
mksquashfs(1), unsquashfs(1), sqfscat(1)
.PP
فایل README مربوط به انتشار Squashfs\-tools 4.7.5 که ویژگی‌های جدید را شرح می‌دهد، در اینجا قابل مطالعه است https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7.5/README.md
.PP
راهنمای استفاده از Sqfstar در اینجا قابل مطالعه است https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7.5/USAGE\-SQFSTAR.md
.PP
فایل CHANGELOG ابزارهای Squashfs در اینجا قابل مطالعه است https://github.com/plougher/squashfs\-tools/blob/master/CHANGES.md