نام (NAME)

wimextract - استخراج فایل‌ها از یک تصویر WIM

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

wimextract WIMFILE IMAGE [(PATH | @LISTFILE)...] [OPTION...]

توضیحات (DESCRIPTION)

دستور wimextract، یا معادل آن wimlib-imagex extract، یک یا چند فایل یا درخت دایرکتوری را از IMAGE مشخص‌شده درون بایگانی (WIM) Windows Imaging به نام WIMFILE استخراج می‌کند.

دستور wimextract برای استخراج تنها زیرمجموعه‌ای از یک تصویر WIM در نظر گرفته شده است. اگر می‌خواهید یک تصویر WIM کامل را در یک دایرکتوری یا حجم دیسک NTFS استخراج یا «اعمال» (apply) کنید، به جای آن از wimapply(1) استفاده نمایید.

پارامتر IMAGE تصویری را در WIMFILE مشخص می‌کند که فایل‌ها یا درخت‌های دایرکتوری باید از آن استخراج شوند. این مقدار می‌تواند نمایه‌ی ۱-پایه (1-based index) یک تصویر یا نام آن باشد. اگر WIMFILE تنها شامل یک تصویر باشد، می‌توان از این مقدار صرف‌نظر کرد. برای فهرست کردن تصاویر موجود در WIMFILE می‌توانید از wiminfo(1) استفاده کنید.

اگر هیچ آرگومان اضافی داده نشود، کل تصویر WIM استخراج می‌شود. در غیر این صورت، هر آرگومان اضافی اگر با نویسه‌ی «@» آغاز نشود به عنوان یک PATH، و اگر آغاز شود به عنوان یک LISTFILE تفسیر می‌شود. هر PATH یک فایل یا درخت دایرکتوری درون تصویر WIM را برای استخراج مشخص می‌کند، در حالی که هر LISTFILE فایلی را مشخص می‌کند که خود حاوی فهرستی از مسیرها برای استخراج است. اگر مقدار LISTFILE برابر «-» باشد (یعنی کل آرگومان «@-» باشد)، فایل فهرست از ورودی استاندارد خوانده می‌شود. برای جزئیات بیشتر به بخش مسیرها و فایل‌های فهرست (PATHS AND LISTFILES) مراجعه کنید.

به‌طور پیش‌فرض، فایل‌ها و دایرکتوری‌ها در دایرکتوری جاری استخراج می‌شوند. برای انتخاب یک دایرکتوری مقصد متفاوت از --dest-dir استفاده کنید. همچنین می‌توانید از --to-stdout برای استخراج یک فایل به خروجی استاندارد جهت هدایت از طریق لوله (pipe) به برنامه‌ای دیگر استفاده نمایید.

فایل یا دایرکتوری استخراج‌شده از یک آرگومان PATH به‌طور پیش‌فرض مستقیماً در دایرکتوری مقصد استخراج می‌شود، در حالی که فایل یا دایرکتوری استخراج‌شده از یک آرگومان LISTFILE به‌طور پیش‌فرض به‌گونه‌ای در دایرکتوری مقصد استخراج می‌شود که ساختار دایرکتوری بایگانی حفظ شود. برای اعمال همیشگی این رفتار اخیر، از --preserve-dir-structure استفاده کنید.

دستور wimextract از استخراج فایل‌ها و درخت‌های دایرکتوری از WIMهای مستقل و همچنین WIMهای چندبخشی (split) پشتیبانی می‌کند. بخش تصاویر WIM چندبخشی (SPLIT WIMS) را ببینید.

مسیرها و فایل‌های فهرست (PATHS AND LISTFILES)

هر مسیر، از جمله مسیرهای خط فرمان و مسیرهای درون فایل‌های فهرست، باید به صورت یک مسیر مطلق که از ریشه‌ی تصویر WIM آغاز می‌شود مشخص گردد، درست مانند مواردی که توسط wimdir(1) خروجی داده می‌شوند. با این حال، جداکننده‌های مسیر می‌توانند ممیز رو به جلو (/) یا ممیز رو به عقب ( باشند و ممیز ابتدایی اختیاری است.

در ویندوز، به‌طور پیش‌فرض با مسیرها بدون حساسیت به حروف بزرگ و کوچک رفتار می‌شود، در حالی که در سیستم‌های شبه‌یونیکس، به‌طور پیش‌فرض مسیرها به حروف بزرگ و کوچک حساس هستند. در هر دو حالت، رفتار پیش‌فرض می‌تواند از طریق متغیر محیطی WIMLIB_IMAGEX_IGNORE_CASE، همان‌طور که در wimlib-imagex(1) مستند شده است، لغو و بازنویسی شود.

به‌طور پیش‌فرض، هر مسیر می‌تواند حاوی نویسه‌های عام (wildcard) «?» و «*» باشد. نویسه‌ی «?» با هر نویسه‌ای غیر از جداکننده‌ی مسیر مطابقت می‌یابد، در حالی که نویسه‌ی «*» با صفر یا چند نویسه‌ی غیر از جداکننده‌ی مسیر مطابقت دارد. در نتیجه، یک مسیر حاوی نویسه عام (یا «glob») ممکن است به چندین فایل یا دایرکتوری واقعی بسط یابد. برای غیرفعال کردن تطبیق نویسه‌های عام و جستجوی واژه‌به‌واژه (تحت‌اللفظی) برای هر مسیر، از گزینه‌ی --no-globs استفاده کنید.

هر LISTFILE باید یک فایل متنی (با کدگذاری UTF-8 یا UTF-16LE؛ اسکی ساده نیز پذیرفته است) باشد که فهرستی از مسیرها برای استخراج را، در هر سطر یک مسیر، در بر دارد. نویسه‌های عام به‌طور پیش‌فرض مجاز هستند. نمونه‌ی زیر یک فایل فهرست را نشان می‌دهد:

; 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*

تصاویر WIM چندبخشی (SPLIT WIMS)

می‌توانید از wimextract برای استخراج فایل‌ها یا درخت‌های دایرکتوری از یک WIM چندبخشی استفاده کنید. این کار با استفاده از گزینه‌ی --refs="GLOB" درست به همان شیوه‌ی دستورهای دیگری چون wimapply انجام می‌شود. برای جزئیات بیشتر به wimapply(1) مراجعه کنید.

گزینه‌ها (OPTIONS)

--check: پیش از استخراج فایل‌ها، در صورتی که WIMFILE حاوی اطلاعات یکپارچگی اضافی باشد، یکپارچگی آن را بررسی می‌کند.
--ref="GLOB": الگوی نام فایل (glob) برای WIMهای اضافی یا بخش‌های WIM چندبخشی جهت ارجاع به منابع موجود در آن‌ها. بخش تصاویر WIM چندبخشی (SPLIT WIMS) را ببینید. نکته: GLOB در نشانه‌های نقل‌قول آورده شده است زیرا توسط wimextract تفسیر می‌شود و ممکن است لازم باشد برای جلوگیری از بسط توسط پوسته، درون نقل‌قول قرار گیرد.
--dest-dir=DIR: فایل‌ها و دایرکتوری‌ها را به جای دایرکتوری کاری جاری، در دایرکتوری DIR استخراج می‌کند.
--to-stdout: فایل‌ها را به جای سیستم‌فایل در خروجی استاندارد استخراج می‌کند. این گزینه تنها زمانی قابل ارائه است که همه‌ی مسیرهای مشخص‌شده مربوط به فایل‌های عادی باشند (نه دایرکتوری‌ها یا نقاط بازکاوی). در صورت وجود، جریان‌های داده‌ی نام‌گذاری‌شده (named data streams) استخراج نمی‌شوند.
--unix-data: مستندات این گزینه را در wimapply(1) ببینید.
--no-acls: مستندات این گزینه را در wimapply(1) ببینید.
--strict-acls: مستندات این گزینه را در wimapply(1) ببینید.
--no-attributes: مستندات این گزینه را در wimapply(1) ببینید.
--include-invalid-names: مستندات این گزینه را در wimapply(1) ببینید.
--no-globs: نویسه‌های عام را در مسیرها شناسایی نمی‌کند. هر مسیر به‌صورت واژه‌به‌واژه (تحت‌اللفظی) جستجو خواهد شد. علاوه‌بر این، در صورت فعال بودن عدم حساسیت به بزرگی و کوچکی حروف، اجازه نمی‌دهد یک مسیر واحد با چندین فایل که نام‌های یکسان بدون حساسیت به حروف ولی متفاوت با حساسیت به حروف دارند مطابقت یابد.

: گزینه‌ی --no-wildcards نیز به عنوان یک نام مستعار برای این گزینه پذیرفته می‌شود.

--nullglob: اگر یک الگوی عام (glob) با هیچ فایلی مطابقت پیدا نکند، به جای شکست با یک خطا، آن را نادیده گرفته و یک هشدار چاپ می‌کند. به عبارت دیگر، این گزینه به یک glob اجازه می‌دهد تا با موفقیت با صفر فایل مطابقت یابد.

: این گزینه بر مسیرهایی که شامل نویسه‌های عام نیستند نیز تأثیر می‌گذارد، زیرا چنین مسیرهایی همچنان glob در نظر گرفته می‌شوند مگر اینکه --no-globs فعال باشد. در صورت فعال بودن عدم حساسیت به بزرگی و کوچکی حروف، چنین الگویی می‌تواند با چندین فایل با نام یکسان بدون حساسیت به حروف ولی متفاوت با حساسیت به حروف مطابقت یابد، در حالی که یک مسیر غیر-glob (با --no-globs) حداکثر می‌تواند با یک فایل مطابقت داشته باشد.

--preserve-dir-structure: هنگام استخراج مسیرها، به جای استخراج مستقیم فایل یا درخت دایرکتوری مشخص‌شده توسط هر مسیر در دایرکتوری مقصد، ساختار دایرکتوری بایگانی را حفظ می‌کند. نکته: --preserve-dir-structure در حال حاضر رفتار پیش‌فرض برای مسیرهای موجود در فایل‌های فهرست است، اما برای مسیرهایی که مستقیماً در خط فرمان مشخص می‌شوند پیش‌فرض نیست.
--wimboot: مستندات این گزینه را در wimapply(1) ببینید.
--compact=FORMAT: مستندات این گزینه را در wimapply(1) ببینید.
--recover-data: مستندات این گزینه را در wimapply(1) ببینید.

نکات (NOTES)

برای اطلاعات در مورد اینکه چه داده‌ها و فراداده‌هایی در سیستم‌های شبه‌یونیکس در مقایسه با ویندوز استخراج می‌شوند، به wimapply(1) مراجعه کنید.

اصلاحات نقاط بازکاوی (Reparse-point fixups یا همان تغییر پیوندهای نمادین مطلق و junctionها برای اشاره به درون محل استخراج) هرگز توسط wimextract انجام نمی‌شود. اگر این رفتار را می‌خواهید، از wimapply استفاده کنید.

برخلاف wimapply، دستور wimextract از استخراج مستقیم فایل‌ها در یک حجم NTFS با استفاده از libntfs-3g پشتیبانی نمی‌کند.

مثال‌ها (EXAMPLES)

استخراج یک فایل از نخستین تصویر در «boot.wim» به دایرکتوری جاری:

wimextract boot.wim 1 /Windows/System32/notepad.exe

استخراج یک فایل از نخستین تصویر در «boot.wim» به خروجی استاندارد:

wimextract boot.wim 1 /Windows/System32/notepad.exe --to-stdout

استخراج یک فایل از نخستین تصویر در «boot.wim» به دایرکتوری مشخص‌شده:

wimextract boot.wim 1 /Windows/System32/notepad.exe \

--dest-dir=somedir

استخراج دایرکتوری «sources» از نخستین تصویر در «boot.wim» به دایرکتوری جاری:

wimextract boot.wim 1 /sources

استخراج چندین فایل و دایرکتوری در یک دستور:

wimextract boot.wim 1 /Windows/Fonts \

/sources /Windows/System32/cmd.exe

استخراج چندین فایل به دایرکتوری جاری با استفاده از یک الگوی نویسه عام (wildcard):

wimextract install.wim 1 "/Windows/Fonts/*.ttf"

استخراج فایل‌ها با استفاده از یک فایل فهرست:

wimextract install.wim 1 @files.txt

... که در آن files.txt می‌تواند چیزی شبیه به این باشد:

Windows\System32\*.*
Windows\System32\??-??\*.*
Windows\System32\en-US\*.*

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

wimlib-imagex(1) wimapply(1) wimdir(1) wiminfo(1)