.TH WIMEXTRACT "1" "ژانویه 2026" "wimlib 1.14.5" "دستورهای کاربر"
.SH "نام (NAME)"
wimextract \- استخراج فایل‌ها از یک تصویر WIM
.SH "خلاصه دستور (SYNOPSIS)"
\fBwimextract\fR \fIWIMFILE\fR \fIIMAGE\fR [(\fIPATH\fR | @\fILISTFILE\fR)...]  [\fIOPTION\fR...]
.SH "توضیحات (DESCRIPTION)"
دستور \fBwimextract\fR، یا معادل آن \fBwimlib-imagex extract\fR، یک یا چند فایل یا درخت دایرکتوری را از \fIIMAGE\fR مشخص‌شده درون بایگانی (WIM) Windows Imaging به نام \fIWIMFILE\fR استخراج می‌کند.
.PP
دستور \fBwimextract\fR برای استخراج تنها زیرمجموعه‌ای از یک تصویر WIM در نظر گرفته شده است. اگر می‌خواهید یک تصویر WIM کامل را در یک دایرکتوری یا حجم دیسک NTFS استخراج یا «اعمال» (apply) کنید، به جای آن از \fBwimapply\fR(1) استفاده نمایید.
.PP
پارامتر \fIIMAGE\fR تصویری را در \fIWIMFILE\fR مشخص می‌کند که فایل‌ها یا درخت‌های دایرکتوری باید از آن استخراج شوند. این مقدار می‌تواند نمایه‌ی ۱-پایه (1-based index) یک تصویر یا نام آن باشد. اگر \fIWIMFILE\fR تنها شامل یک تصویر باشد، می‌توان از این مقدار صرف‌نظر کرد. برای فهرست کردن تصاویر موجود در \fIWIMFILE\fR می‌توانید از \fBwiminfo\fR(1) استفاده کنید.
.PP
اگر هیچ آرگومان اضافی داده نشود، کل تصویر WIM استخراج می‌شود. در غیر این صورت، هر آرگومان اضافی اگر با نویسه‌ی «@» آغاز نشود به عنوان یک \fIPATH\fR، و اگر آغاز شود به عنوان یک \fILISTFILE\fR تفسیر می‌شود. هر \fIPATH\fR یک فایل یا درخت دایرکتوری درون تصویر WIM را برای استخراج مشخص می‌کند، در حالی که هر \fILISTFILE\fR فایلی را مشخص می‌کند که خود حاوی فهرستی از مسیرها برای استخراج است. اگر مقدار \fILISTFILE\fR برابر «-» باشد (یعنی کل آرگومان «@-» باشد)، فایل فهرست از ورودی استاندارد خوانده می‌شود. برای جزئیات بیشتر به بخش \fBمسیرها و فایل‌های فهرست (PATHS AND LISTFILES)\fR مراجعه کنید.
.PP
به‌طور پیش‌فرض، فایل‌ها و دایرکتوری‌ها در دایرکتوری جاری استخراج می‌شوند. برای انتخاب یک دایرکتوری مقصد متفاوت از \fB--dest-dir\fR استفاده کنید. همچنین می‌توانید از \fB--to-stdout\fR برای استخراج یک فایل به خروجی استاندارد جهت هدایت از طریق لوله (pipe) به برنامه‌ای دیگر استفاده نمایید.
.PP
فایل یا دایرکتوری استخراج‌شده از یک آرگومان \fIPATH\fR به‌طور پیش‌فرض مستقیماً در دایرکتوری مقصد استخراج می‌شود، در حالی که فایل یا دایرکتوری استخراج‌شده از یک آرگومان \fILISTFILE\fR به‌طور پیش‌فرض به‌گونه‌ای در دایرکتوری مقصد استخراج می‌شود که ساختار دایرکتوری بایگانی حفظ شود. برای اعمال همیشگی این رفتار اخیر، از \fB--preserve-dir-structure\fR استفاده کنید.
.PP
دستور \fBwimextract\fR از استخراج فایل‌ها و درخت‌های دایرکتوری از WIMهای مستقل و همچنین WIMهای چندبخشی (split) پشتیبانی می‌کند. بخش \fBتصاویر WIM چندبخشی (SPLIT WIMS)\fR را ببینید.
.SH "مسیرها و فایل‌های فهرست (PATHS AND LISTFILES)"
هر مسیر، از جمله مسیرهای خط فرمان و مسیرهای درون فایل‌های فهرست، باید به صورت یک مسیر مطلق که از ریشه‌ی تصویر WIM آغاز می‌شود مشخص گردد، درست مانند مواردی که توسط \fBwimdir\fR(1) خروجی داده می‌شوند. با این حال، جداکننده‌های مسیر می‌توانند ممیز رو به جلو (/) یا ممیز رو به عقب (\) باشند و ممیز ابتدایی اختیاری است.
.PP
در ویندوز، به‌طور پیش‌فرض با مسیرها بدون حساسیت به حروف بزرگ و کوچک رفتار می‌شود، در حالی که در سیستم‌های شبه‌یونیکس، به‌طور پیش‌فرض مسیرها به حروف بزرگ و کوچک حساس هستند. در هر دو حالت، رفتار پیش‌فرض می‌تواند از طریق متغیر محیطی \fBWIMLIB_IMAGEX_IGNORE_CASE\fR، همان‌طور که در \fBwimlib-imagex\fR(1) مستند شده است، لغو و بازنویسی شود.
.PP
به‌طور پیش‌فرض، هر مسیر می‌تواند حاوی نویسه‌های عام (wildcard) «?» و «*» باشد. نویسه‌ی «?» با هر نویسه‌ای غیر از جداکننده‌ی مسیر مطابقت می‌یابد، در حالی که نویسه‌ی «*» با صفر یا چند نویسه‌ی غیر از جداکننده‌ی مسیر مطابقت دارد. در نتیجه، یک مسیر حاوی نویسه عام (یا «glob») ممکن است به چندین فایل یا دایرکتوری واقعی بسط یابد. برای غیرفعال کردن تطبیق نویسه‌های عام و جستجوی واژه‌به‌واژه (تحت‌اللفظی) برای هر مسیر، از گزینه‌ی \fB--no-globs\fR استفاده کنید.
.PP
هر \fILISTFILE\fR باید یک فایل متنی (با کدگذاری UTF-8 یا UTF-16LE؛ اسکی ساده نیز پذیرفته است) باشد که فهرستی از مسیرها برای استخراج را، در هر سطر یک مسیر، در بر دارد. نویسه‌های عام به‌طور پیش‌فرض مجاز هستند. نمونه‌ی زیر یک فایل فهرست را نشان می‌دهد:
.PP
.RS
.nf

; This is a comment (begins with semicolon)
# This is also a comment (begins with number sign)
/Users
/Windows/explorer.exe
/Windows/System32/en-US/*

; Both forward and backslashes are valid.
; It's not necessary to quote paths containing internal spaces.
\\Program Files\\A*

; Leading and trailing whitespace is ignored
    \\Windows\\notepad*

.SH "تصاویر WIM چندبخشی (SPLIT WIMS)"
می‌توانید از \fBwimextract\fR برای استخراج فایل‌ها یا درخت‌های دایرکتوری از یک WIM چندبخشی استفاده کنید. این کار با استفاده از گزینه‌ی \fB--refs\fR="\fIGLOB\fR" درست به همان شیوه‌ی دستورهای دیگری چون \fBwimapply\fR انجام می‌شود. برای جزئیات بیشتر به \fBwimapply\fR(1) مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP 6
\fB--check\fR
پیش از استخراج فایل‌ها، در صورتی که \fIWIMFILE\fR حاوی اطلاعات یکپارچگی اضافی باشد، یکپارچگی آن را بررسی می‌کند.
.TP
\fB--ref\fR="\fIGLOB\fR"
الگوی نام فایل (glob) برای WIMهای اضافی یا بخش‌های WIM چندبخشی جهت ارجاع به منابع موجود در آن‌ها. بخش \fBتصاویر WIM چندبخشی (SPLIT WIMS)\fR را ببینید. نکته: \fIGLOB\fR در نشانه‌های نقل‌قول آورده شده است زیرا توسط \fBwimextract\fR تفسیر می‌شود و ممکن است لازم باشد برای جلوگیری از بسط توسط پوسته، درون نقل‌قول قرار گیرد.
.TP
\fB--dest-dir\fR=\fIDIR\fR
فایل‌ها و دایرکتوری‌ها را به جای دایرکتوری کاری جاری، در دایرکتوری \fIDIR\fR استخراج می‌کند.
.TP
\fB--to-stdout\fR
فایل‌ها را به جای سیستم‌فایل در خروجی استاندارد استخراج می‌کند. این گزینه تنها زمانی قابل ارائه است که همه‌ی مسیرهای مشخص‌شده مربوط به فایل‌های عادی باشند (نه دایرکتوری‌ها یا نقاط بازکاوی). در صورت وجود، جریان‌های داده‌ی نام‌گذاری‌شده (named data streams) استخراج نمی‌شوند.
.TP
\fB--unix-data\fR
مستندات این گزینه را در \fBwimapply\fR(1) ببینید.
.TP
\fB--no-acls\fR
مستندات این گزینه را در \fBwimapply\fR(1) ببینید.
.TP
\fB--strict-acls\fR
مستندات این گزینه را در \fBwimapply\fR(1) ببینید.
.TP
\fB--no-attributes\fR
مستندات این گزینه را در \fBwimapply\fR(1) ببینید.
.TP
\fB--include-invalid-names\fR
مستندات این گزینه را در \fBwimapply\fR(1) ببینید.
.TP
\fB--no-globs\fR
نویسه‌های عام را در مسیرها شناسایی نمی‌کند. هر مسیر به‌صورت واژه‌به‌واژه (تحت‌اللفظی) جستجو خواهد شد. علاوه‌بر این، در صورت فعال بودن عدم حساسیت به بزرگی و کوچکی حروف، اجازه نمی‌دهد یک مسیر واحد با چندین فایل که نام‌های یکسان بدون حساسیت به حروف ولی متفاوت با حساسیت به حروف دارند مطابقت یابد.
.IP
گزینه‌ی \fB--no-wildcards\fR نیز به عنوان یک نام مستعار برای این گزینه پذیرفته می‌شود.
.TP
\fB--nullglob\fR
اگر یک الگوی عام (glob) با هیچ فایلی مطابقت پیدا نکند، به جای شکست با یک خطا، آن را نادیده گرفته و یک هشدار چاپ می‌کند. به عبارت دیگر، این گزینه به یک glob اجازه می‌دهد تا با موفقیت با صفر فایل مطابقت یابد.
.IP
این گزینه بر مسیرهایی که شامل نویسه‌های عام نیستند نیز تأثیر می‌گذارد، زیرا چنین مسیرهایی همچنان glob در نظر گرفته می‌شوند مگر اینکه \fB--no-globs\fR فعال باشد. در صورت فعال بودن عدم حساسیت به بزرگی و کوچکی حروف، چنین الگویی می‌تواند با چندین فایل با نام یکسان بدون حساسیت به حروف ولی متفاوت با حساسیت به حروف مطابقت یابد، در حالی که یک مسیر غیر-glob (با \fB--no-globs\fR) حداکثر می‌تواند با یک فایل مطابقت داشته باشد.
.TP
\fB--preserve-dir-structure\fR
هنگام استخراج مسیرها، به جای استخراج مستقیم فایل یا درخت دایرکتوری مشخص‌شده توسط هر مسیر در دایرکتوری مقصد، ساختار دایرکتوری بایگانی را حفظ می‌کند. نکته: \fB--preserve-dir-structure\fR در حال حاضر رفتار پیش‌فرض برای مسیرهای موجود در فایل‌های فهرست است، اما برای مسیرهایی که مستقیماً در خط فرمان مشخص می‌شوند پیش‌فرض نیست.
.TP
\fB--wimboot\fR
مستندات این گزینه را در \fBwimapply\fR(1) ببینید.
.TP
\fB--compact\fR=\fIFORMAT\fR
مستندات این گزینه را در \fBwimapply\fR(1) ببینید.
.TP
\fB--recover-data\fR
مستندات این گزینه را در \fBwimapply\fR(1) ببینید.
.SH "نکات (NOTES)"
برای اطلاعات در مورد اینکه چه داده‌ها و فراداده‌هایی در سیستم‌های شبه‌یونیکس در مقایسه با ویندوز استخراج می‌شوند، به \fBwimapply\fR(1) مراجعه کنید.
.PP
اصلاحات نقاط بازکاوی (Reparse-point fixups یا همان تغییر پیوندهای نمادین مطلق و junctionها برای اشاره به درون محل استخراج) هرگز توسط \fBwimextract\fR انجام نمی‌شود. اگر این رفتار را می‌خواهید، از \fBwimapply\fR استفاده کنید.
.PP
برخلاف \fBwimapply\fR، دستور \fBwimextract\fR از استخراج مستقیم فایل‌ها در یک حجم NTFS با استفاده از libntfs-3g پشتیبانی نمی‌کند.
.SH "مثال‌ها (EXAMPLES)"
استخراج یک فایل از نخستین تصویر در «boot.wim» به دایرکتوری جاری:
.RS
.PP
wimextract boot.wim 1 /Windows/System32/notepad.exe
.RE
.PP
استخراج یک فایل از نخستین تصویر در «boot.wim» به خروجی استاندارد:
.RS
.PP
wimextract boot.wim 1 /Windows/System32/notepad.exe --to-stdout
.RE
.PP
استخراج یک فایل از نخستین تصویر در «boot.wim» به دایرکتوری مشخص‌شده:
.RS
.PP
wimextract boot.wim 1 /Windows/System32/notepad.exe \\
.br
.RS
--dest-dir=somedir
.RE
.RE
.PP
استخراج دایرکتوری «sources» از نخستین تصویر در «boot.wim» به دایرکتوری جاری:
.RS
.PP
wimextract boot.wim 1 /sources
.RE
.PP
استخراج چندین فایل و دایرکتوری در یک دستور:
.RS
.PP
wimextract boot.wim 1 /Windows/Fonts \\
.br
.RS
/sources /Windows/System32/cmd.exe
.RE
.RE
.PP
استخراج چندین فایل به دایرکتوری جاری با استفاده از یک الگوی نویسه عام (wildcard):
.RS
.PP
wimextract install.wim 1 "/Windows/Fonts/*.ttf"
.RE
.PP
استخراج فایل‌ها با استفاده از یک فایل فهرست:
.RS
.PP
wimextract install.wim 1 @files.txt
.RE
.PP
 ... که در آن files.txt می‌تواند چیزی شبیه به این باشد:
.PP
.RS
.RS
.nf
Windows\\System32\\*.*
Windows\\System32\\??-??\\*.*
Windows\\System32\\en-US\\*.*
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR wimlib-imagex (1)
.BR wimapply (1)
.BR wimdir (1)
.BR wiminfo (1)