.\"  Copyright (c) 1990-2009 Info-ZIP.  All rights reserved.
.\"
.\"  See the accompanying file LICENSE, version 2009-Jan-02 or later
.\"  (the contents of which are also included in unzip.h) for terms of use.
.\"  If, for some reason, all these files are missing, the Info-ZIP license
.\"  also may be found at:  ftp://ftp.info-zip.org/pub/infozip/license.html
.\"
.\" funzip.1 by Greg Roelofs and others.
.\"
.\" =========================================================================
.\" define .EX/.EE (for multiline user-command examples; normal Courier font)
.de EX
.in +4n
.nf
.ft CW
..
.de EE
.ft R
.fi
.in -4n
..
.\" =========================================================================
.TH FUNZIP 1L "20 April 2009 (v3.95)" "Info-ZIP"
.SH "نام (NAME)"
funzip \- فیلتری برای استخراج از یک بایگانی ZIP در یک pipe
.PD
.SH "خلاصه دستور (SYNOPSIS)"
\fBfunzip\fP [\fB\-password\fP] [\fIinput[.zip|.gz]\fP]
.\" =========================================================================
.SH "آرگومان‌ها (ARGUMENTS)"
.IP [\fI\-password\fP]
گذرواژهٔ اختیاری در صورتی که بایگانی ZIP رمزگذاری شده باشد. ممکن است رمزگشایی در برخی سامانه‌ها پشتیبانی نشود. برای جزئیات بیشتر به بخش «توضیحات» مراجعه کنید.
.IP [\fIinput[.zip|.gz]\fP]
مشخص کردن اختیاری فایل بایگانی ورودی. برای جزئیات به بخش «توضیحات» مراجعه کنید.
.PD
.\" =========================================================================
.SH "توضیحات (DESCRIPTION)"
برنامهٔ
.I funzip
بدون آرگومان فایل به عنوان یک فیلتر عمل می‌کند؛ به این معنا که فرض می‌کند یک بایگانی ZIP (یا یک فایل فشرده‌شده با
\fIgzip\fP(1))
از طریق یک لوله به ورودی استاندارد هدایت می‌شود، و نخستین عضو بایگانی را در stdout استخراج می‌کند.
هنگامی که stdin از یک دستگاه tty باشد،
.I funzip
فرض می‌کند که این نمی‌تواند جریانی از داده‌های فشرده‌شدهٔ (دودویی) باشد و در عوض یک متن راهنمای کوتاه نمایش می‌دهد.
اگر آرگومان فایل وجود داشته باشد، ورودی به جای stdin از فایل مشخص‌شده خوانده می‌شود.
.PP
گذرواژه برای فایل‌های zip رمزگذاری‌شده می‌تواند در خط فرمان (پیش از نام فایل، در صورت وجود) با قرار دادن یک خط تیره (\-) در ابتدای گذرواژه مشخص شود. توجه داشته باشید که این کار در بسیاری از سیستم‌ها یک مخاطرهٔ امنیتی به حساب می‌آید؛ فرایندهای در حال اجرا معمولاً از طریق دستورهای ساده (مانند
\fIps\fP(1)
در Unix) قابل مشاهده هستند و تاریخچهٔ خط فرمان نیز ممکن است خوانده شود.
اگر نخستین عضو فایل zip رمزگذاری شده باشد و هیچ گذرواژه‌ای در خط فرمان مشخص نشده باشد، گذرواژه از کاربر درخواست می‌شود و گذرواژه در کنسول نمایش (echo) داده نخواهد شد.
.PP
با توجه به محدودیت استخراج تک‌عضو، \fIfunzip\fP بیشترین کاربرد را همراه با یک برنامهٔ بایگانی‌ساز ثانویه مانند \fItar\fP(1) دارد. بخش بعدی شامل مثالی است که این کاربرد را در مورد پشتیبان‌گیری از دیسک روی نوار مغناطیسی نشان می‌دهد.
.PD
.\" =========================================================================
.SH "مثال‌ها (EXAMPLES)"
برای استفاده از \fIfunzip\fP جهت استخراج نخستین فایل عضو بایگانی test.zip و ارسال آن از طریق لوله به \fImore\fP(1):
.PP
.EX
funzip test.zip | more
.EE
.PP
برای استفاده از \fIfunzip\fP جهت آزمایش نخستین فایل عضو test.zip (هر خطایی در خروجی استاندارد خطا گزارش خواهد شد):
.PP
.EX
funzip test.zip > /dev/null
.EE
.PP
برای استفاده از \fIzip\fP و \fIfunzip\fP به جای \fIcompress\fP(1) و \fIzcat\fP(1) (یا \fIgzip\fP(1L) و \fIgzcat\fP(1L)) جهت پشتیبان‌گیری روی نوار:
.PP
.EX
tar cf \- . | zip \-7 | dd of=/dev/nrst0 obs=8k
dd if=/dev/nrst0 ibs=8k | funzip | tar xf \-
.EE
.PP
(که در آن، برای نمونه، nrst0 یک درایو نوار SCSI است).
.PD
.\" =========================================================================
.SH "گزارش باگ‌ها (BUGS)"
هنگامی که یک فایل رمزگذاری‌شده از طریق لوله به \fImore\fP فرستاده می‌شود و به \fIfunzip\fP اجازه داده می‌شود تا گذرواژه را درخواست کند، ممکن است ترمینال گاهی در وضعیت عدم نمایش کاراکترها (non-echo) باقی بماند. ظاهراً این امر ناشی از یک شرایط رقابتی (race condition) میان دو برنامه است؛ \fIfunzip\fP وضعیت ترمینال را پیش از اینکه \fImore\fP وضعیت آن را بخواند به non-echo تغییر می‌دهد، و سپس \fImore\fP پیش از خروج ترمینال را به این حالت «بازمی‌گرداند». برای بازیابی، \fIfunzip\fP را روی همان فایل اجرا کنید اما خروجی را به جای لوله‌کشی به more، به /dev/null هدایت کنید؛ پس از درخواست مجدد گذرواژه، \fIfunzip\fP ترمینال را به درستی تنظیم مجدد خواهد کرد.
.PP
در حال حاضر هیچ راهی برای استخراج عضوی به جز نخستین عضو از یک بایگانی ZIP وجود ندارد. این قابلیت در صورتی که یک بایگانی ZIP درون بایگانی دیگری گنجانده شده باشد مفید خواهد بود. در مواردی که نخستین عضو یک دایرکتوری باشد، \fIfunzip\fP صرفاً دایرکتوری را ایجاد کرده و خارج می‌شود.
.PP
عملکرد \fIfunzip\fP باید در نسخه‌های آینده به خود \fIunzip\fP اضافه شود.
.PD
.\" =========================================================================
.SH "همچنین ببینید (SEE ALSO)"
\fIgzip\fP(1L), \fIunzip\fP(1L), \fIunzipsfx\fP(1L), \fIzip\fP(1L),
\fIzipcloak\fP(1L), \fIzipinfo\fP(1L), \fIzipnote\fP(1L), \fIzipsplit\fP(1L)
.PD
.\" =========================================================================
.SH "نشانی وب (URL)"
صفحهٔ اصلی Info-ZIP در حال حاضر در نشانی زیر قرار دارد:
.EX
\fChttp://www.info-zip.org/pub/infozip\fR
.EE
یا
.EX
\fCftp://ftp.info-zip.org/pub/infozip\fR .
.EE
.PD
.\" =========================================================================
.SH "نویسندگان (AUTHORS)"
Mark Adler (Info-ZIP)