.TH WIMEXPORT "1" "January 2026" "wimlib 1.14.5" "User Commands"
.SH "نام (NAME)"
wimexport \- برون‌بری یک یا چند ایمیج از یک آرشیو WIM
.SH "خلاصه دستور (SYNOPSIS)"
\fBwimexport\fR \fISRC_WIMFILE\fR \fISRC_IMAGE\fR \fIDEST_WIMFILE\fR
 [\fIDEST_IMAGE_NAME\fR [\fIDEST_IMAGE_DESC\fR]] [\fIOPTION\fR...]
.SH "توضیحات (DESCRIPTION)"
دستور \fBwimexport\fR، یا به طور معادل \fBwimlib-imagex export\fR، ایمیج مشخص‌شده را از \fISRC_WIMFILE\fR به \fIDEST_WIMFILE\fR برون‌بری می‌کند و در صورت تمایل می‌تواند نام و/یا توضیحات ایمیج را تغییر دهد. اگر \fIDEST_WIMFILE\fR از قبل وجود داشته باشد، ایمیج به انتهای آن پیوست خواهد شد؛ در غیر این صورت، یک آرشیو WIM جدید برای در بر گرفتن ایمیج برون‌بری‌شده ایجاد می‌شود.
.PP
آرگومان \fISRC_IMAGE\fR مشخص‌کننده ایمیجی در \fISRC_WIMFILE\fR است که باید برون‌بری شود. این مقدار می‌تواند نمایه (index) مبتنی بر ۱ یک ایمیج، نام یک ایمیج، یا کلمه کلیدی "all" برای مشخص کردن تمامی ایمیج‌ها باشد. می‌توانید از \fBwiminfo\fR(1) برای فهرست کردن ایمیج‌های موجود در \fISRC_WIMFILE\fR استفاده کنید.
.PP
در صورت تعیین، \fIDEST_IMAGE_NAME\fR نامی است که به ایمیج در حال برون‌بری اختصاص می‌یابد. مقدار پیش‌فرض، نام آن در \fISRC_WIMFILE\fR است. اگر تعیین شود، \fIDEST_IMAGE_NAME\fR باید نامی باشد که از قبل در \fIDEST_WIMFILE\fR استفاده نشده است، یا یک رشته خالی باشد تا ایمیج بدون نام بماند. چنانچه "all" برای برون‌بری همه ایمیج‌ها تعیین شده باشد، نمی‌توان \fIDEST_IMAGE_NAME\fR را مشخص کرد.
.PP
در صورت تعیین، \fIDEST_IMAGE_DESC\fR توضیحاتی است که به ایمیج در حال برون‌بری اختصاص داده می‌شود. مقدار پیش‌فرض، توضیحات آن در \fISRC_WIMFILE\fR است.
.PP
دستور \fBwimexport\fR از برون‌بری ایمیج‌ها از WIMهای مستقل (stand-alone) و همچنین WIMهای چندبخشی (split) و WIMهای دلتا (delta) پشتیبانی می‌کند. بخش \fBWIMهای چندبخشی (SPLIT WIMS)\fR را ببینید.
.PP
همچنین \fBwimexport\fR از برون‌بری ایمیج‌ها از یک WIM غیرقابل‌انتقال با لوله (non-pipable) به یک WIM لوله‌پذیر (pipable) یا برعکس، یا از یک WIM غیریکپارچه (non-solid) به یک WIM یکپارچه (solid) یا برعکس پشتیبانی می‌کند. همچنین در صورتی که \fIDEST_WIMFILE\fR به عنوان "-" مشخص شده باشد، می‌تواند یک WIM لوله‌پذیر را مستقیماً به خروجی استاندارد برون‌بری کند؛ گزینه \fB--pipable\fR را ببینید.
.PP
.SH "گزینه‌ها (OPTIONS)"
.TP 6
\fB--boot\fR
ایمیج برون‌بری‌شده را به عنوان ایمیج "بوت‌پذیر" (bootable) فایل WIM علامت‌گذاری می‌کند؛ یا اگر چندین ایمیج در حال برون‌بری باشند، ایمیجی را که ایمیج بوت‌پذیر WIM مبدأ بوده است، به ایمیج بوت‌پذیر WIM مقصد نیز تبدیل می‌کند.
.TP
\fB--check\fR
پیش از برون‌بری ایمیج(ها)، در صورتی که اطلاعات یکپارچگی اضافی در WIM مبدأ، WIM مقصد و هر WIM ارجاع‌شده دیگری موجود باشد، صحت و یکپارچگی آن‌ها را بررسی می‌کند. همچنین اطلاعات یکپارچگی اضافه را در WIM مقصد درج می‌کند، حتی اگر قبلاً در آن وجود نداشته باشد.
.TP
\fB--nocheck\fR
اطلاعات یکپارچگی اضافه را در WIM مقصد قرار نمی‌دهد، حتی اگر قبلاً وجود داشته باشد.
.TP
\fB--include-integrity\fR
اطلاعات یکپارچگی اضافه را در WIM مقصد می‌گنجاند، یعنی مانند \fB--check\fR عمل می‌کند اما هیچ راستی‌آزمایی را از پیش انجام نمی‌دهد.
.TP
\fB--compress\fR=\fITYPE\fR[:\fILEVEL\fR]
نوع فشرده‌سازی و در صورت تمایل، سطح فشرده‌سازی را برای آن نوع، در \fIDEST_WIMFILE\fR مشخص می‌کند. توجه داشته باشید که اگر \fIDEST_WIMFILE\fR از قبل وجود داشته باشد، نوع فشرده‌سازی آن با این گزینه قابل تغییر نیست. برای جزئیات بیشتر مستندات مربوط به این گزینه را در \fBwimcapture\fR(1) ببینید.
.TP
\fB--chunk-size\fR=\fISIZE\fR
اندازه تکه‌های (chunk size) فشرده‌سازی WIM را بر روی \fISIZE\fR تنظیم می‌کند. برای جزئیات بیشتر مستندات مربوط به این گزینه را در \fBwimcapture\fR(1) ببینید.
.TP
\fB--recompress\fR
فشرده‌سازی مجدد تمام داده‌های برون‌بری‌شده را اجباری می‌کند، حتی اگر WIM مقصد از همان نوع فشرده‌سازی WIM مبدأ استفاده کند.
.TP
\fB--solid\fR
یک آرشیو "یکپارچه" (solid) ایجاد می‌کند که چندین فایل را با هم فشرده می‌سازد. این کار معمولاً به نسبت فشرده‌سازی به مراتب بهتری می‌انجامد، اما معایبی از جمله کاهش سازگاری به همراه دارد. برای جزئیات بیشتر مستندات مربوط به این گزینه را در \fBwimcapture\fR(1) ببینید.
.TP
\fB--solid-compress\fR=\fITYPE\fR[:\fILEVEL\fR]
مشابه \fB--compress\fR است، اما نوع فشرده‌سازی مورد استفاده در منابع یکپارچه (solid resources) را تعیین می‌کند. برای جزئیات بیشتر مستندات مربوط به این گزینه را در \fBwimcapture\fR(1) ببینید.
.TP
\fB--solid-chunk-size\fR=\fISIZE\fR
مشابه \fB--chunk-size\fR است، اما اندازه تکه‌ها (chunk size) را در منابع یکپارچه تعیین می‌کند. برای جزئیات بیشتر مستندات مربوط به این گزینه را در \fBwimcapture\fR(1) ببینید.
.TP
\fB--threads\fR=\fINUM_THREADS\fR
تعداد ریسمان‌هایی (threads) که برای فشرده‌سازی داده‌ها استفاده می‌شود. مقدار پیش‌فرض: تشخیص خودکار (تعداد پردازنده‌ها).
.TP
\fB--rebuild\fR
در صورت برون‌بری به یک WIM موجود، آن را به جای پیوست کردن، بازسازی (rebuild) می‌کند. بازسازی کندتر است اما مقداری فضا را که در غیر این صورت به عنوان یک حفره (hole) در WIM باقی می‌ماند، ذخیره می‌کند. همچنین \fBwimoptimize\fR(1) را ببینید.
.TP
\fB--ref\fR="\fIGLOB\fR"
یک الگوی نام فایل (glob) از WIMهای اضافی یا بخش‌های WIM چندبخشی که منابع از آن‌ها ارجاع داده می‌شوند. بخش \fBWIMهای چندبخشی (SPLIT WIMS)\fR را ببینید. این گزینه می‌تواند چندین بار مشخص شود. نکته: \fIGLOB\fR در نقل‌قول آمده است زیرا توسط \fBwimexport\fR تفسیر می‌شود و ممکن است برای محافظت در برابر بسط پوسته (shell expansion) نیاز به قرار گرفتن در گیومه داشته باشد.
.TP
\fB--pipable\fR
فایل \fIDEST_WIMFILE\fR را به عنوان یک "WIM لوله‌پذیر" (pipable WIM) می‌سازد یا بازسازی می‌کند که می‌تواند به طور کاملاً ترتیبی، از جمله از طریق لوله (pipe) اعمال شود. برای جزئیات بیشتر درباره ایجاد WIMهای لوله‌پذیر به \fBwimcapture\fR(1) مراجعه کنید. رفتار پیش‌فرض بدون این گزینه این است که \fIDEST_WIMFILE\fR تنها در صورتی لوله‌پذیر ساخته شود که "-" (خروجی استاندارد) باشد یا از قبل یک WIM لوله‌پذیر بوده باشد.
.TP
\fB--not-pipable\fR
فایل \fIDEST_WIMFILE\fR را به عنوان یک WIM معمولی و غیرقابل‌انتقال با لوله بازسازی می‌کند. این گزینه فقط زمانی مفید است که در حال برون‌بری ایمیج(ها) به یک WIM لوله‌پذیر هستید اما می‌خواهید به صورت غیرلوله‌پذیر بازسازی شود.
.TP
\fB--wimboot\fR
ایمیج مقصد را به عنوان سازگار با WIMBoot علامت‌گذاری می‌کند. همچنین در صورت برون‌بری به یک آرشیو جدید، نوع فشرده‌سازی را روی مقدار توصیه‌شده برای WIMBoot تنظیم می‌کند (در حال حاضر، XPRESS با تکه‌های ۴۰۹۶ بایتی).
.TP
\fB--unsafe-compact\fR
فایل WIM مقصد موجود را در جای خود فشرده و جمع‌وجور (compact) کرده و داده‌های جدید را پیوست می‌کند تا "حفره‌ها" حذف شوند. این روش کارآمد است، اما به طور کلی \fIنباید\fR از این گزینه استفاده شود زیرا یک عملیات فشرده‌سازی ناموفق یا متوقف‌شده، آرشیو WIM را تخریب می‌کند. برای اطلاعات بیشتر، مستندات این گزینه را در \fBwimoptimize\fR(1) ببینید.
.SH "WIMهای چندبخشی (SPLIT WIMS)"
می‌توانید از \fBwimexport\fR برای برون‌بری ایمیج‌ها از یک WIM چندبخشی (و نه به آن) استفاده کنید. آرگومان \fISRC_WIMFILE\fR باید بخش اول WIM چندبخشی را مشخص کند، در حالی که بخش‌های اضافی WIM چندبخشی باید در یک یا چند گزینه \fB--ref\fR="\fIGLOB\fR" مشخص شوند. از آنجا که تطبیق الگو (globbing) در خود گزینه \fB--ref\fR تعبیه شده است، معمولاً تنها یک گزینه \fB--ref\fR لازم است. به عنوان مثال، نام‌های بخش‌های یک WIM چندبخشی معمولاً چیزی شبیه به این هستند:
.PP
.RS
.nf
mywim.swm
mywim2.swm
mywim3.swm
mywim4.swm
mywim5.swm
.RE
.PP
برای برون‌بری اولین ایمیج از این WIM چندبخشی به یک فایل WIM جدید یا موجود به نام "other.wim"، دستور زیر را اجرا کنید:
.PP
.RS
wimexport mywim.swm 1 other.wim --ref="mywim*.swm"
.RE
.PP
.SH "نکات (NOTES)"
\fIسازگاری داده‌ها (Data consistency)\fR: به جز در زمان استفاده از \fB--unsafe-compact\fR، متوقف کردن دستور \fBwimexport\fR در میانه راه بی‌خطر است. با این حال، پس از انجام این کار، توصیه می‌شود که \fBwimoptimize\fR را بر روی WIM مقصد اجرا کنید تا هر داده‌ای که به فایل فیزیکی WIM افزوده شده اما هنوز در ساختار WIM گنجانده نشده است حذف شود، مگر اینکه WIM در حال بازسازی بوده باشد (مثلاً با \fB--rebuild\fR)، که در این صورت باید فایل موقت باقی‌مانده را حذف کنید.
.PP
\fIحذف داده‌های تکراری (Data deduplication)\fR: فرمت WIM دارای قابلیت درونی یکتا‌سازی یا حذف داده‌های تکراری (که به آن "single instancing" نیز گفته می‌شود) برای محتوای فایل‌ها است. بنابراین، هنگامی که یک ایمیج برون‌بری می‌شود، تنها محتویاتی از فایل‌ها به صورت فیزیکی کپی می‌شوند که از قبل در WIM مقصد وجود نداشته باشند. با این وجود، همیشه یک نسخه جدید از منبع فراداده (metadata resource) ایمیج که ساختار دایرکتوری آن را توصیف می‌کند، ایجاد خواهد شد.
.PP
\fIفایل‌های ESD\fR: دستور \fBwimexport\fR از WIMهای دارای فشرده‌سازی یکپارچه، یا همان فایل‌های "ESD" (.esd)، به جز فایل‌های ESD رمزگذاری‌شده که ابتدا باید رمزگشایی شوند، پشتیبانی می‌کند. فایل‌های مبدأ و مقصد در \fBwimexport\fR می‌توانند WIMهای یکپارچه، WIMهای غیریکپارچه، یا ترکیبی از آن‌ها باشند. اگر فایل مقصد وجود نداشته باشد، به طور پیش‌فرض اگر مبدأ یکپارچه باشد به عنوان یکپارچه، و اگر مبدأ غیریکپارچه باشد به عنوان غیریکپارچه ایجاد خواهد شد. برای لغو این رفتار، می‌توانید \fB--solid\fR را برای ایجاد یک WIM یکپارچه (فایل .esd)، یا \fB--compress\fR=\fILZX\fR را برای ایجاد یک WIM استاندارد غیریکپارچه (فایل .wim) مشخص کنید.
.SH "مثال‌ها (EXAMPLES)"
برون‌بری دومین ایمیج از 'boot.wim' به فایل جدید 'new.wim':
.RS
.PP
wimexport boot.wim 2 new.wim
.RE
.PP
مثال بالا "new.wim" را با همان نوع فشرده‌سازی "boot.wim" ایجاد می‌کند. اگر می‌خواهید نوع فشرده‌سازی را تغییر دهید، \fB--compress\fR=\fITYPE\fR را مشخص کنید؛ به عنوان مثال:
.RS
.PP
wimexport boot.wim 2 new.wim --compress=LZX
.RE
.PP
برون‌بری "ESD به WIM" \(em یعنی WIM یکپارچه به WIM غیریکپارچه:
.RS
.PP
wimexport install.esd all install.wim --compress=LZX
.RE
.PP
برون‌بری "WIM به ESD" \(em یعنی WIM غیریکپارچه به WIM یکپارچه:
.RS
.PP
wimexport install.wim all install.esd --solid
.RE
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR wimlib-imagex (1)
.BR wiminfo (1)
.BR wimoptimize (1)