نام (NAME)

bsdunzip — استخراج فایلها از یک بایگانی ZIP

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

bsdunzip [-aCcfjLlnopqtuvy] [{ -O | -I } encoding] [-d dir] [-x pattern] [-P password] zipfile [member ...]

توضیحات (DESCRIPTION)

گزینه‌های زیر در دسترس هستند:

-a

هنگام استخراج یک فایل متنی، پایان خطوط به سبک DOS را به پایان خطوط به سبک Unix تبدیل می‌کند.

-C

تطبیق نام فایل‌ها بدون در نظر گرفتن بزرگی و کوچکی حروف (غیرحساس به حروف کوچک و بزرگ).

-c

استخراج در خروجی استاندارد (stdout) / صفحه‌نمایش. هنگام استخراج فایل‌ها از فایل zip، آن‌ها در stdout نوشته می‌شوند. این شبیه به -p است، اما خروجی معمول را سرکوب نمی‌کند.

-d dir

فایل‌ها را به‌جای دایرکتوری جاری در دایرکتوری مشخص‌شده استخراج می‌کند.

-f

به‌روزرسانی موارد موجود. تنها در صورتی فایل‌ها را از فایل zip استخراج می‌کند که فایلی با همان نام از پیش روی دیسک موجود بوده و از فایل درون بایگانی قدیمی‌تر باشد. در غیر این صورت، از استخراج فایل بدون نمایش پیام صرف‌نظر می‌شود.

-I encoding

 

-O encoding

تبدیل نام فایل‌ها از کدگذاری مشخص‌شده.

-j

نادیده گرفتن دایرکتوری‌های ذخیره‌شده در فایل zip؛ در عوض، تمام فایل‌ها مستقیماً در دایرکتوری استخراج باز می‌شوند.

-L

تبدیل نام فایل‌ها و دایرکتوری‌های استخراج‌شده به حروف کوچک.

-l

فهرست کردن محتویات فایل zip به‌جای استخراج آن‌ها.

-n

عدم بازنویسی. هنگام استخراج یک فایل از فایل zip، اگر فایلی با همان نام از پیش روی دیسک وجود داشته باشد، بدون نمایش پیام از آن صرف‌نظر می‌شود.

-o

بازنویسی. هنگام استخراج یک فایل از فایل zip، اگر فایلی با همان نام از پیش روی دیسک وجود داشته باشد، فایل موجود با فایل درون بایگانی جایگزین می‌شود.

-p

استخراج در خروجی استاندارد (stdout). هنگام استخراج فایل‌ها از فایل zip، آن‌ها در stdout نوشته می‌شوند. خروجی معمول مانند زمانی که گزینهٔ -q مشخص شده باشد سرکوب می‌شود.

-P password

استخراج فایل‌های رمزگذاری‌شده با استفاده از یک گذرواژه. قرار دادن گذرواژه در خط فرمان با استفاده از این گزینه می‌تواند ناامن باشد.

-q

ساکت: نمایش اطلاعات کمتر در حین استخراج.

-t

آزمایش: هیچ فایلی استخراج نمی‌شود، اما مجموع مقابله‌ای (checksum) هر فایل در بایگانی اعتبارسنجی می‌شود.

-u

به‌روزرسانی. هنگام استخراج یک فایل از فایل zip، اگر فایلی با همان نام از پیش روی دیسک وجود داشته باشد، فایل موجود تنها در صورتی با فایل بایگانی جایگزین می‌شود که فایل بایگانی جدیدتر از فایل روی دیسک باشد. در غیر این صورت، بدون نمایش پیام از استخراج فایل صرف‌نظر می‌شود.

-v

فهرست کردن محتویات فایل zip به صورت پرگویی (verbose) به‌جای استخراج آن‌ها. این گزینه با -l از این نظر تفاوت دارد که از فهرست‌بندی طولانی استفاده می‌کند. توجه داشته باشید که بیشتر داده‌ها در حال حاضر ساختگی هستند و محتوای واقعی بایگانی را منعکس نمی‌کنند.

-x pattern

مستثنی کردن فایل‌های منطبق با الگوی pattern.

-y

چاپ سال‌ها با چهار رقم به‌جای دو رقم در فهرست‌ها.

-Z mode

شبیه‌سازی حالت zipinfo(1L). فعال کردن حالت zipinfo(1L) نحوهٔ تجزیهٔ آرگومان‌های اضافی را تغییر می‌دهد. در حال حاضر تنها حالت ۱ از zipinfo(1L) پشتیبانی می‌شود که نام فایل‌ها را در هر خط یکی فهرست می‌کند.

[member ...]

فهرست اختیاری از اعضا برای استخراج از فایل zip. می‌تواند شامل الگوها باشد؛ به عنوان مثال، 'memberdir/*' تمام فایل‌ها و دایرکتوری‌های زیر memberdir را استخراج می‌کند.

توجه داشته باشید که تنها یکی از گزینه‌های -n, -o و -u می‌تواند مشخص شود. اگر نام فایل مشخص‌شده "-" باشد، داده‌ها از stdin خوانده می‌شوند.

محیط (ENVIRONMENT)

اگر متغیر محیطی UNZIP_DEBUG تعریف شده باشد، گزینهٔ خط فرمان -q بی‌اثر خواهد بود و اطلاعات اشکال‌زدایی اضافی در stderr چاپ خواهد شد.

سازگاری (COMPATIBILITY)

ابزار bsdunzip هدفش این است که به اندازهٔ کافی با پیاده‌سازی‌های دیگر سازگار باشد تا بتواند به عنوان جایگزینی مستقیم در بستر سیستم ports(7) عمل کند. هیچ تلاشی برای بازتولید عملکردهایی که برای این هدف لازم نیستند صورت نگرفته است.

به دلایل سازگاری، گزینه‌های خط فرمان در صورتی که نه تنها قبل از نام فایل zip بلکه بعد از آن نیز درج شوند شناسایی خواهند شد.

به طور معمول، گزینهٔ -a تنها باید بر فایل‌هایی تأثیر بگذارد که در دایرکتوری مرکزی (central directory) فایل zip به عنوان فایل‌های متنی علامت‌گذاری شده‌اند. از آنجا که کتابخانهٔ archive(3) دسترسی به این اطلاعات را فراهم نمی‌کند، این اطلاعات در دسترس ابزار bsdunzip نیست. در عوض، ابزار bsdunzip فرض می‌کند فایلی متنی است اگر هیچ نویسهٔ غیر ASCII در نخستین بلوک داده‌های از حالت فشرده خارج‌شده برای آن فایل وجود نداشته باشد. اگر نویسه‌های غیر ASCII در بلوک‌های بعدی داده‌ها ظاهر شوند، یک هشدار صادر خواهد شد.

ابزار bsdunzip تنها قادر به پردازش بایگانی‌های ZIP است که توسط libarchive(3) پشتیبانی می‌شوند. بسته به نسخهٔ نصب‌شدهٔ libarchive(3), این ممکن است شامل بایگانی‌های خوداستخراج‌شونده (self-extracting) یا ZIPX باشد یا نباشد.

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

libarchive(3)

تاریخچه (HISTORY)

ابزار bsdunzip در FreeBSD 8.0 ظاهر شد.

نویسندگان (AUTHORS)

ابزار bsdunzip و این صفحهٔ راهنما توسط Dag-Erling Smørgrav <des@FreeBSD.org> نوشته شده است. این ابزار از کتابخانهٔ archive(3) توسعه‌یافته توسط Tim Kientzle <kientzle@FreeBSD.org> استفاده می‌کند.

هشدارها (CAVEATS)

ابزار bsdunzip خط فرمان را دو بار برای بررسی آرگومان‌های قبل و بعد از نام بایگانی پیمایش می‌کند تا سازگاری با Info-ZIP unzip حفظ شود. در نتیجه، رشتهٔ دوخط‌تیرهٔ ‘--’ در POSIX که برای جداسازی گزینه‌ها از آرگومان‌ها استفاده می‌شود باید تکرار شود. به عنوان مثال، برای استخراج فایل «-a.jpg» از «-b.zip» همراه با بازنویسی، باید دستور زیر اجرا شود: