.\" Manpage for innoextract.
.\" Contact daniel@constexpr.org to correct errors or typos.
.TH innoextract 1 "(2020-08-09)" "1.9"
.SH "نام (NAME)"
innoextract \- ابزاری برای استخراج بسته‌های نصبی ایجادشده توسط Inno Setup
.SH "خلاصه دستور (SYNOPSIS)"
.B innoextract
.RB [ \-\-extract ]
.RB [ \-\-lowercase ]
[\fIگزینه‌ها\fR] [\fB\-\-\fP] \fIinstallers\fP ...

\fBinnoextract \-\-list\fP [\fIگزینه‌ها\fR] [\fB\-\-\fP] \fIinstallers\fP ...

\fBinnoextract \-\-test\fP [\fIگزینه‌ها\fR] [\fB\-\-\fP] \fIinstallers\fP ...
.SH "توضیحات (DESCRIPTION)"
دستور
\fBinnoextract\fP
ابزاری است که می‌تواند فایل‌های اجرایی نصاب ایجادشده توسط Inno Setup را استخراج کند.
.PP
دستور
\fBinnoextract\fP
فایل‌ها را از نصاب‌های مشخص‌شده در خط فرمان استخراج می‌کند.
.PP
برای استخراج یک بسته نصبی چندبخشی با فایل‌های داده خارجی، تنها کافی است فایل اجرایی (.exe) به عنوان آرگومان به
\fBinnoextract\fP
داده شود.
.SH "خلاصه گزینه‌ها (OPTIONS SUMMARY)"
.PP
در ادامه خلاصه‌ای از گزینه‌های موجود در innoextract آورده شده است. لطفاً برای توضیحات کامل به مستندات تفصیلی زیر مراجعه کنید.
.TP
.B گزینه‌های عمومی (Generic options):
.nf
 \-h \-\-help               نمایش گزینه‌های پشتیبانی‌شده
 \-v \-\-version            چاپ اطلاعات نسخه
    \-\-license            نمایش اطلاعات مجوز
.fi
.TP
.B عملیات‌ها (Actions):
.nf
 \-t \-\-test               فقط اعتبارسنجی چکسام‌ها، بدون نوشتن هیچ فایلی
 \-e \-\-extract            استخراج فایل‌ها (عملیات پیش‌فرض)
 \-l \-\-list               فقط فهرست کردن فایل‌ها، بدون نوشتن هیچ فایلی
    \-\-list\-sizes         فهرست کردن اندازه فایل‌ها
    \-\-list\-checksums     فهرست کردن چکسام فایل‌ها
 \-i \-\-info               چاپ اطلاعات درباره نصاب
    \-\-list\-languages     فهرست کردن زبان‌های پشتیبانی‌شده توسط نصاب
    \-\-gog\-game\-id        تشخیص شناسه بازی در GOG.com برای این نصاب
    \-\-show\-password      نمایش اطلاعات بررسی رمز عبور
    \-\-check\-password     توقف عملیات در صورت نادرست بودن رمز عبور
 \-V \-\-data\-version       فقط چاپ نسخه داده
.fi
.TP
.B اصلاح‌کننده‌ها (Modifiers):
.nf
    \-\-codepage \fICODEPAGE\fP  کدگذاری برای رشته‌های ANSI
    \-\-collisions \fIACTION\fP  نحوه مدیریت فایل‌های تکراری و تداخل‌ها
    \-\-default\-language   زبان پیش‌فرض برای تغییر نام
    \-\-dump               تخلیه محتوا بدون تبدیل نام فایل‌ها
 \-L \-\-lowercase          تبدیل نام فایل‌های استخراج‌شده به حروف کوچک
 \-T \-\-timestamps \fITZ\fP      منطقه زمانی برای زمان فایل‌ها یا "local" یا "none"
 \-d \-\-output\-dir \fIDIR\fP     استخراج فایل‌ها در دایرکتوری مشخص‌شده
 \-P \-\-password \fIPASSWORD\fP  رمز عبور برای فایل‌های رمزنگاری‌شده
    \-\-password\-file \fIFILE\fP فایل برای بارگذاری رمز عبور از آن
 \-g \-\-gog                پردازش آرشیوهای اضافی نصاب‌های GOG.com
    \-\-no\-gog\-galaxy      عدم اتصال مجدد قطعات فایل‌های GOG Galaxy
 \-n \-\-no\-extract\-unknown عدم استخراج نسخه‌های ناشناخته Inno Setup
.fi
.TP
.B فیلترها (Filters):
.nf
 \-m \-\-exclude\-temp       عدم استخراج فایل‌های موقت
    \-\-language \fILANG\fP      استخراج تنها فایل‌های مربوط به این زبان
    \-\-language\-only      فقط استخراج فایل‌های مختص یک زبان خاص
 \-I \-\-include \fIEXPR\fP       استخراج تنها فایل‌های منطبق با این مسیر
.fi
.TP
.B گزینه‌های نمایش (Display options):
.nf
 \-q \-\-quiet              نمایش اطلاعات کمتر
 \-s \-\-silent             نمایش تنها اطلاعات خطا و هشدار
    \-\-no\-warn\-unused     عدم هشدار درباره فایل‌های \fI.bin\fP استفاده‌نشده
 \-c \-\-color[=\fIENABLE\fP]     فعال/غیرفعال کردن خروجی رنگی
 \-p \-\-progress[=\fIENABLE\fP]  فعال/غیرفعال کردن نوار پیشرفت
.fi
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--\fP
تفسیر تمامی آرگومان‌های بعد از این گزینه به عنوان فایل، حتی اگر با خط تیره آغاز شوند.
.TP
\fB\-\-check\-password\fB
در صورتی که رمز عبور ارائه‌شده با استفاده از گزینه \fB\-\-password\fP یا \fB\-\-password\-file\fP با چکسام ذخیره‌شده در نصاب مطابقت نداشته باشد، پردازش متوقف می‌شود.
.PP
چکسام رمز عبور مورد استفاده برای این بررسی را می‌توان با استفاده از گزینه \fB\-\-show\-password\fP بازیابی کرد.
.TP
\fB\-\-codepage\fP \fICODEPAGE\fP
نسخه‌های غیر یونیکد Inno Setup رشته‌ها را با یک کدگذاری نامشخص ذخیره می‌کنند. به طور پیش‌فرض، \fBinnoextract\fP کدگذاری را از فهرست زبان‌های نصاب حدس می‌زند و در صورت عدم موفقیت به Windows-1252 بازمی‌گردد. از این گزینه می‌توان برای لغو این حدس با تعیین شماره کدپیج ویندوز غیرصفر استفاده کرد.
.PP
در پلتفرم‌های غیر ویندوزی، \fBinnoextract\fP تنظیمات محلی (locale) سیستم را نادیده گرفته و همیشه از UTF-8 به عنوان کدگذاری فایل‌سیستم و خروجی استاندارد استفاده می‌کند؛ گزینه \fB\-\-codepage\fP تنها کدگذاری ورودی را تغییر می‌دهد. با این حال، استفاده از شماره کدپیج "\fB65001\fP" به \fBinnoextract\fP دستور می‌دهد که فرض کند تمامی رشته‌ها از قبل به صورت UTF-8 کدگذاری شده‌اند و آن‌ها را بدون تبدیل خروجی دهد.
.PP
این گزینه روی نصاب‌های سازگار با یونیکد که همیشه از UTF-16LE استفاده می‌کنند، هیچ تأثیری ندارد. داده‌های نامعتبر UTF-16 با استفاده از کدگذاری WTF-8 نمایش داده می‌شوند که یک توسعه ساده از UTF-8 برای نمایش کدهای جانشین منفرد (unpaired surrogate code units) در UTF-16 است.
.TP
\fB\-\-collisions\fP \fIACTION\fP
نصاب‌های Inno Setup می‌توانند حاوی فایل‌های تکراری با نام یکسان باشند. این گزینه به innoextract می‌گوید که هنگام مواجهه با چنین تداخلی چه اقدامی انجام دهد. عملیات‌های معتبر عبارتند از:
.RS
.TP
"\fBoverwrite\fP"
تنها یکی از فایل‌های متداخل استخراج شود. این انتخاب مشابه نحوه بازنویسی فایل‌ها توسط Inno Setup در طول نصب انجام می‌شود. این حالت پیش‌فرض است.
.TP
"\fBrename\fP"
تغییر نام فایل‌هایی که قرار است با عمل "\fBoverwrite\fP" بازنویسی شوند، از طریق الحاق پسوندی شامل زبان فایل، معماری آن، مؤلفه‌ای که به آن تعلق دارد و/یا یک عدد برای یکتا کردن نام فایل. پسوند زبان (در صورت کاربرد) به فایل \fIپیش‌فرض\fP نیز اضافه می‌شود که قرار بود با عملیات "\fBoverwrite\fP" استخراج شود.
.TP
"\fBrename-all\fP"
تغییر نام تمامی فایل‌های متداخل با الحاق پسوندی شامل زبان فایل، معماری آن، مؤلفه مربوطه و/یا یک عدد برای یکتا کردن نام فایل. این پسوند کامل هم به فایل‌هایی که با عمل "\fBoverwrite\fP" بازنویسی می‌شدند و هم به فایل‌هایی که سایر فایل‌ها را بازنویسی می‌کردند، اضافه می‌شود.
.TP
"\fBerror\fP"
هنگام تشخیص تداخل، برنامه با خطا خارج شود.
.RE
.IP
.B قوانین تغییر نام:
.PP
۱. اگر \fBمؤلفه (component)\fP برای همه فایل‌های مجموعه تداخل (همه فایل‌های با نام یکسان) یکسان نباشد، علامت "\fB#\fP" به همراه شناسه مؤلفه به انتهای نام تمام فایل‌های متعلق به یک مؤلفه خاص اضافه می‌شود.
.PP
۲. اگر \fBزبان (language)\fP برای همه فایل‌های مجموعه تداخل یکسان نباشد، علامت "\fB@\fP" به همراه شناسه زبان به انتهای تمام فایل‌های مربوط به یک زبان خاص اضافه می‌شود؛ مگر آنکه آن زبان با زبان پیش‌فرض تعیین‌شده توسط \fB--default-language\fP مطابقت داشته باشد. اگرچه این پسوند برای زبان پیش‌فرض حذف می‌شود، اما هیچ پسوند عددی جایگزین آن نخواهد شد مگر اینکه برای یکتا کردن نام فایل لازم باشد.
.PP
۳. اگر \fBمعماری (architecture)\fP برای تمام فایل‌های مجموعه تداخل یکسان نباشد، "\fB@32bit\fP" یا "\fB@64bit\fP" به انتهای تمام فایل‌های مربوط به یک معماری الحاق می‌شود.
.PP
۴. اگر هیچ پسوندی در مراحل قبلی اضافه نشد، یا اگر نام فایل همچنان یکتا نیست، علامت "\fB$\fP" به همراه کوچک‌ترین عدد صحیح (شروع از ۰) که نام فایل را یکتا سازد اضافه خواهد شد.
.PP
با عمل "\fBrename\fP"، مراحل ۱ و ۳ تنها روی فایل‌هایی اعمال می‌شوند که قرار بود با عمل "\fBoverwrite\fP" بازنویسی شوند؛ در حالی که "\fBrename-all\fP" آن‌ها را روی تمامی فایل‌های مجموعه تداخل اعمال می‌کند.
.TP
\fB\-c\fP, \fB\-\-color\fP[=\fIENABLE\fP]
به‌طور پیش‌فرض
.B innoextract
تلاش می‌کند تشخیص دهد که آیا ترمینال از کدهای اسکیپ شل پشتیبانی می‌کند یا خیر و خروجی رنگی را متناسب با آن فعال یا غیرفعال می‌سازد. به طور خاص، اگر هر دو \fBstdout\fP و \fBstderr\fP به یک TTY اشاره کنند، متغیر محیطی \fBTERM\fP برابر با "\fBdumb\fP" نباشد و متغیر محیطی \fBNO_COLOR\fP تنظیم نشده باشد، رنگ‌ها فعال خواهند شد. برای اجبار به استفاده از خروجی رنگی، مقدار \fB1\fP یا \fBtrue\fP را به \fB\-\-color\fP بدهید. برای عدم نمایش کدهای رنگی، مقدار \fB0\fP یا \fBfalse\fP را پاس دهید.
.TP
\fB\-V\fP, \fB\-\-data\-version\fP
چاپ نسخه داده Inno Setup برای نصاب و خروج فوری.
.PP
نسخه چاپ‌شده با این گزینه همان مقداری است که در فایل نصب ذخیره شده و ممکن است با نسخه چاپ‌شده در سایر عملیات‌ها متفاوت باشد، زیرا نسخه داده ذخیره‌شده همیشه دقیق نیست.
.PP
از این گزینه می‌توان برای تشخیص اینکه آیا یک فایل نصاب Inno Setup است یا خیر، بدون بارگذاری هدرهای فشرده‌شده استفاده کرد.
.PP
این گزینه نمی‌تواند با هیچ عملیات دیگری ترکیب شود.
.TP
\fB\-\-default\-language\fP \fILANG\fP
تنظیم یک زبان به عنوان زبان پیش‌فرض.
.PP
همراه با \fB\-\-collisions=overwrite\fP (حالت پیش‌فرض)، این گزینه انتخاب فایل برای نگهداری را به گونه‌ای تغییر می‌دهد که همیشه زبان ارائه‌شده را ترجیح دهد. در عمل، عملکرد \fB\-\-default\-language\fP تقریباً مشابه \fB\-\-language\fP است، با این تفاوت که فایل‌های مربوط به تمام زبان‌ها در صورتی که نام‌های متفاوتی داشته باشند استخراج می‌شوند.
.PP
هنگام استفاده از گزینه \fB\-\-collisions=rename\fP، گزینه \fB\-\-default\-language\fP زبانی را انتخاب می‌کند که فایل‌های آن در صورت امکان نام اصلی خود را حفظ کنند.
.TP
\fB\-\-dump\fP
عدم تبدیل مسیرهای ویندوز به مسیرهای یونیکس و عدم جایگزینی ثابت‌ها در مسیرها.
.PP
هنگام ترکیب \fB\-\-dump\fP با \fB\-\-extract\fP، برنامه innoextract تضمین \fIنمی‌کند\fP که مسیرها به خارج از دایرکتوری مقصد اشاره نکنند. هنگام کار با فایل‌های غیرقابل اعتماد با احتیاط از این گزینه استفاده کنید.
.TP
\fB\-m\fP, \fB\-\-exclude\-temp\fP
عدم استخراج فایل‌هایی که قرار بوده در پایان فرآیند نصب حذف شوند. این فایل‌ها در فهرست فایل‌ها با [temp] مشخص شده‌اند.
.PP
این گزینه نسبت به \fB\-\-include\fP و \fB\-\-language\fP اولویت دارد: فایل‌های موقت هنگام استفاده از \fB\-\-exclude\-temp\fP هرگز استخراج نمی‌شوند، حتی اگر با زبان انتخاب‌شده یا عبارات include مطابقت داشته باشند.
.TP
\fB\-e\fP, \fB\-\-extract\fP
استخراج تمام فایل‌ها در دایرکتوری جاری. این عملیات به طور پیش‌فرض فعال است، مگر اینکه یک یا چند مورد از عملیات‌های \fB\-\-list\fP، \fB\-\-list\-sizes\fP، \fB\-\-list\-checksums\fP، \fB\-\-test\fP، \fB\-\-list\-languages\fP، \fB\-\-gog\-game\-id\fP، \fB\-\-show\-password\fP یا \fB\-\-check\-password\fP مشخص شده باشند.
.PP
به طور پیش‌فرض innoextract پس از مواجهه با خطاهای چکسام فایل ادامه می‌دهد. گزینه \fB\-\-extract\fP می‌تواند با \fB\-\-test\fP ترکیب شود تا در صورت خطای چکسام متوقف گردد.
.TP
\fB\-n\fP, \fB\-\-no\-extract\-unknown\fP
به طور پیش‌فرض innoextract سعی می‌کند نصاب‌هایی با نسخه داده ناشناخته Inno Setup را با در نظر گرفتن نزدیک‌ترین نسخه شناخته‌شده استخراج کند. این گزینه به innoextract دستور می‌دهد که در این شرایط متوقف شود.
.TP
\fB\-g\fP, \fB\-\-gog\fP
تلاش برای پردازش فایل‌های اضافی \fI.bin\fP که نام پایه مشابه نصاب دارند اما در واقع بخشی از نصاب Inno Setup نیستند. این مورد در نصاب‌های چندبخشی جدیدتر GOG.com دیده می‌شود که در آن‌ها این فایل‌های \fI.bin\fP آرشیوهای RAR هستند و احتمالاً با چکسام MD5 شناسه بازی رمزنگاری شده‌اند (گزینه \fB\-\-gog\-game\-id\fP را ببینید).
.PP
استخراج این آرشیوهای RAR نیازمند در دسترس بودن ابزارهای خط فرمان rar، unrar یا lsar/unar در PATH سیستم است.
.PP
گزینه‌های \fB\-\-list\fP، \fB\-\-test\fP، \fB\-\-extract\fP و \fB\-\-output\-dir\fP به unrar/unar منتقل می‌شوند، اما سایر گزینه‌ها ممکن است برای فایل‌های RAR نادیده گرفته شوند. برای آرشیوهای چندبخشی RAR، گزینه \fB\-\-test\fP نیازمند یک دایرکتوری خروجی قابل نوشتن برای فایل‌های موقت است که می‌تواند با گزینه \fB\-\-output\-dir\fP مشخص شود. اگر دایرکتوری خروجی وجود نداشته باشد، ایجاد شده و پس از پایان تست حذف خواهد شد. دایرکتوری‌های والد ایجاد نمی‌شوند. فایل‌های موقت ایجادشده در داخل دایرکتوری همیشه حذف می‌شوند.
.PP
توجه داشته باشید که این گزینه مختص نصاب‌های GOG.com طراحی شده است. سایر نصاب‌ها ممکن است همراه با فایل‌های \fI.bin\fP متفرقه دیگری ارائه شوند که این گزینه قادر به مدیریت آن‌ها نباشد.
.PP
این گزینه همچنین اتصال مجدد قطعات فایل GOG Galaxy را اجباری می‌کند. برای جزئیات به گزینه \fB\-\-no\-gog\-galaxy\fP مراجعه کنید.
.TP
\fB\-\-no\-gog\-galaxy\fP
برخی از نصاب‌های GOG.com حاوی فایل‌هایی در قالب GOG Galaxy هستند (تقسیم‌شده به چند بخش که هر کدام جداگانه فشرده شده‌اند) و با استفاده از اسکریپت‌های پس از نصب دوباره سرهم می‌شوند. به طور پیش‌فرض \fBinnoextract\fP در صورت تشخیص نصاب GOG.com تلاش می‌کند چنین فایل‌هایی را سرهم کند. این گزینه آن قابلیت را غیرفعال می‌سازد.
.PP
نصاب‌های GOG.com با استفاده از فیلدهای ناشر و URL در هدرهای نصاب شناسایی می‌شوند. از گزینه \fB\-\-gog\fP برای اجبار به سرهم‌سازی قطعات در تمامی نصاب‌ها استفاده کنید.
.TP
\fB\-\-gog\-game\-id\fP
تشخیص شناسه‌ای که GOG.com برای بازی موجود در این نصاب استفاده می‌کند. این ویژگی تنها با نصاب‌های سازگار با Galaxy کار می‌کند.
.PP
این گزینه می‌تواند با \fB\-\-silent\fP ترکیب شود تا تنها شناسه بازی بدون سینتکس‌های اضافی چاپ شود تا استفاده از آن در اسکریپت‌های دیگر آسان‌تر باشد.
.PP
عملیات \fB\-\-gog\-game\-id\fP می‌تواند با \fB\-\-list\fP، \fB\-\-test\fP، \fB\-\-extract\fP و/یا \fB\-\-list\-languages\fP ترکیب شود. اگر \fB\-\-silent\fP و \fB\-\-gog\-game\-id\fP با \fB\-\-list\fP و/یا \fB\-\-list\-languages\fP ترکیب شوند، شناسه بازی (یا یک خط خالی) در خطی جداگانه قبل از فهرست فایل‌ها اما بعد از فهرست زبان‌ها چاپ می‌شود.
.PP
برای نصاب‌های چندبخشی جدیدتر GOG.com، فایل‌های \fI.bin\fP بخشی از نصاب Inno Setup نیستند بلکه آرشیوهای RAR هستند. برخی از این فایل‌های RAR رمزنگاری شده‌اند و رمز عبور آن‌ها همان چکسام MD5 شناسه بازی است:
.IP
\fBinnoextract \-\-gog\-game\-id --silent\fP \fIsetup_....exe\fP | \fBmd5sum\fP | \fBcut \-d\fP ' ' \fB\-f\fP 1
.TP
\fB\-h\fP, \fB\-\-help\fP
نمایش فهرستی از گزینه‌های پشتیبانی‌شده.
.TP
\fB\-I\fP, \fB\-\-include\fP \fIEXPR\fP
اگر این گزینه مشخص شود، innoextract تنها فایل‌هایی را پردازش می‌کند که مسیر آن‌ها با \fIEXPR\fP مطابقت داشته باشد. عبارت می‌تواند یک جزء منفرد از مسیر (نام فایل یا دایرکتوری) یا مجموعه‌ای از اجزای متوالی مسیر باشد که با جداکننده مسیر سیستم‌عامل (\\ در ویندوز، / در پلتفرم‌های دیگر) به هم متصل شده‌اند.
.PP
عبارت همیشه با یک یا چند جزء کامل مسیر مطابقت داده می‌شود. فیلتر کردن بر اساس بخش‌هایی از نام فایل در حال حاضر پشتیبانی نمی‌شود. مطابقت به صورت غیرحساس به حروف کوچک و بزرگ انجام می‌شود.
.PP
عبارت \fIEXPR\fP می‌تواند شامل یک جداکننده مسیر در ابتدا باشد که در این حالت بقیه عبارت با ابتدای مسیر مقایسه می‌شود. در غیر این صورت، عبارت با هر بخشی از مسیر مطابقت داده خواهد شد.
.PP
گزینه \fB\-\-include\fP می‌تواند چندین بار تکرار شود تا امکان مطابقت فایل‌ها با یکی از چندین الگو فراهم شود. اگر \fB\-\-include\fP استفاده نشود، تمام فایل‌ها پردازش می‌شوند.
.TP
\fB\-i\fP, \fB\-\-info\fP
این یک گزینه کاربردی برای فعال کردن تمام عملیات‌هایی است که اطلاعات مربوط به نصاب را چاپ می‌کنند.
.PP
اسکریپت‌ها نباید به فرمت خروجی این گزینه وابسته باشند و باید به جای آن عملیات‌های جداگانه را فعال کنند.
.PP
در حال حاضر این گزینه موارد \fB\-\-list\-languages\fP، \fB\-\-gog\-game\-id\fP و \fB\-\-show\-password\fP را فعال می‌کند.
.TP
\fB\-\-language\fP \fILANG\fP
استخراج تنها فایل‌های مستقل از زبان و فایل‌های مربوط به زبان ارائه‌شده. به طور پیش‌فرض تمام فایل‌ها استخراج می‌شوند.
.PP
برای صرف‌نظر کردن از فایل‌های مستقل از زبان نیز، این گزینه را با \fB\-\-language\-only\fP ترکیب کنید.
.TP
\fB\-\-language\-only\fP
تنها فایل‌هایی را استخراج می‌کند که مختص زبان خاصی هستند.
.PP
این گزینه می‌تواند با \fB\-\-language\fP ترکیب شود تا تنها فایل‌های یک زبان مشخص استخراج شوند.
.TP
\fB\-\-license\fP
نمایش اطلاعات مجوز برنامه.
.TP
\fB\-l\fP, \fB\-\-list\fP
فهرست کردن فایل‌های موجود در نصاب بدون استخراج آن‌ها.
.PP
این عملیات همچنین عملیات \fB\-\-list\-sizes\fP را فعال می‌کند مگر آنکه \fB\-\-quiet\fP یا \fB\-\-silent\fP مشخص شده باشد.
.PP
این گزینه می‌تواند با \fB\-\-silent\fP ترکیب شود تا تنها نام فایل‌های موجود (هر کدام در یک خط) بدون سینتکس اضافی چاپ شود تا استفاده در سایر اسکریپت‌ها آسان‌تر باشد.
.PP
عملیات \fB\-\-list\fP می‌تواند با \fB\-\-test\fP، \fB\-\-extract\fP، \fB\-\-list\-languages\fP و/یا \fB\-\-gog\-game\-id\fP ترکیب شود تا نام فایل‌ها هنگام استخراج، حتی با وجود \fB\-\-silent\fP، نمایش داده شود.
.TP
\fB\-\-list\-checksums\fP
فهرست کردن چکسام فایل‌های موجود در نصاب.
.PP
این گزینه شامل عملیات \fB\-\-list\fP نیز می‌شود و می‌تواند با گزینه \fB\-\-list\-sizes\fP ترکیب شود تا هم اندازه و هم چکسام هر فایل چاپ شود.
.PP
با گزینه \fB\-\-silent\fP، چکسام فایل در ابتدای خط (اما بعد از اندازه فایل در صورت فعال بودن گزینه \fB\-\-list\-sizes\fP) و به دنبال آن یک فاصله چاپ خواهد شد. در غیر این صورت چکسام بعد از نام فایل چاپ می‌شود.
.PP
نوع چکسام می‌تواند یکی از مقادیر \fBAdler32\fP، \fBCRC32\fP، \fBMD5\fP یا \fBSHA-1\fP باشد و قبل از هش چکسام به همراه یک فاصله چاپ می‌شود. چکسام‌های \fBAdler32\fP و \fBCRC32\fP به صورت "\fB0x\fP" و به دنبال آن مقدار هگزادسیمال ۳۲ بیتی چاپ می‌شوند.
.PP
اگر سرهم‌بندی مجدد قطعات فایل GOG Galaxy با گزینه \fB\-\-no\-gog\-galaxy\fP غیرفعال نشده باشد، فایل‌های مختلف در همان نصاب می‌توانند انواع چکسام متفاوتی داشته باشند.
.TP
\fB\-\-list\-languages\fP
فهرست کردن زبان‌های پشتیبانی‌شده توسط نصاب.
.PP
این گزینه می‌تواند با \fB\-\-silent\fP ترکیب شود تا تنها شناسه‌های زبان‌ها (هر کدام در یک خط) و به دنبال آن یک فاصله و سپس نام زبان بدون سینتکس‌های اضافی چاپ شود تا پردازش آن در سایر اسکریپت‌ها راحت‌تر باشد.
.PP
عملیات \fB\-\-list\-languages\fP می‌تواند با \fB\-\-list\fP، \fB\-\-test\fP، \fB\-\-extract\fP و/یا \fB\-\-gog\-game\-id\fP ترکیب شود تا زبان‌های موجود قبل از انجام هر کار دیگری نمایش داده شوند. اگر \fB\-\-silent\fP و \fB\-\-list\-languages\fP با \fB\-\-list\fP و/یا \fB\-\-gog\-game\-id\fP ترکیب شوند، فهرست زبان‌ها با یک خط خالی خاتمه می‌یابد و پیش از شناسه بازی و فهرست فایل‌ها قرار خواهد گرفت.
.TP
\fB\-\-list\-sizes\fP
فهرست کردن اندازه غیرفشرده فایل‌های موجود در نصاب.
.PP
این گزینه شامل عملیات \fB\-\-list\fP نیز می‌شود و می‌تواند با گزینه \fB\-\-list\-checksums\fP ترکیب شود تا هم اندازه و هم چکسام هر فایل چاپ شود.
.PP
همراه با \fB\-\-silent\fP اندازه فایل بر حسب بایت در ابتدای خط و به دنبال آن یک فاصله چاپ می‌شود. در غیر این صورت، اندازه پس از نام فایل در قالبی خوانا برای انسان چاپ می‌گردد.
.TP
\fB\-L\fP, \fB\-\-lowercase\fP
تبدیل نام فایل‌های ذخیره‌شده در نصاب به حروف کوچک پیش از استخراج.
.TP
\fB\-d\fP, \fB\-\-output\-dir\fP \fIDIR\fP
استخراج تمام فایل‌ها در دایرکتوری مشخص‌شده. به طور پیش‌فرض، \fBinnoextract\fP تمام فایل‌ها را در دایرکتوری جاری استخراج می‌کند.
.PP
اگر دایرکتوری مشخص‌شده وجود نداشته باشد، ایجاد خواهد شد. با این حال، دایرکتوری والد باید از قبل وجود داشته باشد وگرنه استخراج با شکست مواجه می‌شود.
.TP
\fB\-P\fP, \fB\-\-password\fP \fIPASSWORD\fP
تعیین رمز عبور برای رمزگشایی فایل‌های رمزنگاری‌شده. فرض می‌شود رمز عبور به صورت UTF-8 کدگذاری شده و در صورت نیاز به کدگذاری داخلی مورد استفاده در نصاب تبدیل می‌شود.
.PP
از گزینه \fB\-\-password-file\fP برای بارگذاری رمز عبور از یک فایل یا ورودی استاندارد استفاده کنید. این گزینه نمی‌تواند با \fB\-\-password-file\fP ترکیب شود.
.PP
اگر این رمز عبور با چکسام ذخیره‌شده در نصاب مطابقت نداشته باشد، از فایل‌های رمزنگاری‌شده صرف‌نظر می‌شود اما فایل‌های رمزنگاری‌نشده همچنان استخراج خواهند شد. از گزینه \fB\-\-check\-password\fP برای توقف کامل پردازش در صورت نادرست بودن رمز عبور استفاده کنید.
.TP
\fB\-\-password-file\fP \fIFILE\fP
بارگذاری رمز عبور از فایل مشخص‌شده. تنها خط اول (به استثنای کاراکترهای پایان خط / شکست خط) به عنوان رمز عبور استفاده می‌شود. فرض می‌شود رمز عبور به صورت UTF-8 کدگذاری شده و در صورت نیاز به کدگذاری داخلی مورد استفاده در نصاب تبدیل می‌شود.
.PP
اگر از نام فایل ویژه "\fB-\fP" استفاده شود، رمز عبور از ورودی استاندارد خوانده خواهد شد.
.PP
از گزینه \fB\-\-password\fP برای تعیین رمز عبور در خط فرمان استفاده کنید. این گزینه نمی‌تواند با \fB\-\-password\fP ترکیب شود.
.PP
اگر این رمز عبور با چکسام ذخیره‌شده در نصاب مطابقت نداشته باشد، از فایل‌های رمزنگاری‌شده صرف‌نظر می‌شود اما فایل‌های رمزنگاری‌نشده همچنان استخراج خواهند شد. از گزینه \fB\-\-check\-password\fP برای توقف کامل پردازش در صورت نادرست بودن رمز عبور استفاده کنید.
.TP
\fB\-p\fP, \fB\-\-progress\fP[=\fIENABLE\fP]
به طور پیش‌فرض \fBinnoextract\fP تلاش می‌کند تشخیص دهد که آیا ترمینال از کدهای اسکیپ شل پشتیبانی می‌کند یا خیر و نوار پیشرفت را متناسب با آن فعال یا غیرفعال می‌سازد. مقدار \fB1\fP یا \fBtrue\fP را به \fB\-\-progress\fP بدهید تا نوار پیشرفت به اجبار نمایش داده شود. مقدار \fB0\fP یا \fBfalse\fP را بدهید تا نوار پیشرفت هرگز نمایش داده نشود.
.TP
\fB\-q\fP, \fB\-\-quiet\fP
خروجی با جزئیات کمتر.
.TP
\fB\-\-show\-password\fP
نمایش چکسام \fB$c\fP و سالت \fB$s\fP مورد استفاده برای بررسی رمز عبور \fB$p\fP و همچنین کدگذاری رمز عبور. چکسام از چسباندن سالت با رمز عبور محاسبه می‌شود:
.PP
 \fB$c = hash($s . $p)\fP
.PP
با گزینه \fB\-\-silent\fP، نام چکسام و مقدار هش در یک خط با یک فاصله چاپ می‌شوند و سپس سالت به صورت بایت‌های هگزادسیمال و کدگذاری رمز عبور در خطوط جداگانه نمایش داده خواهند شد.
.PP
انواع چکسام می‌توانند \fBCRC32\fP، \fBMD5\fP یا \fBSHA-1\fP باشند، اگرچه از \fBCRC32\fP در نصاب‌های دارای رمزنگاری استفاده نمی‌شود.
.PP
از گزینه \fB\-\-password\fP یا \fB\-\-password\-file\fP همراه با \fB\-\-check\-password\fP برای بررسی مطابقت رمز عبور با این چکسام استفاده کنید.
.TP
\fB\-s\fP, \fB\-\-silent\fP
عدم چاپ هیچ خروجی به جز خطاها و هشدارها مگر اینکه صریحاً درخواست شده باشد، و استفاده از فرمت خروجی ماشین‌خوان.
.PP
این گزینه می‌تواند با \fB\-\-list\fP ترکیب شود تا تنها نام فایل‌های موجود (هر کدام در یک خط) بدون سینتکس‌های اضافی چاپ شود تا استفاده در سایر اسکریپت‌ها آسان‌تر باشد.
.TP
\fB\-t\fP, \fB\-\-test\fP
آزمایش یکپارچگی آرشیو بدون نوشتن هیچ فایل خروجی.
.PP
این گزینه می‌تواند با \fB\-\-extract\fP ترکیب شود تا در صورت بروز خطای چکسام فایل متوقف شود.
.TP
\fB\-T\fP, \fB\-\-timestamps\fP \fITZ\fP
نصاب‌های Inno Setup می‌توانند حاوی مهرهای زمانی در هر دو منطقه زمانی UTC و منطقه زمانی محلی باشند.
.PP
گزینه \fB\-\-timestamps\fP مشخص می‌کند که چه منطقه زمانی باید برای تنظیم زمان این فایل‌های محلی استفاده شود.
.PP
مقادیر معتبر همان مواردی هستند که توسط \fBtzset\fP در متغیر محیطی \fBTZ\fP پذیرفته می‌شوند، به جز اینکه جهت آفست زمانی معکوس است: هر دو مقدار \fB\-T CET\fP و \fB\-T GMT+1\fP (هنگامی که ساعت تابستانی فعال است) نتیجه یکسانی خواهند داد.
.PP
علاوه بر مناطق زمانی، دو مقدار ویژه نیز پذیرفته می‌شوند:
.RS
.HP
"\fBnone\fP"
عدم حفظ زمان فایل‌ها برای فایل‌های استخراج‌شده، چه برای مهرهای زمانی UTC و چه محلی. زمان فایل‌ها همان‌گونه که سیستم‌عامل هنگام ایجاد فایل‌های خروجی تنظیم کرده باقی خواهد ماند.
.HP
"\fBlocal\fP"
استفاده از منطقه زمانی سیستم برای مهرهای زمانی محلی. این رفتار عادی Inno Setup است و می‌تواند همراه با متغیر محیطی \fBTZ\fP استفاده شود.
.RE
.IP
مقدار پیش‌فرض این گزینه \fBUTC\fP است که باعث می‌شود innoextract زمان فایل‌های محلی را دستکاری نکند. زمان فایل‌هایی که در فایل Inno Setup با برچسب UTC مشخص شده‌اند، صرف نظر از تنظیمات \fB\-\-timestamps\fP هرگز تغییر نخواهند کرد.
.TP
\fB\-v\fP, \fB\-\-version\fP
چاپ شماره نسخه \fBinnoextract\fP و نسخه‌های پشتیبانی‌شده از Inno Setup.
.PP
اگر با گزینه \fB\-\-silent\fP ترکیب شود، تنها شماره نسخه چاپ می‌شود. در غیر این صورت، خروجی شامل نام (innoextract) و به دنبال آن شماره نسخه در خط اول خواهد بود و مگر اینکه گزینه \fB\-\-quiet\fP مشخص شده باشد، دامنه نسخه‌های پشتیبانی‌شده نصاب Inno Setup در خط دوم نمایش داده می‌شود.
.TP
\fB\-\-no\-warn\-unused\fP
به طور پیش‌فرض، innoextract در صورت مواجهه با فایل‌های \fI.bin\fP که به نظر می‌رسد ممکن است بخشی از نصاب باشند اما استفاده نشده‌اند، یک هشدار چاپ می‌کند. این گزینه آن هشدار را غیرفعال می‌سازد.
.SH "ثابت‌های مسیر (PATH CONSTANTS)"
مسیرها در نصاب‌های Inno Setup می‌توانند حاوی ثابت‌هایی (ارجاعات به متغیرها یا کدها) باشند که در زمان نصب بسط داده می‌شوند. ابزار innoextract تمامی این ثابت‌ها را به نام آن‌ها بسط می‌دهد و کاراکترهای ناامن را با \fB$\fP جایگزین می‌کند. به عنوان مثال \fB{app}\fP به \fBapp\fP بسط می‌یابد، در حالی که \fB{code:Example}\fP به \fBcode$Example\fP بسط داده می‌شود.
.PP
در حال حاضر هیچ راهی برای پیکربندی این بسط به جز غیرفعال کردن آن با گزینه \fB\-\-dump\fP وجود ندارد.
.SH "کدهای خروج (EXIT VALUES)"
.PP
.IP \fB0\fP
موفقیت‌آمیز
.IP \fB1\fP
خطای نحو (سینتکس) یا نحوه استفاده
.IP \fB2+\fP
فایل نصاب خراب یا پشتیبانی‌نشده، یا خطای ورودی/خروجی
.SH "محدودیت‌ها (LIMITATIONS)"
هیچ پشتیبانی برای استخراج مؤلفه‌های منفرد وجود ندارد و پشتیبانی محدودی برای فیلتر کردن بر اساس نام موجود است.
.PP
اسکریپت‌ها و بررسی‌های همراه بسته نصبی اجرا نمی‌شوند.
.PP
نگاشت ثابت‌های Inno Setup مانند دایرکتوری برنامه به زیردایرکتوری‌ها به صورت درون‌کد (hard-coded) است.
.PP
نام‌های مربوط به قطعات داده / فایل‌های دیسک در نصاب‌های چندفایلی باید از الگوی نام‌گذاری استاندارد پیروی کنند.
.SH "همچنین ببینید (SEE ALSO)"
\fBcabextract\fP(1), \fBunar\fP(1), \fBunrar\fP(1), \fBunshield\fP(1), \fBtzset\fP(3)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.PP
لطفاً خطاها را در
<https://innoextract.constexpr.org/issues>
گزارش دهید.
.SH "قدردانی و اعتبارات (CREDITS)"
.PP
ابزار
\fBinnoextract\fP
تحت مجوز zlib/libpng توزیع شده است. برای جزئیات به فایل LICENSE مراجعه فرمایید.
.PP
وب‌سایت پروژه در
<https://constexpr.org/innoextract>
در دسترس است.
.PP
این برنامه از کتابخانه عالی فشرده‌سازی و رفع‌فشرده‌سازی lzma/xz نوشته‌شده توسط Lasse Collin استفاده می‌کند.
.SH "نویسندگان (AUTHORS)"
Daniel Scharrer <daniel@constexpr.org>