.TH WIMAPPLY "1" "January 2026" "wimlib 1.14.5" "User Commands"
.SH "نام (NAME)"
wimapply \- اعمال یک تصویر WIM
.SH "خلاصه دستور (SYNOPSIS)"
\fBwimapply\fR \fIWIMFILE\fR [\fIIMAGE\fR] \fITARGET\fR [\fIOPTION\fR...]
.SH "توضیحات (DESCRIPTION)"
دستور \fBwimapply\fR، یا معادل آن \fBwimlib-imagex apply\fR، یک یا تمام تصاویر را از بایگانی تصویری ویندوز (WIM) \fIWIMFILE\fR استخراج («اعمال») می‌کند.
.PP
شناسه \fIIMAGE\fR تصویر مورد نظر برای استخراج در \fIWIMFILE\fR را مشخص می‌کند. این مقدار می‌تواند نمایه مبتنی بر ۱ یک تصویر، نام تصویر یا کلمه کلیدی «all» برای مشخص کردن همه تصاویر باشد. اگر \fIWIMFILE\fR تنها شامل یک تصویر باشد، می‌توان از این مقدار صرف‌نظر کرد. برای فهرست کردن تصاویر موجود در \fIWIMFILE\fR می‌توانید از \fBwiminfo\fR(1) استفاده کنید.
.PP
شناسه \fITARGET\fR مشخص می‌کند که تصویر(ها) در کجا استخراج شوند. اگر \fITARGET\fR یک دایرکتوری باشد، تصویر(ها) مطابق با بخش \fBاستخراج در دایرکتوری (یونیکس) (DIRECTORY EXTRACTION (UNIX))\fR یا \fBاستخراج در دایرکتوری (ویندوز) (DIRECTORY EXTRACTION (WINDOWS))\fR در آن دایرکتوری استخراج خواهند شد. اگر \fITARGET\fR وجود نداشته باشد، ابتدا یک دایرکتوری در آنجا ایجاد می‌شود. متناوباً، اگر \fITARGET\fR یک دستگاه بلوکی یونیکس را مشخص کند، تصویر همان‌طور که در بخش \fBاستخراج در حجم دیسک NTFS (یونیکس) (NTFS VOLUME EXTRACTION (UNIX))\fR شرح داده شده در آن استخراج خواهد شد.
.PP
توجه داشته باشید که \fBwimapply\fR برای استخراج یا «اعمال» تصاویر کامل WIM طراحی شده است. اگر در عوض می‌خواهید تنها فایل‌ها یا دایرکتوری‌های خاصی را از یک تصویر WIM استخراج کنید، از \fBwimextract\fR(1) استفاده کنید.
.PP
اگر \fIIMAGE\fR برابر با «all» باشد، تمام تصاویر موجود در \fIWIMFILE\fR در زیردایرکتوری‌هایی از \fITARGET\fR که هم‌نام تصاویر هستند استخراج خواهند شد، و در صورتی که تصویری فاقد نام یا دارای نام غیرمعمول باشد، از نمایه تصویر به عنوان نام استفاده می‌شود. این قابلیت هنوز در حالت \fBاستخراج در حجم دیسک NTFS (یونیکس) (NTFS VOLUME EXTRACTION (UNIX))\fR پشتیبانی نمی‌شود.
.PP
اگر \fIWIMFILE\fR برابر با «-» باشد، WIM به جای دیسک از ورودی استاندارد خوانده می‌شود. برای اطلاعات بیشتر بخش \fBتصاویر WIM لوله‌پذیر (PIPABLE WIMS)\fR را ببینید.
.SH "استخراج در دایرکتوری (یونیکس) (DIRECTORY EXTRACTION (UNIX))"
در سیستم‌های شبه‌یونیکس، تصویر WIM می‌تواند در یک دایرکتوری استخراج شود. این حالت این محدودیت را دارد که فراداده‌های مختص NTFS یا ویندوز استخراج نخواهند شد. اگرچه برخی مفاهیم مانند پیوندهای سخت، پیوندهای نمادین، برچسب‌های زمانی آخرین دسترسی و آخرین تغییر به معادل‌های یونیکسی خود ترجمه می‌شوند، سایر فراداده‌ها از دست خواهند رفت (همراه با هشدارهایی که داده می‌شود). به‌ویژه، انواع فراداده‌های زیر در این حالت استخراج \fIنخواهند شد\fR:
.IP \[bu] 4
پرچم‌های صفت فایل ویندوز
.IP \[bu]
توصیف‌کننده‌های امنیت ویندوز (مانند مالکان فایل و DACLها)
.IP \[bu]
برچسب‌های زمانی ایجاد فایل
.IP \[bu]
نقاط بازتحلیل (Reparse points) به جز پیوندهای نمادین و نقاط پیوند (junction points)
.IP \[bu]
جریان‌های داده نام‌گذاری‌شده (Named data streams)
.IP \[bu]
نام‌های کوتاه فایل (که به عنوان نام‌های 8.3 یا نام‌های DOS نیز شناخته می‌شوند).
.IP \[bu]
شناسه‌های شیء (Object IDs)
.PP
همین محدودیت‌ها برای \fBwimextract\fR نیز اعمال می‌شوند. بنابراین، این حالت در شرایطی بیشترین کاربرد را دارد که فراداده‌های مختص NTFS یا ویندوز اهمیتی ندارند؛ برای مثال هنگام تمایل به استخراج فایل‌های خاص، یا هنگام بایگانی فایل‌ها صرفاً در سیستم‌های شبه‌یونیکس، احتمالاً در ترکیب با \fB--unix-data\fR. هنگامی که فراداده‌های مختص ویندوز مهم باشند، یا باید از حالت \fBاستخراج در حجم دیسک NTFS (یونیکس) (NTFS VOLUME EXTRACTION (UNIX))\fR استفاده شود، یا از نسخه ویندوز wimlib استفاده گردد (بخش \fBاستخراج در دایرکتوری (ویندوز) (DIRECTORY EXTRACTION (WINDOWS))\fR را ببینید).
.SH "استخراج در حجم دیسک NTFS (یونیکس) (NTFS VOLUME EXTRACTION (UNIX))"
در سیستم‌های شبه‌یونیکس، \fITARGET\fR می‌تواند به عنوان یک دستگاه بلوکی (مانند /dev/sda3) شامل یک حجم دیسک NTFS سوارنشده (unmounted) نیز مشخص شود. در این حالت، \fBwimapply\fR از libntfs-3g برای اعمال تصویر WIM مشخص‌شده به دایرکتوری ریشه حجم دیسک NTFS استفاده می‌کند. حجم دیسک مقصد باید خالی باشد، برای مثال به تازگی توسط \fBmkntfs\fR(8) ایجاد شده باشد. در این حالت، داده‌ها و فراداده‌های مختص NTFS و ویندوز استخراج خواهند شد، از جمله موارد زیر:
.IP \[bu] 4
تمام جریان‌های داده در همه فایل‌ها به جز فایل‌های رمزشده، از جمله جریان داده بدون نام و همچنین تمام جریان‌های داده نام‌گذاری‌شده.
.IP \[bu]
نقاط بازتحلیل (Reparse points)، شامل پیوندهای نمادین، نقاط پیوند (junction points) و سایر نقاط بازتحلیل.
.IP \[bu]
برچسب‌های زمانی ایجاد، دسترسی و تغییر فایل و دایرکتوری، با استفاده از دقت بومی NTFS برابر با ۱۰۰ نانوثانیه.
.IP \[bu]
توصیف‌کننده‌های امنیت ویندوز، شامل تمامی مؤلفه‌ها (مالک، گروه، DACL و SACL).
.IP \[bu]
پرچم‌های صفت فایل ویندوز
.IP \[bu]
تمام نام‌های تمامی فایل‌ها، از جمله نام‌ها در فضای نام Win32، فضای نام DOS، فضای نام Win32+DOS و فضای نام POSIX. این شامل پیوندهای سخت نیز می‌شود.
.IP \[bu]
شناسه‌های شیء (Object IDs).
.PP
با این حال، فایل‌های رمزشده استخراج نخواهند شد.
.PP
همچنین بازیابی صفات توسعه‌یافته (EAs) هنوز در این حالت پشتیبانی نمی‌شود.
.PP
صرف نظر از این، از آنجا که تقریباً تمام اطلاعات تصویر WIM در این حالت بازیابی می‌شوند، امکان بازیابی یک تصویر از نصب واقعی ویندوز با استفاده از \fBwimapply\fR روی یک سیستم شبه‌یونیکس (به عنوان جایگزینی برای استفاده از \fBwimapply\fR یا DISM در ویندوز) وجود دارد (و کاملاً پشتیبانی می‌شود). در بخش \fBمثال‌ها (EXAMPLES)\fR در ادامه، نمونه‌ای از اعمال یک تصویر از یک فایل «install.wim» که ممکن است در رسانه نصب ویندوز یافت شود آورده شده است.
.PP
توجه داشته باشید که برای راه‌اندازی (بوت) واقعی ویندوز (Vista یا جدیدتر) از یک تصویر اعمال‌شده «install.wim»، باید پارتیشن را به عنوان «قابل بوت» (bootable) علامت‌گذاری کرده و فایل‌های مختلف بوت مانند \\BOOTMGR و \\BOOT\\BCD را تنظیم کنید. کار دوم به ساده‌ترین شکل با اجرای bcdboot.exe از یک سیستم زنده ویندوز مانند Windows PE انجام می‌شود، اما گزینه‌های دیگری نیز وجود دارد.
.PP
در نهایت، توجه داشته باشید که این حالت مستقیماً و بدون عبور از درایور \fBntfs-3g\fR(8) از libntfs-3g استفاده می‌کند. از این رو، هیچ پشتیبانی خاصی برای اعمال تصویر WIM به دایرکتوری‌ای که یک سیستم‌فایل NTFS با استفاده از \fBntfs-3g\fR(8) روی آن سوار شده باشد وجود ندارد؛ ابتدا باید آن را پیاده (unmount) کنید. همچنین هیچ پشتیبانی برای اعمال تصویر WIM به یک زیردایرکتوری از حجم دیسک NTFS وجود ندارد؛ شما فقط می‌توانید آن را به دایرکتوری ریشه اعمال کنید.
.SH "استخراج در دایرکتوری (ویندوز) (DIRECTORY EXTRACTION (WINDOWS))"
در ویندوز، \fBwimapply\fR (و \fBwimextract\fR) به طور بومی از فراداده‌های مختص NTFS و ویندوز پشتیبانی می‌کنند. برای بهترین نتیجه، دایرکتوری مقصد باید روی یک حجم دیسک NTFS قرار داشته باشد و برنامه با امتیازات Administrator اجرا شود؛ با این حال، سیستم‌فایل‌های غیر NTFS و اجرا بدون امتیازات Administrator نیز با در نظر گرفتن محدودیت‌ها پشتیبانی می‌شوند.
.PP
در ویندوز، \fBwimapply\fR تلاش می‌کند تا حد ممکن داده‌ها و فراداده‌ها را استخراج کند، از جمله:
.IP \[bu] 4
تمام جریان‌های داده در همه فایل‌ها. این شامل محتوای پیش‌فرض فایل و همچنین جریان‌های داده نام‌گذاری‌شده در صورت پشتیبانی توسط حجم دیسک مقصد است.
.IP \[bu]
نقاط بازتحلیل، شامل پیوندهای نمادین، نقاط پیوند و سایر نقاط بازتحلیل در صورت پشتیبانی توسط حجم دیسک مقصد. بازیابی پیوندهای نمادین نیازمند امتیازات Administrator است. همچنین برای جزئیات در مورد نحوه استخراج پیوندهای نمادین مطلق و نقاط پیوند، \fB--rpfix\fR و \fB--norpfix\fR را ببینید.
.IP \[bu]
برچسب‌های زمانی ایجاد، دسترسی و تغییر فایل و دایرکتوری، با بالاترین دقت پشتیبانی‌شده توسط حجم دیسک مقصد.
.IP \[bu]
توصیف‌کننده‌های امنیت، در صورتی که توسط سیستم‌فایل پشتیبانی شوند و \fB--no-acls\fR مشخص نشده باشد. توجه داشته باشید که این امر عموماً نیازمند امتیازات Administrator است و اگر برنامه بدون دسترسی‌های Administrator اجرا شود، ممکن است تنها تا حدی موفقیت‌آمیز باشد (\fB--strict-acls\fR را ببینید).
.IP \[bu]
پرچم‌های صفت فایل، شامل مخفی (hidden)، فشرده (compressed)، رمزشده (encrypted)، تنک (sparse) و غیره، در صورت پشتیبانی توسط سیستم‌فایل.
.IP \[bu]
نام‌های کوتاه فایل (که به عنوان نام‌های 8.3 یا نام‌های DOS نیز شناخته می‌شوند).
.IP \[bu]
پیوندهای سخت، در صورت پشتیبانی توسط سیستم‌فایل مقصد.
.IP \[bu]
شناسه‌های شیء (Object IDs)، در صورت پشتیبانی توسط سیستم‌فایل مقصد.
.IP \[bu]
صفات توسعه‌یافته (EAs)، در صورت پشتیبانی توسط سیستم‌فایل مقصد.
.PP
نکات تکمیلی درباره استخراج فایل‌ها در ویندوز:
.IP \[bu] 4
در صورت عدم امکان استخراج دقیق فراداده و داده‌های تصویر WIM به دلیل محدودیت‌های سیستم‌فایل مقصد، \fBwimapply\fR هشدارهایی صادر خواهد کرد.
.IP \[bu]
از آنجا که فایل‌های رمزشده (با صفت FILE_ATTRIBUTE_ENCRYPTED) به صورت متن ساده در تصویر WIM ذخیره نمی‌شوند، \fBwimapply\fR نمی‌تواند فایل‌های رمزشده را در سیستم‌فایل‌هایی که از رمزنگاری پشتیبانی نمی‌کنند بازیابی کند. بنابراین، در چنین سیستم‌فایل‌هایی، فایل‌های رمزشده استخراج نخواهند شد. افزون بر این، حتی اگر فایل‌های رمزشده در سیستم‌فایلی که از رمزنگاری پشتیبانی می‌کند بازیابی شوند، تنها در صورتی قابل رمزگشایی خواهند بود که کلید رمزگشایی در دسترس باشد.
.IP \[bu]
فایل‌هایی با نام‌هایی که در ویندوز قابل نمایش نیستند به طور پیش‌فرض استخراج نخواهند شد؛ \fB--include-invalid-names\fR را ببینید.
.IP \[bu]
فایل‌هایی با مسیر کامل بیش از ۲۶۰ نویسه (اصطلاحاً MAX_PATH) استخراج خواهند شد، اما توجه داشته باشید که این فایل‌ها برای بیشتر نرم‌افزارهای ویندوز غیرقابل دسترس خواهند بود و ممکن است به راحتی قابل حذف نباشند.
.IP \[bu]
در ویندوز، مگر اینکه گزینه \fB--no-acls\fR مشخص شده باشد، wimlib تلاش خواهد کرد توصیف‌کننده‌های امنیت فایل‌ها را دقیقاً همان‌طور که در تصویر WIM ارائه شده‌اند بازیابی کند. توجه داشته باشید که نصب‌های معمولی ویندوز شامل فایل‌هایی هستند که توصیف‌کننده‌های امنیت آنها به Administrator اجازه حذف آنها را نمی‌دهد. بنابراین، پس از استخراج نمی‌توان چنین فایل‌هایی را حذف کرد، یا در برخی موارد حتی خواند، مگر اینکه با یک برنامه تخصصی پردازش شوند که می‌داند چگونه امتیازات SE_RESTORE_NAME و/یا SE_BACKUP_NAME را که امکان نادیده گرفتن فهرست‌های کنترل دسترسی را می‌دهند، به دست آورد. این یک باگ در wimlib نیست (که طبق طراحی خود برای بازیابی صحیح داده‌های بایگانی‌شده کار می‌کند)، بلکه مشکلی ناشی از حقوق دسترسی است که ویندوز روی فایل‌های خاصی اعمال می‌کند. با این حال، اگر فقط داده‌های فایل را می‌خواهید و به توصیف‌کننده‌های امنیت اهمیتی نمی‌دهید، از \fB--no-acls\fR برای صرف‌نظر کردن از بازیابی تمام توصیف‌کننده‌های امنیت استفاده کنید.
.IP \[bu]
هشدار مشابهی با موارد بالا در مورد صفت‌های فایل مانند Readonly ،Hidden و System نیز صدق می‌کند. طبق طراحی، wimlib در ویندوز چنین صفت‌های فایلی را بازیابی خواهد کرد؛ بنابراین، فایل‌های استخراج‌شده ممکن است این صفت‌ها را داشته باشند. اگر این مورد نظر شما نیست، از گزینه \fB--no-attributes\fR استفاده کنید..SH "WIMهای چندبخشی (SPLIT WIMS)"
شما می‌توانید از \fBwimapply\fR برای اعمال ایمیج‌ها از یک WIM چندبخشی (split WIM)، یا از \fBwimextract\fR
برای استخراج فایل‌ها از یک WIM چندبخشی استفاده کنید. آرگومان \fIWIMFILE\fR باید
بخش نخست WIM چندبخشی را مشخص کند، در حالی که بخش‌های دیگر WIM چندبخشی باید
در یک یا چند گزینه \fB--ref\fR="\fIGLOB\fR" مشخص شوند. از آنجا که قابلیت globbing در
خود گزینه \fB--ref\fR تعبیه شده است، معمولاً تنها یک گزینه \fB--ref\fR
کفایت می‌کند. برای مثال، نام بخش‌های یک WIM چندبخشی معمولاً چنین ساختاری دارند:
.RS
.PP
.nf
mywim.swm
mywim2.swm
mywim3.swm
mywim4.swm
mywim5.swm
.RE
.fi
.PP
برای اعمال نخستین ایمیج از این WIM چندبخشی به دایرکتوری "dir"، اجرا کنید:
.PP
.RS
wimapply mywim.swm 1 dir --ref="mywim*.swm"
.RE
.PP
.SH "WIMهای لوله‌پذیر (PIPABLE WIMS)"
همچنین \fBwimapply\fR از اعمال یک WIM از یک فایل فاقد قابلیت جستجو (nonseekable)، مانند
یک لوله (pipe) نیز پشتیبانی می‌کند، به شرطی که WIM در قالب لوله‌پذیرِ مختص wimlib
با استفاده از \fB--pipable\fR ایجاد شده باشد (نگاه کنید به \fBwimcapture\fR(1)). برای
استفاده از ورودی استاندارد به عنوان WIM، مقدار "-" را به عنوان \fIWIMFILE\fR مشخص کنید.
یک کاربرد احتمالی این ویژگی، اعمال یک ایمیج WIM در حال استریم از شبکه است. برای مثال،
جهت اعمال نخستین ایمیج از یک فایل WIM موجود در یک کارساز HTTP به یک حجم NTFS روی /dev/sda1،
دستوری شبیه به این را اجرا کنید:
.PP
.RS
wget -O - https://myserver/mywim.wim | wimapply - 1 /dev/sda1
.RE
.PP
WIMهای لوله‌پذیر نیز می‌توانند درست مانند WIMهای معمولی به چندین بخش تقسیم شوند. برای
اعمال یک WIM لوله‌پذیرِ چندبخشی از طریق یک لوله، تمام بخش‌ها باید الحاق شده و همگی در
لوله نوشته شوند. بخش اول باید پیش از همه ارسال شود، اما بخش‌های باقی‌مانده را می‌توان
به هر ترتیبی فرستاد.
.SH "گزینه‌ها (OPTIONS)"
.TP 6
\fB--check\fR
پیش از اعمال ایمیج، اگر \fIWIMFILE\fR دارای اطلاعات تکمیلی یکپارچگی باشد، سلامت آن را راستی‌آزمایی می‌کند.
.TP
\fB--ref\fR="\fIGLOB\fR"
الگوی نام فایل (glob) مربوط به WIMهای تکمیلی یا بخش‌های WIM چندبخشی برای ارجاع منابع از آن‌ها.
بخش \fBSPLIT_WIMS\fR را ببینید. این گزینه می‌تواند چندین بار تکرار شود. نکته:
\fIGLOB\fR در گیومه قرار گرفته زیرا توسط \fBwimapply\fR تفسیر می‌شود و برای
جلوگیری از بسط شل (shell expansion) ممکن است نیاز به قرار گرفتن درون نقل‌قول داشته باشد.
.TP
\fB--rpfix\fR, \fB--norpfix\fR
مشخص می‌کند که آیا مقاصد پیوندهای نمادین مطلق (در اصطلاح ویندوز: reparse points) اصلاح شوند یا خیر.
هنگام فعال بودن (\fB--rpfix\fR)، چنین فرض می‌شود که پیوندهای نمادین مطلق استخراج‌شده که در ایمیج WIM
به عنوان اصلاح‌شده علامت‌گذاری شده‌اند، مقاصد مطلقی نسبت به ریشه ایمیج دارند؛ از این رو \fBwimapply\fR
مسیر مطلق دایرکتوری مقصد استخراج را به ابتدای مقاصد آن‌ها می‌افزاید. هدف این است که بتوانید
ایمیجی شامل پیوندهای نمادین مطلق را اعمال کنید و پس از استخراج به هر مکانی، پیوندها همچنان معتبر باشند.
.IP ""
اگر هر یک از ایمیج‌های موجود در \fIWIMFILE\fR همراه با اصلاحات reparse-point ذخیره شده باشند،
رفتار پیش‌فرض \fB--rpfix\fR است. در غیر این صورت، پیش‌فرض \fB--norpfix\fR خواهد بود.
.IP ""
اصلاحات reparse point هرگز در حالت استخراج به حجم NTFS در سیستم‌های شبه‌یونیکس انجام نمی‌شود.
.TP
\fB--unix-data\fR
(تنها در سیستم‌های شبه‌یونیکس) بازگردانی متاداده‌های مخصوص یونیکس و فایل‌های ویژه‌ای که
توسط \fBwimcapture\fR با گزینه \fB--unix-data\fR ذخیره شده بودند. این موارد شامل: مجوزهای
استاندارد یونیکس برای فایل (مالک، گروه، و حالت دسترسی)؛ گره‌های دستگاه (device nodes)،
لوله‌های نام‌گذاری‌شده (named pipes) و سوکت‌ها؛ و مشخصه‌های گسترش‌یافته (تنها در لینوکس) است.
.TP
\fB--no-acls\fR
توصیف‌کننده‌های امنیتی (security descriptors) را روی فایل‌ها و دایرکتوری‌های استخراج‌شده بازیابی نمی‌کند.
.TP
\fB--strict-acls\fR
در صورتی که توصیف‌کننده امنیتی کاملِ هر فایل یا دایرکتوری دقیقاً مطابق آنچه در فایل WIM تعیین شده قابل تنظیم نباشد،
بلافاصله با خطا خارج می‌شود. اگر این گزینه مشخص نشود، هنگامی که \fBwimapply\fR در ویندوز مجوزهای لازم برای
تنظیم توصیف‌کننده امنیتی روی یک فایل استخراج‌شده را نداشته باشد، به تنظیم ناقص آن (مثلاً با صرف‌نظر از SACL)
بسنده می‌کند و در بدترین حالت آن را کاملاً نادیده می‌گیرد. با این حال، این مشکل معمولاً تنها زمانی رخ می‌دهد
که \fBwimapply\fR بدون دسترسی‌های Administrator اجرا شود. همچنین در سیستم‌های شبه‌یونیکس، این پرچم
می‌تواند با \fB--unix-data\fR ترکیب شود تا در صورت عدم امکان اعمال مجوزهای یونیکس روی یک فایل استخراج‌شده،
\fBwimapply\fR خطایی صادر کند.
.TP
\fB--no-attributes\fR
ویژگی‌های فایل ویندوز مانند readonly، hidden و غیره را بازیابی نمی‌کند.
.TP
\fB--include-invalid-names\fR
فایل‌ها و دایرکتوری‌های دارای نام‌های نامعتبر را به جای نادیده گرفتن، با جایگزین کردن نویسه‌ها و افزودن یک پسوند
استخراج می‌کند. این که دقیقاً چه چیزی یک نام «نامعتبر» تلقی می‌شود، به پلتفرم بستگی دارد.
.IP ""
در سیستم‌های سازگار با POSIX، نام فایل‌ها به بزرگی و کوچکی حروف حساس بوده و می‌توانند شامل هر بایتی
به جز '\\0' و '/' باشند؛ بنابراین در یک سیستم سازگار با POSIX، این گزینه تنها در حالت نادری اثرگذار
خواهد بود که ایمیج WIM به دلیلی نام فایلی شامل این نویسه‌ها داشته باشد.
.IP ""
در ویندوز، نام فایل‌ها به بزرگی و کوچکی حروف حساس نیست (*)، نمی‌تواند شامل نویسه‌های کنترلی باشد،
و نمی‌تواند حاوی نویسه‌های '/'، '\\0'، '\\'، ':'، '*'، '?'، '"'، '<'، '>' یا '|' باشد. به‌طور معمول،
فایل‌های درون ایمیج‌های WIM نیز باید این شرایط را رعایت کنند. با این حال این موضوع تضمین‌شده نیست؛ به‌ویژه
یک ایمیج WIM که با \fBwimcapture\fR در یک سیستم سازگار با POSIX ذخیره شده باشد ممکن است شامل چنین فایل‌هایی
باشد. به‌طور پیش‌فرض، نام‌های نامعتبر نادیده گرفته می‌شوند و اگر چندین نام تنها در بزرگی و کوچکی حروف با یکدیگر
تفاوت داشته باشند، یکی از آن‌ها به‌صورت تصادفی برای استخراج انتخاب می‌شود؛ اما با \fB--include-invalid-names\fR،
تمام نام‌ها پاک‌سازی شده و به نحوی استخراج خواهند شد.
.IP ""
(*) مگر اینکه تنظیم ObCaseInsensitive در رجیستری ویندوز روی 0 تنظیم شده باشد، که در این صورت برخی نرم‌افزارها،
از جمله نسخه ویندوز \fBwimapply\fR، حساسیت به بزرگی و کوچکی حروف را روی NTFS و دیگر سیستم‌فایل‌های سازگار رعایت خواهند کرد.
.TP
\fB--wimboot\fR
تنها در ویندوز: به جای استخراج خود فایل‌ها، «فایل‌های اشاره‌گر» (pointer files) را به آرشیو(های) WIM بازمی‌گرداند.
این قابلیت می‌تواند صرفه‌جویی چشمگیری در فضای دیسک به همراه داشته باشد. با این حال، معایبی نیز دارد،
از جمله عدم امکان حذف آرشیو(های) WIM و احتمالاً کندتر شدن دسترسی به فایل‌ها. برای اطلاعات بیشتر به مستندات
مایکروسافت درباره «WIMBoot» مراجعه کنید.
.IP ""
در صورت وجود، بخش [PrepopulateList] از فایل \\Windows\\System32\\WimBootCompress.ini در ایمیج WIM
خوانده خواهد شد. فایل‌های منطبق با هر یک از این الگوها به‌صورت معمولی استخراج می‌شوند و نه به‌صورت فایل‌های
اشاره‌گر WIMBoot. این موضوع برای فایل‌هایی که ویندوز در اوایل فرایند بوت به خواندن آن‌ها نیاز دارد سودمند است.
.IP ""
این گزینه تنها زمانی کار می‌کند که برنامه به صورت Administrator اجرا شده باشد و حجم مقصد NTFS یا سیستم‌فایل
دیگری باشد که از reparse points پشتیبانی کند.
.IP ""
همچنین، این گزینه بهترین عملکرد را در ویندوز 8.1 آپدیت 1 یا بالاتر دارد، چرا که این نخستین نسخه از ویندوز است
که درایور فیلتر سیستم‌فایل همپوشانی ویندوز («WOF») را به همراه دارد. در صورت شناسایی درایور WOF، ابزار wimlib
فایل‌های اشاره‌گر WIMBoot را با استفاده از ioctlهای مستند ارائه‌شده توسط WOF ایجاد خواهد کرد.
.IP ""
در غیر این صورت، چنانچه درایور WOF یافت نشود، wimlib نقاط reparse را ایجاد کرده و فایل "\\System Volume Information\\WimOverlay.dat"
را روی حجم مقصد به‌صورت دستی ویرایش می‌کند. این امر بالقوه می‌تواند مشکل‌آفرین باشد، چرا که اگرچه کد در موارد
آزمایش‌شده خاصی به درستی کار می‌کند، اما هیچ‌یک از این قالب‌های داده توسط مایکروسافت مستند نشده‌اند. پیش از بازنویسی این فایل،
wimlib نسخه پیشین آن را در مسیر "\\System Volume Information\\WimOverlay.wimlib_backup" ذخیره می‌کند که
در صورت نیاز می‌توانید آن را بازیابی کنید.
.IP ""
حتی اگر ایمیج WIM دارای برچسب «سازگار با WIMBoot» نباشد، همچنان می‌توانید استخراج با \fB--wimboot\fR را انجام دهید.
این گزینه باعث می‌شود فایل‌های استخراج‌شده به‌صورت «پشتیبانی‌شده از خارج» (externally backed) توسط فایل WIM تنظیم شوند.
درایور مایکروسافت که این سازوکار پشتیبانی خارجی را پیاده کرده است، ظاهراً به سازگار بودن یا نبودن ایمیج(ها) با WIMBoot
اهمیتی نمی‌دهد. بنابراین، برچسب «WIMBoot-compatible» (تگ <WIMBOOT> در داده‌های XML) تنها به منزله نشان‌دهنده یک نیت کاری
به نظر می‌رسد. افزون بر این، درایور مایکروسافت علاوه‌بر قطعات پیش‌فرض XPRESS با اندازه 4096 که هنگام اجرای \fBwimcapture\fR
با گزینه \fB--wimboot\fR ساخته می‌شوند، می‌تواند فایل‌ها را از فایل‌های WIM با قطعات XPRESS با اندازه‌های 8192، 16384 و 32768
یا قطعات LZX با اندازه 32768 نیز به‌طور خارجی پشتیبانی کند.
.TP
\fB--compact\fR=\fIFORMAT\fR
تنها در ویندوز: در صورت امکان فایل‌های استخراج‌شده را با استفاده از فشرده‌سازی سیستم (System Compression) فشرده می‌کند.
این گزینه تنها در ویندوز 10 یا جدیدتر، یا در نسخه‌های قدیمی‌تر ویندوز که درایور wofadk.sys مایکروسافت به آن‌ها افزوده شده،
کار می‌کند. قالب‌های فشرده‌سازی گوناگونی را می‌توان با System Compression به کار برد، که یکی از آن‌ها باید در قالب
\fIFORMAT\fR مشخص شود. گزینه‌ها عبارتند از: xpress4k، xpress8k، xpress16k و lzx.
.IP ""
استثناها درست مانند گزینه \fB--wimboot\fR مدیریت می‌شوند. به این معنی که: در صورت وجود، بخش [PrepopulateList]
از فایل \\Windows\\System32\\WimBootCompress.ini درون ایمیج WIM خوانده می‌شود و فایل‌های منطبق با هر یک از الگوهای
این بخش فشرده نخواهند شد. علاوه بر این، wimlib فهرستی پیش‌فرض در خود دارد که جهت سازگاری با لودر بوت ویندوز،
قالب فشرده‌سازی درخواست‌شده را برای فایل‌های درون آن نادیده می‌گیرد.
.TP
\fB--recover-data\fR
اگر فایلی آسیب دیده باشد (هش ذخیره‌شده آن با هش واقعی آن یکسان نباشد، یا بخش‌هایی از آن قابل بازگشایی نباشد)،
به جای لغو کامل عملیات با یک خطا، فایل آسیب‌دیده را به همراه یک هشدار استخراج می‌کند. این گزینه می‌تواند برای
بازیابی داده‌ها در صورت خرابی یک آرشیو WIM سودمند باشد. توجه داشته باشید که بازیابی داده‌ها همواره موفقیت‌آمیز
نخواهد بود، چرا که به نوع و عمق خرابی رخ‌داده بستگی دارد..SH "نکات (NOTES)"
\fIیکپارچگی داده‌ها\fR: فایل‌های WIM شامل جمع‌های کنترلی (checksums) داده‌های فایل هستند. برای تشخیص خرابی تصادفی (غیرعمدی) داده‌ها، wimlib جمع کنترلی هر فایلی را که استخراج می‌کند محاسبه کرده و در صورتی که با مقدار مورد انتظار مطابقت نداشته باشد خطایی صادر می‌کند، مگر اینکه گزینهٔ \fB\-\-recover\-data\fR داده شده باشد. (به نظر می‌رسد این رفتار پیش‌فرض معادل گزینهٔ \fB/verify\fR در ImageX است.) علاوه بر این، یک فایل WIM می‌تواند شامل یک جدول یکپارچگی (جمع‌های کنترلی اضافی) بر روی داده‌های خام کل فایل WIM باشد. به دلایل کارایی، wimlib به‌طور پیش‌فرض جدول یکپارچگی را بررسی نمی‌کند، اما می‌توان گزینهٔ \fB\-\-check\fR را ارسال کرد تا این کار انجام شود.
.PP
\fIفایل‌های ESD\fR: ابزار wimlib می‌تواند فایل‌ها را از WIMهای فشرده‌شدهٔ یکپارچه (solid-compressed) یا فایل‌های "ESD" (با پسوند ‎.esd)، درست همانند فایل‌های عادی WIM (با پسوند ‎.wim) استخراج کند. با این حال، مایکروسافت گاهی فایل‌های ESD را با بخش‌های رمزگذاری‌شده توزیع می‌کند؛ wimlib نمی‌تواند چنین فایل‌هایی را تا زمانی که ابتدا رمزگشایی نشوند استخراج کند.
.PP
\fIامنیت\fR: ابزار wimlib با دقت نوشته شده است تا تمام ورودی‌ها را اعتبارسنجی کند و انتظار می‌رود در برابر برخی از انواع حملاتی که اغلب گریبان‌گیر سایر برنامه‌های آرشیو فایل می‌شوند، مانند حملات پیمایش دایرکتوری (directory traversal) (که بر حسب اتفاق، نرم‌افزار WIM مایکروسافت در برابر آن آسیب‌پذیر است) ایمن باشد. بخش‌های مهم wimlib، مانند خارج‌کننده‌ها از فشردگی (decompressors)، همچنین تحت آزمون فازینگ (fuzz testing) قرار گرفته‌اند. با این حال، wimlib در حال حاضر برای محافظت در برابر برخی انواع حملات محروم‌سازی از سرویس (DOS)، مانند اتمام حافظه یا «بمب‌های زیپ» (zip bombs)، طراحی نشده است.
.SH "مثال‌ها (EXAMPLES)"
استخراج اولین ایمیج از Windows PE WIM روی رسانهٔ نصب ویندوز در دایرکتوری "boot":
.RS
.PP
wimapply /mnt/windows/sources/boot.wim 1 boot
.RE
.PP
در ویندوز، اعمال یک ایمیج از یک حجم ذخیره‌سازی کامل، به عنوان مثال از "install.wim" که می‌توان آن را در رسانهٔ نصب ویندوز یافت:
.RS
.PP
wimapply install.wim 1 E:\e
.RE
.PP
مشابه بالا، اما در حال اجرا بر روی یک سیستم شبه‌یونیکس (UNIX-like) که در آن پارتیشن مربوطه ‎/dev/sda2 است:
.RS
.PP
wimapply install.wim 1 /dev/sda2
.RE
.PP
توجه داشته باشید که پیش از اجرای هر یک از دستورات بالا، ممکن است نیاز باشد یک سیستم‌فایل NTFS روی پارتیشن ایجاد شود؛ به عنوان مثال با format.exe در ویندوز یا \fBmkntfs\fR(8) در سیستم‌های شبه‌یونیکس. به عنوان مثال، در یونیکس ممکن است این دستور را اجرا کنید:
.RS
.PP
mkntfs /dev/sda2 && wimapply install.wim 1 /dev/sda2
.RE
.PP
(البته اگر نمی‌خواهید تمام داده‌های موجود روی پارتیشن نابود شوند، این کار را انجام ندهید!)
.PP
برای نمونه‌هایی از اعمال WIMهای چندبخشی و قابل لوله‌کشی، به ترتیب بخش‌های \fBSPLIT WIMS\fR و \fBPIPABLE WIMS\fR را ببینید.
.SH "همچنین ببینید (SEE ALSO)"
.BR wimlib-imagex (1)
.BR wimcapture (1)
.BR wimextract (1)
.BR wiminfo (1)