.TH WIMOPTIMIZE "1" "January 2026" "wimlib 1.14.5" "User Commands"
.SH "نام (NAME)"
wimoptimize \- بهینه‌سازی یک بایگانی WIM
.SH "خلاصه دستور (SYNOPSIS)"
\fBwimoptimize\fR \fIWIMFILE\fR [\fIOPTION\fR...]
.SH "توضیحات (DESCRIPTION)"
دستور \fBwimoptimize\fR یا معادل آن \fBwimlib-imagex optimize\fR، آرشیو مستقل WIM
با نام \fIWIMFILE\fR را بازسازی می‌کند. فایل WIM جدید در یک فایل موقت نوشته شده
و پس از آماده شدن، به نام فایل اصلی تغییر نام می‌یابد. این کار تمام فضاهای خالی و
حفره‌هایی را که در نتیجهٔ افزودن یا حذف فایل‌ها یا ایمیج‌ها در WIM باقی مانده است حذف
می‌کند، بنابراین WIM جدید ممکن است از WIM قدیمی کوچک‌تر باشد.
.PP
به‌طور پیش‌فرض، \fBwimoptimize\fR از داده‌های فشرده‌شده استفاده مجدد می‌کند (آن‌ها را
دوباره فشرده نمی‌کند) و وضعیت solid یا pipable فایل WIM را تغییر نمی‌دهد.
با این حال، می‌تواند عمل فشرده‌سازی مجدد را انجام دهد و/یا تبدیل بین WIMهای
حالت solid ،non-solid ،pipable و non-pipable را انجام دهد؛ گزینه‌ها و مثال‌های زیر را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.TP 6
\fB--check\fR
پیش از بهینه‌سازی WIM، در صورتی که حاوی اطلاعات یکپارچگی اضافی باشد، صحت و یکپارچگی آن را
بررسی می‌کند. همچنین اطلاعات یکپارچگی اضافی را در WIM بهینه‌شده قرار می‌دهد،
حتی اگر قبلاً وجود نداشته باشد.
.TP
\fB--nocheck\fR
اطلاعات یکپارچگی اضافی را در WIM بهینه‌شده قرار نمی‌دهد، حتی اگر قبلاً وجود داشته باشد.
.TP
\fB--include-integrity\fR
اطلاعات یکپارچگی اضافی را در WIM بهینه‌شده قرار می‌دهد؛ یعنی مانند
\fB--check\fR عمل می‌کند اما WIM را پیش از آن اعتبارسنجی نمی‌کند.
.TP
\fB--recompress\fR
تمامی داده‌های درون WIM را هنگام بهینه‌سازی دوباره فشرده می‌کند. این کار زمان مورد نیاز
برای بهینه‌سازی WIM را به‌طور چشمگیری افزایش می‌دهد، اما در صورتی که wimlib بتواند
فشرده‌سازی بهتری نسبت به برنامهٔ سازندهٔ WIM انجام دهد، ممکن است نسبت فشرده‌سازی
بهتری حاصل شود --- امری که اگر WIM توسط مایکروسافت ایجاد شده باشد محتمل است،
زیرا فشرده‌سازهای wimlib تا حدی قوی‌تر هستند.
.TP
\fB--compress\fR=\fITYPE\fR[:\fILEVEL\fR]
آرشیو WIM را با نوع فشرده‌سازی مشخص‌شده و در صورت تمایل، سطح فشرده‌سازی تعیین‌شده
برای آن نوع، دوباره فشرده می‌کند. این گزینه به‌طور ضمنی \fB--recompress\fR را فعال
می‌کند. برای جزئیات بیشتر به مستندات این گزینه در \fBwimcapture\fR(1) مراجعه کنید.
.TP
\fB--chunk-size\fR=\fISIZE\fR
اندازه تکه‌های فشرده‌سازی WIM را روی \fISIZE\fR تنظیم می‌کند. برای جزئیات بیشتر به
مستندات این گزینه در \fBwimcapture\fR(1) مراجعه کنید.
.TP
\fB--solid\fR
یک بایگانی یکپارچه ("solid") ایجاد می‌کند که چندین فایل را با هم فشرده می‌سازد. این کار معمولاً
منجر به نسبت فشرده‌سازی بسیار بهتری می‌شود اما معایبی مانند کاهش سازگاری را به همراه دارد.
برای جزئیات بیشتر به مستندات این گزینه در \fBwimcapture\fR(1) مراجعه کنید.
.TP
\fB--solid-compress\fR=\fITYPE\fR[:\fILEVEL\fR]
مشابه \fB--compress\fR، اما نوع فشرده‌سازی مورد استفاده در منابع solid را تعیین می‌کند.
برای جزئیات بیشتر به مستندات این گزینه در \fBwimcapture\fR(1) مراجعه کنید.
.TP
\fB--solid-chunk-size\fR=\fISIZE\fR
مشابه \fB--chunk-size\fR، اما اندازه تکه‌ها را در منابع solid تعیین می‌کند. برای جزئیات بیشتر
به مستندات این گزینه در \fBwimcapture\fR(1) مراجعه کنید.
.TP
\fB--threads\fR=\fINUM_THREADS\fR
تعداد رشته‌ها (threads) برای استفاده در فشرده‌سازی داده‌ها. پیش‌فرض: تشخیص خودکار
(تعداد پردازنده‌ها).
.TP
\fB--pipable\fR
آرشیو WIM را به‌گونه‌ای بازسازی می‌کند که بتوان آن را به‌طور کامل و متوالی، از جمله از طریق
یک لوله (pipe)، اعمال کرد. برای جزئیات بیشتر درباره ایجاد WIMهای قابل انتقال از لوله به
\fBwimcapture\fR(1) مراجعه کنید. به‌طور پیش‌فرض، هنگامی که هیچ‌یک از گزینه‌های \fB--pipable\fR
یا \fB--not-pipable\fR مشخص نشده باشد، WIM بهینه‌شده تنها در صورتی pipable خواهد بود
که پیش از آن نیز pipable بوده باشد.
.TP
\fB--not-pipable\fR
آرشیو WIM را در قالب غیرقابل انتقال از طریق لوله (non-pipable) بازسازی می‌کند.
.TP
\fB--unsafe-compact\fR
آرشیو WIM را درجا و بدون استفاده از فایل موقت فشرده و جمع‌وجور می‌کند. منابع موجود به سمت
پایین جابه‌جا می‌شوند تا فضاهای خالی را پر کنند و منابع جدید در صورت نیاز ضمیمه می‌گردند.
اندازه WIM به اندازه نهایی آن کوتاه (truncate) می‌شود که ممکن است اندازه فایل را روی دیسک
کاهش دهد. این روش کارآمدتر از بازسازی کامل است، اما تنها در صورتی پشتیبانی می‌شود که
هیچ فشرده‌سازی مجددی انجام نشود. مهم‌تر از آن، یک عملیات فشرده‌سازی ناامن را نمی‌توان با ایمنی
متوقف کرد! اگر عملیات متوقف شود، WIM خراب خواهد شد و بازیابی هرگونه داده از آن ممکن است
غیرممکن (یا حداقل بسیار دشوار) باشد. از کاربران این گزینه انتظار می‌رود که بدانند چه کاری
انجام می‌دهند و مسئولیت هرگونه خرابی داده ناشی از آن را بپذیرند.
.SH "نکات (NOTES)"
دستور \fBwimoptimize\fR از WIMهای چندبخشی (split WIMs) یا WIMهای دلتا (delta WIMs) پشتیبانی نمی‌کند.
برای چنین فایل‌هایی، استفاده از \fBwimexport\fR(1) را مد نظر قرار دهید. توجه داشته باشید
که \fBwimoptimize\fR تقریباً معادل دستور زیر است:
.RS
.PP
\fBwimexport\fR \fIWIMFILE\fR all tmp.wim && mv tmp.wim \fIWIMFILE\fR
.RE
.PP
.SH "مثال‌ها (EXAMPLES)"
بازسازی 'install.wim':
.RS
.PP
wimoptimize install.wim
.RE
.PP
بازسازی و فشرده‌سازی مجدد 'install.wim':
.RS
.PP
wimoptimize install.wim --recompress
.RE
.PP
بازسازی و فشرده‌سازی مجدد 'install.wim' با استفاده از فشرده‌سازی LZX (حالت «حداکثر»)
در سطحی بالاتر از سطح پیش‌فرض. اندازه تکه‌های فشرده‌سازی بدون تغییر باقی می‌ماند.
اجرای این دستور کند خواهد بود، اما برای بهینه‌سازی فایل‌ها جهت توزیع می‌تواند سودمند باشد.
برای مشاهده برخی نتایج بنچمارک به \fIhttps://wimlib.net/compression.html\fR مراجعه کنید.
.RS
.PP
wimoptimize install.wim --compress=LZX:100
.RE
.PP
فشرده‌سازی مجدد 'install.wim' با استفاده از فشرده‌سازی حالت solid، و سپس تغییر نام آن به
\'install.esd\'. این کار اندازه بایگانی را به‌طور چشمگیری کاهش می‌دهد (همچنین استفاده از
'wimexport install.wim all install.esd --solid' را مد نظر داشته باشید):
.RS
.PP
wimoptimize install.wim --solid
.br
mv install.wim install.esd
.RE
.PP
تبدیل مجدد 'install.esd' به 'install.wim':
.RS
.PP
wimoptimize install.esd --compress=LZX
.br
mv install.esd install.wim
.RE
.SH "همچنین ببینید (SEE ALSO)"
.BR wimlib-imagex (1)
.BR wimexport (1)
.BR wimverify (1)