.TH WIMMOUNT "1" "January 2026" "wimlib 1.14.5" "User Commands"
.SH "نام (NAME)"
wimmount, wimmountrw, wimunmount \- سوار کردن یا پیاده کردن یک تصویر WIM
.SH "خلاصه دستور (SYNOPSIS)"
\fBwimmount\fR \fIWIMFILE\fR [\fIIMAGE\fR] \fIDIRECTORY\fR [\fIOPTION\fR...]
.br
\fBwimmountrw\fR \fIWIMFILE\fR [\fIIMAGE\fR] \fIDIRECTORY\fR [\fIOPTION\fR...]
.br
\fBwimunmount\fR \fIDIRECTORY\fR [\fIOPTION\fR...]
.SH "توضیحات (DESCRIPTION)"
در لینوکس، دستورهای \fBwimmount\fR (معادل: \fBwimlib-imagex mount\fR) و
\fBwimmountrw\fR (معادل: \fBwimlib-imagex mountrw\fR) تصویر مشخص‌شدهٔ
\fIIMAGE\fR را در آرشیو Windows Imaging (WIM) به نام \fIWIMFILE\fR با استفاده از
FUSE (سامانه‌فایل در فضای کاربری) روی دایرکتوری \fIDIRECTORY\fR سوار می‌کنند.
\fBwimmount\fR تصویر را به صورت فقط‌خواندنی، و \fBwimmountrw\fR تصویر را به صورت
خواندنی-نوشتنی سوار خواهد کرد.
.PP
آرگومان \fIIMAGE\fR تصویری در \fIWIMFILE\fR را که باید سوار شود مشخص می‌کند. این
مقدار می‌تواند نمایهٔ عددی تصویر (شروع از ۱) یا نام آن باشد. در صورتی که
\fIWIMFILE\fR تنها شامل یک تصویر باشد، می‌توان آن را حذف کرد. برای مشاهدهٔ فهرست
تصاویر موجود در \fIWIMFILE\fR می‌توانید از \fBwiminfo\fR(1) استفاده کنید.
.PP
تصویر WIM را می‌توان با استفاده از \fBwimunmount\fR (معادل:
\fBwimlib-imagex unmount\fR) پیاده کرد. تغییرات ایجادشده در تصویری که به صورت
خواندنی-نوشتنی سوار شده است لغو و نادیده گرفته خواهند شد، مگر اینکه گزینهٔ
\fB--commit\fR به \fBwimunmount\fR داده شود.
.SH "پشتیبانی از داده‌ها و فراداده‌ها (DATA AND METADATA SUPPORT)"
تصاویر WIM می‌توانند شامل انواع مختلفی از فایل‌ها و فراداده‌های فایلی باشند که
برخی از آن‌ها مختص ویندوز است. در حال حاضر، قابلیت سوار کردن می‌تواند برخی از
مفاهیم ویندوز را به معادل‌های لینوکسی ترجمه کند، اما نه همهٔ آن‌ها را. به طور
خلاصه، ویژگی‌های زیر \fIپشتیبانی می‌شوند\fR (خواندنی/نوشتنی):
.IP \[bu] 4
پیوندهای سخت (Hard links)
.IP \[bu]
پیوندهای نمادین (Symbolic links). پیوندهای نمادین بومی ویندوز و Junctionها در
یک تصویر WIM سوارشده، به طور خودکار به پیوندهای نمادین یونیکس ترجمه می‌شوند و در
صورت لزوم مقصدهای آن‌ها بر اساس دایرکتوری نقطهٔ سوار شدن واقعی تصحیح می‌شود.
پیوندهای نمادین یونیکسی که در یک تصویر WIM سوارشدهٔ خواندنی-نوشتنی ایجاد شوند،
به طور خودکار به پیوندهای نمادین بومی ویندوز تبدیل خواهند شد.
.IP \[bu]
جریان‌های دادهٔ نام‌گذاری‌شده (Named data streams - اکثراً). گزینهٔ
\fB--streams-interface\fR را ببینید.
.PP
علاوه بر این، در صورت استفاده از گزینهٔ \fB--unix-data\fR، مجوزهای استاندارد فایل
یونیکس (مالک، گروه و حالت دسترسی) و فایل‌های ویژه نیز پشتیبانی می‌شوند.
.PP
با این حال، ویژگی‌های زیر \fIپشتیبانی نمی‌شوند\fR و در تصاویر سوارشده ارائه
نمی‌گردند:
.IP \[bu] 4
توصیف‌کننده‌های امنیتی ویندوز (Windows security descriptors). به فایل‌های جدید
توصیف‌کنندهٔ امنیتی اختصاص داده نمی‌شود.
.IP \[bu]
نام‌های DOS (نام‌های 8.3) (نام‌های کوتاه). به فایل‌های جدید نام DOS اختصاص داده
نمی‌شود.
.IP \[bu]
مشخصه‌های فایل ویندوز (Windows file attributes). به فایل‌های جدید بر اساس
بیت‌های حالت فایل یونیکس، مشخصه‌های پیش‌فرض اختصاص داده می‌شود.
.IP \[bu]
شناسه‌های شیء (Object IDs). به فایل‌های جدید شناسهٔ شیء داده نمی‌شود.
.IP \[bu]
فایل‌های رمزگذاری‌شده با EFS. خود فایل‌ها در تصاویر WIM سوارشده قابل مشاهده
خواهند بود اما داده‌های آن‌ها در دسترس نخواهد بود.
.IP \[bu]
مشخصه‌های گسترش‌یافته (Extended attributes). اگرچه wimlib از تصاویر WIM حاوی
مشخصه‌های گسترش‌یافته پشتیبانی می‌کند، اما این موارد هنوز در تصاویر WIM سوارشده
ارائه نشده‌اند. (این قابلیت ممکن است در آینده پیاده‌سازی شود، هرچند با استفاده
از مشخصه‌های گسترش‌یافته برای نمایش مفاهیم ویندوز مانند جریان‌های دادهٔ
نام‌گذاری‌شده تداخل خواهد داشت.)
.SH "تصاویر WIM چندبخشی (SPLIT WIMS)"
می‌توانید از \fBwimmount\fR برای سوار کردن یک تصویر از یک WIM چندبخشی (split WIM)
به صورت فقط‌خواندنی استفاده کنید. اما مجاز به سوار کردن تصویری از یک WIM چندبخشی
به صورت خواندنی-نوشتنی نیستید.
.PP
آرگومان \fIWIMFILE\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 چندبخشی در دایرکتوری "dir"، اجرا کنید:
.PP
.RS
wimmount mywim.swm 1 dir --ref="mywim*.swm"
.RE
.PP
.SH "نکات (NOTES)"
\fIدر دسترس بودن\fR: سوار کردن تصاویر WIM تنها در سیستم‌های مبتنی بر لینوکس
پشتیبانی می‌شود. این دستورها در سایر پلتفرم‌ها کار نخواهند کرد. علاوه بر این،
کتابخانه نباید با گزینهٔ \fB--without-fuse\fR پیکربندی شده باشد.
.PP
\fIچندین سوار کردن هم‌زمان\fR: شما مجاز به سوار کردن چندین تصویر WIM به طور هم‌زمان
هستید، به شرطی که دو تصویر از یک فایل به طور هم‌زمان به صورت خواندنی-نوشتنی سوار
نشده باشند.
.PP
\fIالحاق در برابر بازسازی\fR: به طور پیش‌فرض، تغییرات روی یک WIM خواندنی-نوشتنی در
همان محل و از طریق الحاق به انتهای فایل WIM اعمال می‌شوند. این روش برای فایل‌های
بزرگ WIM مناسب است، زیرا کل فایل برای یک تغییر کوچک نیازی به بازسازی ندارد. اما
اگر در حال اعمال تغییرات فراوان روی یک WIM سوارشدهٔ خواندنی-نوشتنی هستید،
به‌ویژه هنگام حذف فایل‌های حجیم، پیشنهاد می‌شود گزینهٔ \fB--rebuild\fR را به
\fBwimunmount\fR بدهید تا بازسازی فایل WIM اجباری شود، یا پس از آن دستور
\fBwimoptimize\fR را اجرا کنید.
.PP
\fIفایل‌های ESD (تصاویر یکپارچه یا solid WIMs)\fR: شما می‌توانید WIMهای نگارش ۳۵۸۴ را
سوار کنید، که معمولاً حاوی منابع فشرده‌شده با الگوریتم LZMS به صورت یکپارچه
هستند و ممکن است پسوند \fI.esd\fR داشته باشند نه \fI.wim\fR. با این حال، چنین
فایل‌هایی برای دسترسی تصادفی طراحی نشده‌اند، بنابراین خواندن داده‌ها از آن‌ها
هنگام سوار بودن ممکن است بسیار کُند باشد. علاوه بر این، فایل‌های \fI.esd\fR که به
طور مستقیم توسط دریافت‌کنندهٔ تحت وب ویندوز ۸ بارگیری می‌شوند دارای بخش‌های
رمزگذاری‌شده هستند، و wimlib نمی‌تواند چنین فایل‌هایی را پیش از رمزگشایی سوار
کند.
.SH "گزینه‌های سوار کردن (MOUNT OPTIONS)"
.TP 6
\fB--check\fR
پیش از سوار کردن تصویر WIM، در صورتی که WIM حاوی اطلاعات یکپارچگی اضافی باشد،
سلامت و یکپارچگی آن را بررسی می‌کند.
.TP
\fB--streams-interface\fR=\fIINTERFACE\fR
این گزینه از درایور سامانه‌فایل \fBntfs-3g\fR(8) الگوبرداری شده است. این گزینه
نحوهٔ ارائه و در دسترس قرار گرفتن جریان‌های دادهٔ نام‌گذاری‌شده (که "alternate
data streams" نیز نامیده می‌شوند) در فایل‌های WIM را کنترل می‌کند.
.IP ""
اگر روی "none" باشد، خواندن یا نوشتن جریان‌های دادهٔ نام‌گذاری‌شده غیرممکن خواهد
بود.
.IP ""
اگر روی "xattr" (پیش‌فرض) باشد، جریان‌های دادهٔ نام‌گذاری‌شده از طریق مشخصه‌های
گسترش‌یافتهٔ فایل در دسترس خواهند بود، مگر اینکه این پشتیبانی هنگام کامپایل wimlib
غیرفعال شده باشد. جریان‌های دادهٔ نام‌گذاری‌شده از طریق مشخصه‌های گسترش‌یافته‌ای
به نام "user.*" قابل دسترسی خواهند بود که در آن * نام جریان داده است.
\fBsetfattr\fR(1) و \fBgetfattr\fR(1) را ببینید. توجه داشته باشید که این رابط ایده‌آل
نیست، زیرا ممکن است حجم جریان‌های دادهٔ نام‌گذاری‌شده از بیشینه اندازهٔ مجاز برای
مشخصهٔ گسترش‌یافته بیشتر باشد.
.IP ""
اگر روی "windows" باشد، جریان‌های دادهٔ نام‌گذاری‌شده با مشخص کردن نام فایل، سپس
یک دونقطه (:) و سپس نام جریان داده در دسترس خواهند بود؛ برای نمونه:
"myfile:mystream".
.TP
\fB--debug\fR
اطلاعات اشکال‌زدایی چاپ‌شده توسط کتابخانهٔ FUSE را فعال می‌کند و فرایند را به
پس‌زمینه منشعب (fork) نمی‌کند.
.TP
\fB--ref\fR="\fIGLOB\fR"
الگوی فایلی (glob) برای WIMهای اضافی یا بخش‌های WIM چندبخشی جهت ارجاع به منابع.
بخش \fBSPLIT_WIMS\fR را ببینید. این گزینه می‌تواند چندین بار مشخص شود. نکته:
\fIGLOB\fR داخل گیومه آمده است زیرا توسط \fBwimlib-imagex\fR تفسیر می‌شود و
ممکن است برای محافظت در برابر بسط پوسته نیاز به قرار گرفتن داخل گیومه داشته
باشد.
.TP
\fB--staging-dir\fR=\fIDIR\fR
فایل‌های موقت واسط (staging) را در یک زیردایرکتوری از دایرکتوری \fIDIR\fR ذخیره
می‌کند. تنها برای \fBwimmountrw\fR معتبر است.
.TP
\fB--unix-data\fR
فراداده‌های مختص یونیکس را که توسط \fBwimcapture\fR به همراه گزینهٔ
\fB--unix-data\fR ثبت شده‌اند لحاظ می‌کند. به طور پیش‌فرض، \fBwimmount\fR (و
\fBwimmountrw\fR) هر دو توصیف‌کننده‌های امنیتی سبک ویندوز و فراداده‌های مختص یونیکس
را نادیده می‌گیرند. در این حالت پیش‌فرض، تمام فایل‌ها به سادگی در مالکیت کاربری
خواهند بود که \fBwimmount\fR را اجرا کرده است و حالت دسترسی 0777 خواهند داشت. (با
این حال برای سایر کاربران قابل دسترسی نخواهند بود مگر اینکه گزینهٔ
\fB--allow-other\fR را نیز مشخص کرده باشید.) اگر در عوض گزینهٔ \fB--unix-data\fR
را ارائه دهید، این مجوزهای پیش‌فرض بر اساس فراداده‌های مختص یونیکس از تصویر WIM
(در صورت موجود بودن) برای هر فایل بازنویسی می‌شوند؛ و در مورد \fBwimmountrw\fR،
تغییر مجوزهای یونیکس روی فایل‌های تصویر سوارشده با استفاده از ابزارها و توابع
استاندارد یونیکس و همچنین ایجاد فایل‌های ویژهٔ یونیکس مانند گره‌های دستگاه (در
صورت داشتن امتیازات لازم) امکان‌پذیر خواهد بود.
.TP
\fB--allow-other\fR
گزینهٔ \fBallow_other\fR را به سوار کردن FUSE منتقل می‌کند. \fBmount.fuse\fR (8) را
ببینید. نکته: برای انجام این کار به عنوان کاربر غیر ریشه (non-root)، لازم است
\fBuser_allow_other\fR در فایل /etc/fuse.conf مشخص شده باشد.
.SH "گزینه‌های پیاده کردن (UNMOUNT OPTIONS)"
.TP
\fB--commit\fR
فایل WIM را با تغییراتی که ایجاد شده است به‌روزرسانی می‌کند. اگر تصویر به صورت
فقط‌خواندنی سوار شده باشد، هیچ اثری ندارد.
.TP
\fB--force\fR
در ترکیب با \fB--commit\fR، اعمال تغییرات در تصویر WIM را اجبار می‌کند حتی اگر
توصیف‌کننده‌های فایل بازی به تصویر WIM وجود داشته باشند. هر توصیف‌کنندهٔ فایل از این
دست بی‌درنگ بسته خواهد شد، و تصویر WIM ذخیره و پیاده می‌شود.
.TP
\fB--check\fR
هنگام ذخیرهٔ تغییرات در WIM، اطلاعات یکپارچگی اضافی را درج می‌کند، حتی اگر پیش‌تر
وجود نداشته باشد.
.TP
\fB--rebuild\fR
کل فایل WIM را بازسازی می‌کند به جای اینکه داده‌های جدید را به انتهای آن الحاق
کند. بازسازی WIM کُندتر است، اما مقدار کمی فضا را که در غیر این صورت به عنوان یک
حفره در WIM باقی می‌ماند، ذخیره خواهد کرد. اگر سوار کردن خواندنی-نوشتنی منجر به
حذف جریان‌ها از WIM شده باشد، فضای حتی بیشتری ذخیره خواهد شد. همچنین ببینید
.TP
\fB--new-image\fR
در ترکیب با \fB--commit\fR برای یک تصویر سوارشدهٔ خواندنی-نوشتنی، باعث می‌شود تصویر
تغییریافته به عنوان یک تصویر جدید و بدون نام به انتهای آرشیو WIM الحاق و ذخیره
شود. تصویر اصلی بدون تغییر باقی خواهد ماند.
.SH "جزئیات پیاده‌سازی (IMPLEMENTATION DETAILS)"
از آنجا که WIM یک آرشیو است و به خودی خود یک سامانه‌فایل نیست، \fBwimmountrw\fR یک
دایرکتوری واسط (staging) موقت ایجاد می‌کند تا فایل‌های ایجادشده یا تغییریافته را
در بر بگیرد. این دایرکتوری به طور پیش‌فرض در همان دایرکتوری \fIWIMFILE\fR قرار
دارد، اما مکان آن را می‌توان با استفاده از گزینهٔ \fB--staging-dir\fR تعیین کرد.
هنگامی که سامانه‌فایل با \fB--commit\fR پیاده می‌شود، WIM در همان محل اصلاح
می‌شود (یا با \fB--rebuild\fR به طور کامل بازسازی می‌شود) و فایل‌های واسط بر حسب
نیاز ادغام می‌شوند. سپس دایرکتوری واسط موقت حذف می‌گردد.
.PP
دستور \fBwimunmount\fR در فرایندی جداگانه از فرایندی که پیش‌تر \fBwimmount\fR را اجرا
کرده بود اجرا می‌شود. هنگام پیاده کردن یک تصویر WIM سوارشدهٔ خواندنی-نوشتنی با
\fB--commit\fR، این دو فرایند با استفاده از یک صف پیام POSIX با یکدیگر ارتباط
برقرار می‌کنند تا فرایند پیاده کردن بتواند پیشرفت فرایند سوار کردن را دنبال کند.
برای جزئیات بیشتر، \fIsrc/mount_image.c\fR را در کد منبع ببینید.
.SH "همچنین ببینید (SEE ALSO)"
.BR wimlib-imagex (1)