.de1 NOP
.  it 1 an-trap
.  if \\n[.$] \,\\$*\/
..
.ie t \
.ds B-Font [CB]
.ds I-Font [CI]
.ds R-Font [CR]
.el \
.ds B-Font B
.ds I-Font I
.ds R-Font R
.TH unshar 1 "30 May 2015" "GNU sharutils (4.15.2)" "دستورهای کاربر (User Commands)"
.\"
.\" DO NOT EDIT THIS FILE (in-mem file)
.\"
.\" It has been AutoGen-ed
.\" From the definitions unshar-opts.def
.\" and the template file agman-cmd.tpl
.SH "نام (NAME)"
\f\*[B-Font]unshar\fP
\- استخراج یک بایگانی shar
.SH "خلاصه دستور (SYNOPSIS)"
\f\*[B-Font]unshar\fP
.\" Mixture of short (flag) options and long options
[\f\*[B-Font]\-flags\f[]]
[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]]
[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]]
[<file>...]
.sp \n(Ppu
.ne 2

عملوندهایی که این برنامه روی آن‌ها عمل می‌کند را می‌توان در خط فرمان مشخص کرد یا این‌که به‌صورت خط‌به‌خط از ورودی استاندارد خواند.
در این ورودی، فاصله‌های خالی ابتدا و انتهای خطوط حذف شده و خطوط خالی نادیده گرفته می‌شوند.
ورودی استاندارد نباید یک ترمینال باشد.
.sp \n(Ppu
.ne 2

.SH "توضیحات (DESCRIPTION)"
برنامه unshar فایل‌های ورودی را (که معمولاً پیام‌های رایانامه هستند) برای یافتن آغاز یک بایگانی پوسته پویش می‌کند. اگر هیچ فایلی داده نشود، ورودی استاندارد در عوض پردازش می‌شود. سپس هر بایگانیِ یافت‌شده را برای استخراج، به یک فراخوانی از برنامه پوسته ارسال می‌کند.
.sp \n(Ppu
.ne 2

این برنامه عملکرد خود را برای هر فایلی که در خط فرمان نام برده شده یا هر فایلی که در فهرستی از stdin خوانده شده، اجرا خواهد کرد. آرگومان‌ها یا نام‌های ورودی باید فایل‌های از پیش موجود باشند. فهرست ورودی می‌تواند شامل توضیحات باشد، که همان خطوط خالی یا خطوطی هستند که با نویسه «#» آغاز می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.NOP \f\*[B-Font]\-d\f[] \f\*[I-Font]dir\f[], \f\*[B-Font]\-\-directory\f[]=\f\*[I-Font]dir\f[]
استخراج در دایرکتوری \fIdir\fP.
.sp
نام‌های فایل‌های ورودی نسبت به دایرکتوری جاری در زمان آغاز برنامه سنجیده می‌شوند. این گزینه به \fBunshar\fP می‌گوید که یک دستور \fBcd <dir>\fP را در ابتدای متن \fBshar\fP نوشته‌شده برای پوسته قرار دهد.
.TP
.NOP \f\*[B-Font]\-c\f[], \f\*[B-Font]\-\-overwrite\f[]
بازنویسی روی هر فایل از پیش موجود.
.sp
این گزینه به عنوان یک گزینه به فایل shar منتقل می‌شود. بسیاری از اسکریپت‌های بایگانی پوسته آرگومان \fB-c\fP را می‌پذیرند تا مشخص کند فایل‌های موجود باید بازنویسی شوند.
.TP
.NOP \f\*[B-Font]\-f\f[], \f\*[B-Font]\-\-force\f[]
این یک نام مستعار برای گزینه \fI--overwrite\fR است.
.TP
.NOP \f\*[B-Font]\-E\f[] \f\*[I-Font]split\-mark\f[], \f\*[B-Font]\-\-split\-at\f[]=\f\*[I-Font]split\-mark\f[]
جداسازی ورودی بر اساس خطوط \fBsplit-mark\fP.
مقدار پیش‌فرض
\f\*[I-Font]split\-mark\f[]
برای این گزینه برابر است با:
.ti +4
 exit 0
.sp
با این گزینه، \fBunshar\fP هر بایگانی متفاوت پوسته را از سایر بایگانی‌هایی که در همان فایل قرار گرفته‌اند جدا می‌کند و هر یک را به نوبت، از ابتدای فایل تا انتها استخراج می‌نماید. عملکرد صحیح آن بر این واقعیت استوار است که بسیاری از فایل‌های shar با یک رشته مشخص و به راحتی قابل شناسایی در ابتدای آخرین خط خاتمه می‌یابند.
.sp
برای نمونه، با توجه به این‌که بیشتر «امضاها» (.signatures) درست در خط قبل از خود دارای دو خط تیره («--») هستند، گاهی می‌توان از \fB--split-at=--\fP استفاده کرد. بدین ترتیب امضا و همچنین سرآیندهای پیام بعدی نادیده گرفته خواهند شد.
.TP
.NOP \f\*[B-Font]\-e\f[], \f\*[B-Font]\-\-exit\-0\f[]
جداسازی ورودی بر اساس خطوط "exit 0".
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید:
split-at.
.sp
بیشتر بایگانی‌های پوسته با خطی خاتمه می‌یابند که صرفاً متشکل از «exit 0» است. این گزینه معادل (و در تضاد با)
\fB--split-at="exit 0"\fP
است.
.TP
.NOP \f\*[B-Font]\-D\f[], \f\*[B-Font]\-\-debug\f[]
اشکال‌زدایی کد پوسته.
.sp
عبارت «set \-x» در کدی که پوسته تفسیر می‌کند قرار خواهد گرفت.
.TP
.NOP \f\*[B-Font]\-h\f[], \f\*[B-Font]\-\-help\f[]
نمایش اطلاعات نحوه استفاده و خروج.
.TP
.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[]
ارسال اطلاعات گسترده‌تر نحوه استفاده از طریق یک صفحه‌بند (pager).
.TP
.NOP \f\*[B-Font]\-R\f[] [\f\*[I-Font]cfgfile\f[]], \f\*[B-Font]\-\-save-opts\f[] [=\f\*[I-Font]cfgfile\f[]]
ذخیره وضعیت گزینه‌ها در \fIcfgfile\fP. مقدار پیش‌فرض، \fIآخرین\fP فایل پیکربندی فهرست‌شده در بخش \fBپیش‌تنظیم‌های گزینه (OPTION PRESETS)\fP در ادامه است. دستور پس از به‌روزرسانی فایل پیکربندی خارج خواهد شد.
.TP
.NOP \f\*[B-Font]\-r\f[] \f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-load-opts\f[]=\f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-no-load-opts\f[]
بارگذاری گزینه‌ها از \fIcfgfile\fP.
حالت \fIno-load-opts\fP بارگذاری فایل‌های پیکربندی قبلی config/rc/ini را غیرفعال می‌کند. \fI\-\-no-load-opts\fP در مراحل ابتدایی و خارج از نوبت پردازش می‌شود.
.TP
.NOP \f\*[B-Font]\-v\f[] [{\f\*[I-Font]v|c|n\f[] \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}]}]
نمایش نسخه برنامه و خروج. حالت پیش‌فرض «v» است، که یک نگارش ساده را نمایش می‌دهد. حالت «c» اطلاعات حق نشر را چاپ می‌کند و «n» اطلاعیه کامل حق نشر را چاپ خواهد کرد.
.PP
.SH "پیش‌تنظیم‌های گزینه (OPTION PRESETS)"
هر گزینه‌ای که به عنوان \fInot presettable\fP (غیرقابل پیش‌تنظیم) مشخص نشده باشد، می‌تواند با بارگذاری مقادیر از فایل(های) پیکربندی («RC» یا «.INI») از پیش تنظیم شود.
در صورت وجود، فایل «\fI$HOME/.sharrc\fP» استفاده خواهد شد.
.SH "فایل‌ها (FILES)"
برای فایل‌های پیکربندی، بخش \fBپیش‌تنظیم‌های گزینه (OPTION PRESETS)\fP را ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
یکی از مقادیر خروج زیر بازگردانده خواهد شد:
.TP
.NOP 0 " (EXIT_SUCCESS)"
اجرای موفقیت‌آمیز برنامه.
.TP
.NOP 1 " (EXIT_FAILURE)"
خطایی در نحوه استفاده از دستور وجود داشت.
.TP
.NOP 2 " (EXIT_POPEN_PROBLEM)"
عدم توانایی در ایجاد فرآیند پوسته یا نوشتن در آن.
.TP
.NOP 3 " (EXIT_CANNOT_CREATE)"
عدم توانایی در ایجاد فایل خروجی.
.TP
.NOP 4 " (EXIT_BAD_DIRECTORY)"
ساختار دایرکتوری کاری نامعتبر است.
.TP
.NOP 5 " (EXIT_NOMEM)"
خطا در تخصیص حافظه.
.TP
.NOP 6 " (EXIT_INVALID)"
ورودی نامعتبر است؛ حاوی فایل shar نیست.
.TP
.NOP 66 " (EX_NOINPUT)"
یک فایل پیکربندی مشخص‌شده بارگذاری نشد.
.TP
.NOP 70 " (EX_SOFTWARE)"
کتابخانه libopts دچار یک خطای عملیاتی داخلی شد. لطفاً آن را به
autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.
.PP
.SH "همچنین ببینید (SEE ALSO)"
shar(1)
.SH "نویسندگان (AUTHORS)"
برنامه‌های \fIshar\fP و \fIunshar\fP کار گروهی نویسندگان متعددی است. افراد بسیاری با گزارش مشکلات، پیشنهاد بهبودهای گوناگون یا ارسال کد در آن مشارکت داشته‌اند. فهرستی از این افراد در فایل \fITHANKS\fP در بسته توزیع sharutils قرار دارد.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Copyright (C) 1994-2015 Free Software Foundation, Inc. کلیه حقوق محفوظ است.
این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License)، نسخه ۳ یا بالاتر منتشر شده است.
.SH "گزارش باگ‌ها (BUGS)"
لطفاً عبارت \fBsharutils\fP را در موضوع رایانامه‌های گزارش باگ قرار دهید. این کار به شناسایی پیام کمک می‌کند.
.sp \n(Ppu
.ne 2

لطفاً گزارش باگ‌ها را به این آدرس بفرستید: bug-gnu-utils@gnu.org
.SH "نکات (NOTES)"
این صفحه راهنما توسط \fIAutoGen\fP از روی تعاریف گزینه‌های \fBunshar\fP تولید شده است.