نام (NAME)

sqfscat - ابزاری برای الحاق و نمایش فایل‌ها از یک سیستم‌فایل squashfs در خروجی استاندارد (stdout)

خلاصه دستور (SYNOPSIS)

sqfscat [OPTIONS] FILESYSTEM [فهرست فایل‌ها برای نمایش در stdout]

توضیحات (DESCRIPTION)

Squashfs یک سیستم‌فایل فقط‌خواندنی با فشرده‌سازی بالا برای لینوکس است. این سیستم‌فایل از فشرده‌سازی‌های gzip/xz/lzo/lz4/zstd برای فشرده‌سازی فایل‌ها، inodeها و دایرکتوری‌ها استفاده می‌کند. inodeها در سیستم بسیار کوچک هستند و تمام بلوک‌ها برای به حداقل رساندن سربار داده‌ها فشرده شده‌اند. اندازه‌های بلوک بزرگ‌تر از 4K تا حداکثر ۱ مگابایت پشتیبانی می‌شوند (اندازه پیش‌فرض بلوک 128K است).

سیستم‌فایل Squashfs برای استفاده عمومی به عنوان سیستم‌فایل فقط‌خواندنی، استفاده‌های آرشیوی (یعنی مواردی که ممکن است از یک فایل .tar.gz استفاده شود)، و در سیستم‌های دارای محدودیت دستگاه بلوکی/حافظه (مانند سیستم‌های تعبیه‌شده) که سربار کم مورد نیاز است، در نظر گرفته شده است.

گزینه‌ها (OPTIONS)

گزینه‌های زمان اجرا (Runtime options):

-v, -version: چاپ اطلاعات نسخه، مجوز و حق نشر.
-p NUMBER, -processors NUMBER: استفاده از NUMBER پردازنده. به طور پیش‌فرض از تعداد پردازنده‌های در دسترس استفاده خواهد شد.
-mem SIZE: استفاده از SIZE حافظه فیزیکی برای حافظه موقت (کش). برای مشخص کردن به ترتیب کیلوبایت، مگابایت یا گیگابایت از پسوندهای K، M یا G استفاده کنید. پیش‌فرض 512 مگابایت است.
-mem-percent PERCENT: استفاده از PERCENT درصد حافظه فیزیکی برای حافظه موقت (کش).
-o BYTES, -offset BYTES: نادیده گرفتن BYTES بایت در ابتدای FILESYSTEM. به صورت اختیاری می‌توان یک پسوند K، M یا G به ترتیب برای مشخص کردن کیلوبایت، مگابایت یا گیگابایت تعیین کرد (پیش‌فرض 0 بایت است).
-ig, -ignore-errors: خطاهای رخ‌داده هنگام نوشتن فایل‌ها در stdout به عنوان خطای غیرمرگبار در نظر گرفته شوند.
-st, -strict-errors: تمامی خطاها به عنوان خطای مرگبار در نظر گرفته شوند.
-no-exit, -no-exit-code: عدم تنظیم کد خروج (به مقدار غیرصفر) در صورت بروز خطاهای غیرمرگبار.

-no-wild, -no-wildcards: عدم استفاده از تطبیق نویسه عمومی (wildcard) در نام فایل‌ها.
-r, -regex: در نظر گرفتن نام فایل‌ها به عنوان عبارات باقاعده POSIX به جای استفاده از بسط پیش‌فرض نویسه‌های عمومی پوسته (globbing).

گزینه‌های راهنما (Help options):

-h, -help: چاپ خلاصه اطلاعات راهنما در صفحه‌بند (یا stdout اگر خروجی ترمینال نباشد).
-help-option REGEX: چاپ اطلاعات راهنما برای گزینه‌های منطبق با REGEX در صفحه‌بند (یا stdout اگر خروجی ترمینال نباشد).
-help-section SECTION: چاپ اطلاعات راهنما برای بخش SECTION در صفحه‌بند (یا stdout اگر خروجی ترمینال نباشد). اگر SECTION دقیقاً با نام یک بخش مطابقت نداشته باشد، به عنوان یک عبارت باقاعده در نظر گرفته شده و تمام نام‌های بخش منطبق نمایش داده می‌شوند. از "list" به عنوان نام بخش برای دریافت فهرستی از بخش‌ها و نام آن‌ها استفاده کنید.
-help-all: چاپ اطلاعات راهنما برای تمامی گزینه‌ها و بخش‌های Sqfscat در صفحه‌بند (یا stdout اگر خروجی ترمینال نباشد).
-ho REGEX: شکل کوتاه‌شده و جایگزین گزینه -help-option.
-hs SECTION: شکل کوتاه‌شده و جایگزین گزینه -help-section.
-ha: شکل کوتاه‌شده و جایگزین گزینه -help-all.
-no-pager: عدم استفاده از صفحه‌بند برای خروجی اطلاعات راهنما.
-cols WIDTH: استفاده از WIDTH ستون برای نمایش اطلاعات راهنما. در صورتی که خروجی به ترمینال ارسال نشود مفید است.

وضعیت خروج (EXIT STATUS)

0: فایل یا فایل‌ها با موفقیت در stdout خروجی داده شدند.
1: خطاهای مرگبار رخ داده است، مانند خراب شدن سیستم‌فایل یا خطاهای I/O. ابزار Sqfscat عملیات را ادامه نداد و متوقف شد.
2: خطاهای غیرمرگبار رخ داده است، مانند فایل عادی نبودن یا عدم موفقیت در پیدا کردن مسیر. ابزار Sqfscat ادامه داد و متوقف نشد.

برای نحوه تأثیرگذاری گزینه‌های -ignore-errors، -strict-errors و -no-exit-code بر وضعیت خروج، به توضیحات آن‌ها مراجعه کنید.

فشرده‌سازهای موجود (DECOMPRESSORS AVAILABLE)

gzip, lzo, lz4, xz, zstd, lzma

متغیرهای محیطی (ENVIRONMENT)

SQFS_CMDLINE: در صورت مقداردهی، به عنوان دایرکتوری برای نوشتن فایل sqfs_cmdline استفاده می‌شود که حاوی آرگومان‌های خط فرمان ارائه‌شده به Sqfscat است. هر آرگومان خط فرمان درون نقل‌قول قرار می‌گیرد تا در صورت وجود فاصله در آرگومان‌ها، هیچ ابهامی وجود نداشته باشد. اگر فایل از قبل موجود باشد، خط فرمان به انتهای فایل اضافه می‌شود.
PAGER: در صورت مقداردهی، به عنوان نام برنامه‌ای که برای نمایش متن راهنما استفاده می‌شود به کار می‌رود. این مقدار می‌تواند یک دستور ساده یا یک مسیر کامل باشد. پیش‌فرض /usr/bin/pager است.

مثال‌ها (EXAMPLES)

sqfscat IMAGE.SQFS hello: نمایش محتوای "hello" در stdout.
sqfscat IMAGE.SQFS hello world: نمایش محتوای "hello" و سپس "world" در stdout.
sqfscat IMAGE.SQFS "*.[ch]": نمایش محتوای تمام فایل‌های موجود در دایرکتوری ریشه که با نویسه عمومی *.[ch] مطابقت دارند در stdout؛ مانند hello.c، hello.h، world.c، world.h.

توجه: هنگام ارسال نام‌های دارای نویسه عمومی (wildcard) به Sqfscat، آن‌ها باید درون علامت نقل‌قول قرار گیرند (مانند مثال‌های بالا) تا اطمینان حاصل شود که توسط پوسته پردازش نمی‌شوند.

نویسنده (AUTHOR)

نوشته‌شده توسط Phillip Lougher <phillip@squashfs.org.uk>

حق نشر (COPYRIGHT)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» منتشرشده توسط بنیاد نرم‌افزارهای آزاد؛ نسخه ۲ یا (به انتخاب خودتان) هر نسخه بالاتری، دوباره توزیع کنید یا تغییر دهید.

این برنامه به این امید توزیع می‌شود که مفید باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را مشاهده کنید.

همچنین ببینید (SEE ALSO)

mksquashfs(1), unsquashfs(1), sqfstar(1)

فایل README برای انتشار نسخه 4.7.5 بسته Squashfs-tools و توصیف قابلیت‌های جدید در این نشانی قابل مطالعه است: https://github.com/plougher/squashfs-tools/blob/master/Documentation/4.7.5/README.md

راهنمای استفاده از Sqfscat در این نشانی قابل مطالعه است: https://github.com/plougher/squashfs-tools/blob/master/Documentation/4.7.5/USAGE-SQFSCAT.md

فایل تغییرات (CHANGELOG) برای ابزارهای Squashfs در این نشانی قابل دسترسی است: https://github.com/plougher/squashfs-tools/blob/master/CHANGES.md