.\"-
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.\" Copyright (c) 2007-2008 Dag-Erling Smørgrav
.\" All rights reserved.
.\"
.Dd June 27, 2023
.Dt BSDUNZIP 1
.Os
.Sh "نام (NAME)"
.Nm bsdunzip
.Nd استخراج فایلها از یک بایگانی ZIP
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl aCcfjLlnopqtuvy
.Op { Fl O | Fl I No } Ar encoding
.Op Fl d Ar dir
.Op Fl x Ar pattern
.Op Fl P Ar password
.Ar zipfile
.Op Ar member ...
.Sh "توضیحات (DESCRIPTION)"
.\" ...
گزینه‌های زیر در دسترس هستند:
.Bl -tag -width Fl
.It Fl a
هنگام استخراج یک فایل متنی، پایان خطوط به سبک DOS را به پایان خطوط به سبک Unix تبدیل می‌کند.
.It Fl C
تطبیق نام فایل‌ها بدون در نظر گرفتن بزرگی و کوچکی حروف (غیرحساس به حروف کوچک و بزرگ).
.It Fl c
استخراج در خروجی استاندارد (stdout) / صفحه‌نمایش.
هنگام استخراج فایل‌ها از فایل zip، آن‌ها در stdout نوشته می‌شوند.
این شبیه به
.Fl p
است، اما خروجی معمول را سرکوب نمی‌کند.
.It Fl d Ar dir
فایل‌ها را به‌جای دایرکتوری جاری در دایرکتوری مشخص‌شده استخراج می‌کند.
.It Fl f
به‌روزرسانی موارد موجود.
تنها در صورتی فایل‌ها را از فایل zip استخراج می‌کند که فایلی با همان نام از پیش روی دیسک موجود بوده و از فایل درون بایگانی قدیمی‌تر باشد.
در غیر این صورت، از استخراج فایل بدون نمایش پیام صرف‌نظر می‌شود.
.It Fl I Ar encoding
.It Fl O Ar encoding
تبدیل نام فایل‌ها از کدگذاری مشخص‌شده.
.It Fl j
نادیده گرفتن دایرکتوری‌های ذخیره‌شده در فایل zip؛ در عوض، تمام فایل‌ها مستقیماً در دایرکتوری استخراج باز می‌شوند.
.It Fl L
تبدیل نام فایل‌ها و دایرکتوری‌های استخراج‌شده به حروف کوچک.
.It Fl l
فهرست کردن محتویات فایل zip به‌جای استخراج آن‌ها.
.It Fl n
عدم بازنویسی.
هنگام استخراج یک فایل از فایل zip، اگر فایلی با همان نام از پیش روی دیسک وجود داشته باشد، بدون نمایش پیام از آن صرف‌نظر می‌شود.
.It Fl o
بازنویسی.
هنگام استخراج یک فایل از فایل zip، اگر فایلی با همان نام از پیش روی دیسک وجود داشته باشد، فایل موجود با فایل درون بایگانی جایگزین می‌شود.
.It Fl p
استخراج در خروجی استاندارد (stdout).
هنگام استخراج فایل‌ها از فایل zip، آن‌ها در stdout نوشته می‌شوند.
خروجی معمول مانند زمانی که گزینهٔ
.Fl q
مشخص شده باشد سرکوب می‌شود.
.It Fl P Ar password
استخراج فایل‌های رمزگذاری‌شده با استفاده از یک گذرواژه.
قرار دادن گذرواژه در خط فرمان با استفاده از این گزینه می‌تواند ناامن باشد.
.It Fl q
ساکت: نمایش اطلاعات کمتر در حین استخراج.
.It Fl t
آزمایش: هیچ فایلی استخراج نمی‌شود، اما مجموع مقابله‌ای (checksum) هر فایل در بایگانی اعتبارسنجی می‌شود.
.It Fl u
به‌روزرسانی.
هنگام استخراج یک فایل از فایل zip، اگر فایلی با همان نام از پیش روی دیسک وجود داشته باشد، فایل موجود تنها در صورتی با فایل بایگانی جایگزین می‌شود که فایل بایگانی جدیدتر از فایل روی دیسک باشد.
در غیر این صورت، بدون نمایش پیام از استخراج فایل صرف‌نظر می‌شود.
.It Fl v
فهرست کردن محتویات فایل zip به صورت پرگویی (verbose) به‌جای استخراج آن‌ها.
این گزینه با
.Fl l
از این نظر تفاوت دارد که از فهرست‌بندی طولانی استفاده می‌کند.
توجه داشته باشید که بیشتر داده‌ها در حال حاضر ساختگی هستند و محتوای واقعی بایگانی را منعکس نمی‌کنند.
.It Fl x Ar pattern
مستثنی کردن فایل‌های منطبق با الگوی
.Ar pattern .
.It Fl y
چاپ سال‌ها با چهار رقم به‌جای دو رقم در فهرست‌ها.
.It Fl Z Ar mode
شبیه‌سازی حالت
.Xr zipinfo 1L .
فعال کردن حالت
.Xr zipinfo 1L
نحوهٔ تجزیهٔ آرگومان‌های اضافی را تغییر می‌دهد.
در حال حاضر تنها حالت ۱ از
.Xr zipinfo 1L
پشتیبانی می‌شود که نام فایل‌ها را در هر خط یکی فهرست می‌کند.
.It Ar [member ...]
فهرست اختیاری از اعضا برای استخراج از فایل zip.
می‌تواند شامل الگوها باشد؛ به عنوان مثال،
.Ar 'memberdir/*'
تمام فایل‌ها و دایرکتوری‌های زیر memberdir را استخراج می‌کند.
.El
.Pp
توجه داشته باشید که تنها یکی از گزینه‌های
.Fl n ,
.Fl o
و
.Fl u
می‌تواند مشخص شود.
اگر نام فایل مشخص‌شده
.Qq -
باشد، داده‌ها از
.Va stdin
خوانده می‌شوند.
.Sh "محیط (ENVIRONMENT)"
اگر متغیر محیطی
.Ev UNZIP_DEBUG
تعریف شده باشد، گزینهٔ خط فرمان
.Fl q
بی‌اثر خواهد بود و اطلاعات اشکال‌زدایی اضافی در
.Va stderr
چاپ خواهد شد.
.Sh "سازگاری (COMPATIBILITY)"
ابزار
.Nm
هدفش این است که به اندازهٔ کافی با پیاده‌سازی‌های دیگر سازگار باشد تا بتواند به عنوان جایگزینی مستقیم در بستر سیستم
.Xr ports 7
عمل کند.
هیچ تلاشی برای بازتولید عملکردهایی که برای این هدف لازم نیستند صورت نگرفته است.
.Pp
به دلایل سازگاری، گزینه‌های خط فرمان در صورتی که نه تنها قبل از نام فایل zip بلکه بعد از آن نیز درج شوند شناسایی خواهند شد.
.Pp
به طور معمول، گزینهٔ
.Fl a
تنها باید بر فایل‌هایی تأثیر بگذارد که در دایرکتوری مرکزی (central directory) فایل zip به عنوان فایل‌های متنی علامت‌گذاری شده‌اند.
از آنجا که کتابخانهٔ
.Xr archive 3
دسترسی به این اطلاعات را فراهم نمی‌کند، این اطلاعات در دسترس ابزار
.Nm
نیست.
در عوض، ابزار
.Nm
فرض می‌کند فایلی متنی است اگر هیچ نویسهٔ غیر ASCII در نخستین بلوک داده‌های از حالت فشرده خارج‌شده برای آن فایل وجود نداشته باشد.
اگر نویسه‌های غیر ASCII در بلوک‌های بعدی داده‌ها ظاهر شوند، یک هشدار صادر خواهد شد.
.Pp
ابزار
.Nm
تنها قادر به پردازش بایگانی‌های ZIP است که توسط
.Xr libarchive 3
پشتیبانی می‌شوند.
بسته به نسخهٔ نصب‌شدهٔ
.Xr libarchive 3 ,
این ممکن است شامل بایگانی‌های خوداستخراج‌شونده (self-extracting) یا ZIPX باشد یا نباشد.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr libarchive 3
.Sh "تاریخچه (HISTORY)"
ابزار
.Nm
در
.Fx 8.0
ظاهر شد.
.Sh "نویسندگان (AUTHORS)"
ابزار
.Nm
و این صفحهٔ راهنما توسط
.An Dag-Erling Sm\(/orgrav Aq Mt des@FreeBSD.org
نوشته شده است.
این ابزار از کتابخانهٔ
.Xr archive 3
توسعه‌یافته توسط
.An Tim Kientzle Aq Mt kientzle@FreeBSD.org
استفاده می‌کند.
.Sh "هشدارها (CAVEATS)"
ابزار
.Nm
خط فرمان را دو بار برای بررسی آرگومان‌های قبل و بعد از نام بایگانی پیمایش می‌کند تا سازگاری با Info-ZIP unzip حفظ شود.
در نتیجه، رشتهٔ دوخط‌تیرهٔ
.Ql --
در POSIX که برای جداسازی گزینه‌ها از آرگومان‌ها استفاده می‌شود باید تکرار شود.
به عنوان مثال، برای استخراج فایل «-a.jpg» از «-b.zip» همراه با بازنویسی، باید دستور زیر اجرا شود:
.Dl bsdunzip -o -- -a.jpg -- -b.zip