نام (NAME)

wimexport - برون‌بری یک یا چند ایمیج از یک آرشیو WIM

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

wimexport SRC_WIMFILE SRC_IMAGE DEST_WIMFILE
[DEST_IMAGE_NAME [DEST_IMAGE_DESC]] [OPTION...]

توضیحات (DESCRIPTION)

دستور wimexport، یا به طور معادل wimlib-imagex export، ایمیج مشخص‌شده را از SRC_WIMFILE به DEST_WIMFILE برون‌بری می‌کند و در صورت تمایل می‌تواند نام و/یا توضیحات ایمیج را تغییر دهد. اگر DEST_WIMFILE از قبل وجود داشته باشد، ایمیج به انتهای آن پیوست خواهد شد؛ در غیر این صورت، یک آرشیو WIM جدید برای در بر گرفتن ایمیج برون‌بری‌شده ایجاد می‌شود.

آرگومان SRC_IMAGE مشخص‌کننده ایمیجی در SRC_WIMFILE است که باید برون‌بری شود. این مقدار می‌تواند نمایه (index) مبتنی بر ۱ یک ایمیج، نام یک ایمیج، یا کلمه کلیدی "all" برای مشخص کردن تمامی ایمیج‌ها باشد. می‌توانید از wiminfo(1) برای فهرست کردن ایمیج‌های موجود در SRC_WIMFILE استفاده کنید.

در صورت تعیین، DEST_IMAGE_NAME نامی است که به ایمیج در حال برون‌بری اختصاص می‌یابد. مقدار پیش‌فرض، نام آن در SRC_WIMFILE است. اگر تعیین شود، DEST_IMAGE_NAME باید نامی باشد که از قبل در DEST_WIMFILE استفاده نشده است، یا یک رشته خالی باشد تا ایمیج بدون نام بماند. چنانچه "all" برای برون‌بری همه ایمیج‌ها تعیین شده باشد، نمی‌توان DEST_IMAGE_NAME را مشخص کرد.

در صورت تعیین، DEST_IMAGE_DESC توضیحاتی است که به ایمیج در حال برون‌بری اختصاص داده می‌شود. مقدار پیش‌فرض، توضیحات آن در SRC_WIMFILE است.

دستور wimexport از برون‌بری ایمیج‌ها از WIMهای مستقل (stand-alone) و همچنین WIMهای چندبخشی (split) و WIMهای دلتا (delta) پشتیبانی می‌کند. بخش WIMهای چندبخشی (SPLIT WIMS) را ببینید.

همچنین wimexport از برون‌بری ایمیج‌ها از یک WIM غیرقابل‌انتقال با لوله (non-pipable) به یک WIM لوله‌پذیر (pipable) یا برعکس، یا از یک WIM غیریکپارچه (non-solid) به یک WIM یکپارچه (solid) یا برعکس پشتیبانی می‌کند. همچنین در صورتی که DEST_WIMFILE به عنوان "-" مشخص شده باشد، می‌تواند یک WIM لوله‌پذیر را مستقیماً به خروجی استاندارد برون‌بری کند؛ گزینه --pipable را ببینید.

گزینه‌ها (OPTIONS)

--boot: ایمیج برون‌بری‌شده را به عنوان ایمیج "بوت‌پذیر" (bootable) فایل WIM علامت‌گذاری می‌کند؛ یا اگر چندین ایمیج در حال برون‌بری باشند، ایمیجی را که ایمیج بوت‌پذیر WIM مبدأ بوده است، به ایمیج بوت‌پذیر WIM مقصد نیز تبدیل می‌کند.
--check: پیش از برون‌بری ایمیج(ها)، در صورتی که اطلاعات یکپارچگی اضافی در WIM مبدأ، WIM مقصد و هر WIM ارجاع‌شده دیگری موجود باشد، صحت و یکپارچگی آن‌ها را بررسی می‌کند. همچنین اطلاعات یکپارچگی اضافه را در WIM مقصد درج می‌کند، حتی اگر قبلاً در آن وجود نداشته باشد.
--nocheck: اطلاعات یکپارچگی اضافه را در WIM مقصد قرار نمی‌دهد، حتی اگر قبلاً وجود داشته باشد.
--include-integrity: اطلاعات یکپارچگی اضافه را در WIM مقصد می‌گنجاند، یعنی مانند --check عمل می‌کند اما هیچ راستی‌آزمایی را از پیش انجام نمی‌دهد.
--compress=TYPE[:LEVEL]: نوع فشرده‌سازی و در صورت تمایل، سطح فشرده‌سازی را برای آن نوع، در DEST_WIMFILE مشخص می‌کند. توجه داشته باشید که اگر DEST_WIMFILE از قبل وجود داشته باشد، نوع فشرده‌سازی آن با این گزینه قابل تغییر نیست. برای جزئیات بیشتر مستندات مربوط به این گزینه را در wimcapture(1) ببینید.
--chunk-size=SIZE: اندازه تکه‌های (chunk size) فشرده‌سازی WIM را بر روی SIZE تنظیم می‌کند. برای جزئیات بیشتر مستندات مربوط به این گزینه را در wimcapture(1) ببینید.
--recompress: فشرده‌سازی مجدد تمام داده‌های برون‌بری‌شده را اجباری می‌کند، حتی اگر WIM مقصد از همان نوع فشرده‌سازی WIM مبدأ استفاده کند.
--solid: یک آرشیو "یکپارچه" (solid) ایجاد می‌کند که چندین فایل را با هم فشرده می‌سازد. این کار معمولاً به نسبت فشرده‌سازی به مراتب بهتری می‌انجامد، اما معایبی از جمله کاهش سازگاری به همراه دارد. برای جزئیات بیشتر مستندات مربوط به این گزینه را در wimcapture(1) ببینید.
--solid-compress=TYPE[:LEVEL]: مشابه --compress است، اما نوع فشرده‌سازی مورد استفاده در منابع یکپارچه (solid resources) را تعیین می‌کند. برای جزئیات بیشتر مستندات مربوط به این گزینه را در wimcapture(1) ببینید.
--solid-chunk-size=SIZE: مشابه --chunk-size است، اما اندازه تکه‌ها (chunk size) را در منابع یکپارچه تعیین می‌کند. برای جزئیات بیشتر مستندات مربوط به این گزینه را در wimcapture(1) ببینید.
--threads=NUM_THREADS: تعداد ریسمان‌هایی (threads) که برای فشرده‌سازی داده‌ها استفاده می‌شود. مقدار پیش‌فرض: تشخیص خودکار (تعداد پردازنده‌ها).
--rebuild: در صورت برون‌بری به یک WIM موجود، آن را به جای پیوست کردن، بازسازی (rebuild) می‌کند. بازسازی کندتر است اما مقداری فضا را که در غیر این صورت به عنوان یک حفره (hole) در WIM باقی می‌ماند، ذخیره می‌کند. همچنین wimoptimize(1) را ببینید.
--ref="GLOB": یک الگوی نام فایل (glob) از WIMهای اضافی یا بخش‌های WIM چندبخشی که منابع از آن‌ها ارجاع داده می‌شوند. بخش WIMهای چندبخشی (SPLIT WIMS) را ببینید. این گزینه می‌تواند چندین بار مشخص شود. نکته: GLOB در نقل‌قول آمده است زیرا توسط wimexport تفسیر می‌شود و ممکن است برای محافظت در برابر بسط پوسته (shell expansion) نیاز به قرار گرفتن در گیومه داشته باشد.
--pipable: فایل DEST_WIMFILE را به عنوان یک "WIM لوله‌پذیر" (pipable WIM) می‌سازد یا بازسازی می‌کند که می‌تواند به طور کاملاً ترتیبی، از جمله از طریق لوله (pipe) اعمال شود. برای جزئیات بیشتر درباره ایجاد WIMهای لوله‌پذیر به wimcapture(1) مراجعه کنید. رفتار پیش‌فرض بدون این گزینه این است که DEST_WIMFILE تنها در صورتی لوله‌پذیر ساخته شود که "-" (خروجی استاندارد) باشد یا از قبل یک WIM لوله‌پذیر بوده باشد.
--not-pipable: فایل DEST_WIMFILE را به عنوان یک WIM معمولی و غیرقابل‌انتقال با لوله بازسازی می‌کند. این گزینه فقط زمانی مفید است که در حال برون‌بری ایمیج(ها) به یک WIM لوله‌پذیر هستید اما می‌خواهید به صورت غیرلوله‌پذیر بازسازی شود.
--wimboot: ایمیج مقصد را به عنوان سازگار با WIMBoot علامت‌گذاری می‌کند. همچنین در صورت برون‌بری به یک آرشیو جدید، نوع فشرده‌سازی را روی مقدار توصیه‌شده برای WIMBoot تنظیم می‌کند (در حال حاضر، XPRESS با تکه‌های ۴۰۹۶ بایتی).
--unsafe-compact: فایل WIM مقصد موجود را در جای خود فشرده و جمع‌وجور (compact) کرده و داده‌های جدید را پیوست می‌کند تا "حفره‌ها" حذف شوند. این روش کارآمد است، اما به طور کلی نباید از این گزینه استفاده شود زیرا یک عملیات فشرده‌سازی ناموفق یا متوقف‌شده، آرشیو WIM را تخریب می‌کند. برای اطلاعات بیشتر، مستندات این گزینه را در wimoptimize(1) ببینید.

WIMهای چندبخشی (SPLIT WIMS)

می‌توانید از wimexport برای برون‌بری ایمیج‌ها از یک WIM چندبخشی (و نه به آن) استفاده کنید. آرگومان SRC_WIMFILE باید بخش اول WIM چندبخشی را مشخص کند، در حالی که بخش‌های اضافی WIM چندبخشی باید در یک یا چند گزینه --ref="GLOB" مشخص شوند. از آنجا که تطبیق الگو (globbing) در خود گزینه --ref تعبیه شده است، معمولاً تنها یک گزینه --ref لازم است. به عنوان مثال، نام‌های بخش‌های یک WIM چندبخشی معمولاً چیزی شبیه به این هستند:

mywim.swm
mywim2.swm
mywim3.swm
mywim4.swm
mywim5.swm

برای برون‌بری اولین ایمیج از این WIM چندبخشی به یک فایل WIM جدید یا موجود به نام "other.wim"، دستور زیر را اجرا کنید:

wimexport mywim.swm 1 other.wim --ref="mywim*.swm"

نکات (NOTES)

سازگاری داده‌ها (Data consistency): به جز در زمان استفاده از --unsafe-compact، متوقف کردن دستور wimexport در میانه راه بی‌خطر است. با این حال، پس از انجام این کار، توصیه می‌شود که wimoptimize را بر روی WIM مقصد اجرا کنید تا هر داده‌ای که به فایل فیزیکی WIM افزوده شده اما هنوز در ساختار WIM گنجانده نشده است حذف شود، مگر اینکه WIM در حال بازسازی بوده باشد (مثلاً با --rebuild)، که در این صورت باید فایل موقت باقی‌مانده را حذف کنید.

حذف داده‌های تکراری (Data deduplication): فرمت WIM دارای قابلیت درونی یکتا‌سازی یا حذف داده‌های تکراری (که به آن "single instancing" نیز گفته می‌شود) برای محتوای فایل‌ها است. بنابراین، هنگامی که یک ایمیج برون‌بری می‌شود، تنها محتویاتی از فایل‌ها به صورت فیزیکی کپی می‌شوند که از قبل در WIM مقصد وجود نداشته باشند. با این وجود، همیشه یک نسخه جدید از منبع فراداده (metadata resource) ایمیج که ساختار دایرکتوری آن را توصیف می‌کند، ایجاد خواهد شد.

فایل‌های ESD: دستور wimexport از WIMهای دارای فشرده‌سازی یکپارچه، یا همان فایل‌های "ESD" (.esd)، به جز فایل‌های ESD رمزگذاری‌شده که ابتدا باید رمزگشایی شوند، پشتیبانی می‌کند. فایل‌های مبدأ و مقصد در wimexport می‌توانند WIMهای یکپارچه، WIMهای غیریکپارچه، یا ترکیبی از آن‌ها باشند. اگر فایل مقصد وجود نداشته باشد، به طور پیش‌فرض اگر مبدأ یکپارچه باشد به عنوان یکپارچه، و اگر مبدأ غیریکپارچه باشد به عنوان غیریکپارچه ایجاد خواهد شد. برای لغو این رفتار، می‌توانید --solid را برای ایجاد یک WIM یکپارچه (فایل .esd)، یا --compress=LZX را برای ایجاد یک WIM استاندارد غیریکپارچه (فایل .wim) مشخص کنید.

مثال‌ها (EXAMPLES)

برون‌بری دومین ایمیج از 'boot.wim' به فایل جدید 'new.wim':

wimexport boot.wim 2 new.wim

مثال بالا "new.wim" را با همان نوع فشرده‌سازی "boot.wim" ایجاد می‌کند. اگر می‌خواهید نوع فشرده‌سازی را تغییر دهید، --compress=TYPE را مشخص کنید؛ به عنوان مثال:

wimexport boot.wim 2 new.wim --compress=LZX

برون‌بری "ESD به WIM" — یعنی WIM یکپارچه به WIM غیریکپارچه:

wimexport install.esd all install.wim --compress=LZX

برون‌بری "WIM به ESD" — یعنی WIM غیریکپارچه به WIM یکپارچه:

wimexport install.wim all install.esd --solid

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

wimlib-imagex(1) wiminfo(1) wimoptimize(1)