نام (NAME)

unshar - استخراج یک بایگانی shar

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

unshar [-flags] [-flag [value]] [--option-name[[=| ]value]] [<file>...]

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

توضیحات (DESCRIPTION)

برنامه unshar فایل‌های ورودی را (که معمولاً پیام‌های رایانامه هستند) برای یافتن آغاز یک بایگانی پوسته پویش می‌کند. اگر هیچ فایلی داده نشود، ورودی استاندارد در عوض پردازش می‌شود. سپس هر بایگانیِ یافت‌شده را برای استخراج، به یک فراخوانی از برنامه پوسته ارسال می‌کند.

این برنامه عملکرد خود را برای هر فایلی که در خط فرمان نام برده شده یا هر فایلی که در فهرستی از stdin خوانده شده، اجرا خواهد کرد. آرگومان‌ها یا نام‌های ورودی باید فایل‌های از پیش موجود باشند. فهرست ورودی می‌تواند شامل توضیحات باشد، که همان خطوط خالی یا خطوطی هستند که با نویسه «#» آغاز می‌شوند.

گزینه‌ها (OPTIONS)

-d dir, --directory=dir

استخراج در دایرکتوری dir.

نام‌های فایل‌های ورودی نسبت به دایرکتوری جاری در زمان آغاز برنامه سنجیده می‌شوند. این گزینه به unshar می‌گوید که یک دستور cd <dir> را در ابتدای متن shar نوشته‌شده برای پوسته قرار دهد.

-c, --overwrite

بازنویسی روی هر فایل از پیش موجود.

این گزینه به عنوان یک گزینه به فایل shar منتقل می‌شود. بسیاری از اسکریپت‌های بایگانی پوسته آرگومان -c را می‌پذیرند تا مشخص کند فایل‌های موجود باید بازنویسی شوند.

-f, --force

این یک نام مستعار برای گزینه --overwrite است.

-E split-mark, --split-at=split-mark

جداسازی ورودی بر اساس خطوط split-mark. مقدار پیش‌فرض split-mark برای این گزینه برابر است با:
exit 0

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

برای نمونه، با توجه به این‌که بیشتر «امضاها» (.signatures) درست در خط قبل از خود دارای دو خط تیره («--») هستند، گاهی می‌توان از --split-at=-- استفاده کرد. بدین ترتیب امضا و همچنین سرآیندهای پیام بعدی نادیده گرفته خواهند شد.

-e, --exit-0

جداسازی ورودی بر اساس خطوط "exit 0". این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید: split-at.

بیشتر بایگانی‌های پوسته با خطی خاتمه می‌یابند که صرفاً متشکل از «exit 0» است. این گزینه معادل (و در تضاد با) --split-at="exit 0"; است.

-D, --debug

اشکال‌زدایی کد پوسته.

عبارت «set -x» در کدی که پوسته تفسیر می‌کند قرار خواهد گرفت.

-h, --help

نمایش اطلاعات نحوه استفاده و خروج.

-!, --more-help

ارسال اطلاعات گسترده‌تر نحوه استفاده از طریق یک صفحه‌بند (pager).

-R [cfgfile], --save-opts [=cfgfile]

ذخیره وضعیت گزینه‌ها در cfgfile. مقدار پیش‌فرض، آخرین فایل پیکربندی فهرست‌شده در بخش پیش‌تنظیم‌های گزینه (OPTION PRESETS) در ادامه است. دستور پس از به‌روزرسانی فایل پیکربندی خارج خواهد شد.

-r cfgfile, --load-opts=cfgfile, --no-load-opts

بارگذاری گزینه‌ها از cfgfile. حالت no-load-opts بارگذاری فایل‌های پیکربندی قبلی config/rc/ini را غیرفعال می‌کند. --no-load-opts در مراحل ابتدایی و خارج از نوبت پردازش می‌شود.

-v [{v|c|n --version [{v|c|n}]}]

نمایش نسخه برنامه و خروج. حالت پیش‌فرض «v» است، که یک نگارش ساده را نمایش می‌دهد. حالت «c» اطلاعات حق نشر را چاپ می‌کند و «n» اطلاعیه کامل حق نشر را چاپ خواهد کرد.

پیش‌تنظیم‌های گزینه (OPTION PRESETS)

هر گزینه‌ای که به عنوان not presettable (غیرقابل پیش‌تنظیم) مشخص نشده باشد، می‌تواند با بارگذاری مقادیر از فایل(های) پیکربندی («RC» یا «.INI») از پیش تنظیم شود. در صورت وجود، فایل «$HOME/.sharrc» استفاده خواهد شد.

فایل‌ها (FILES)

برای فایل‌های پیکربندی، بخش پیش‌تنظیم‌های گزینه (OPTION PRESETS) را ببینید.

وضعیت خروج (EXIT STATUS)

یکی از مقادیر خروج زیر بازگردانده خواهد شد:

0 (EXIT_SUCCESS): اجرای موفقیت‌آمیز برنامه.
1 (EXIT_FAILURE): خطایی در نحوه استفاده از دستور وجود داشت.
2 (EXIT_POPEN_PROBLEM): عدم توانایی در ایجاد فرآیند پوسته یا نوشتن در آن.
3 (EXIT_CANNOT_CREATE): عدم توانایی در ایجاد فایل خروجی.
4 (EXIT_BAD_DIRECTORY): ساختار دایرکتوری کاری نامعتبر است.
5 (EXIT_NOMEM): خطا در تخصیص حافظه.
6 (EXIT_INVALID): ورودی نامعتبر است؛ حاوی فایل shar نیست.
66 (EX_NOINPUT): یک فایل پیکربندی مشخص‌شده بارگذاری نشد.
70 (EX_SOFTWARE): کتابخانه libopts دچار یک خطای عملیاتی داخلی شد. لطفاً آن را به autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.

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

shar(1)

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

برنامه‌های shar و unshar کار گروهی نویسندگان متعددی است. افراد بسیاری با گزارش مشکلات، پیشنهاد بهبودهای گوناگون یا ارسال کد در آن مشارکت داشته‌اند. فهرستی از این افراد در فایل THANKS در بسته توزیع sharutils قرار دارد.

کپی‌رایت و تکثیر (COPYRIGHT)

گزارش باگ‌ها (BUGS)

لطفاً عبارت sharutils را در موضوع رایانامه‌های گزارش باگ قرار دهید. این کار به شناسایی پیام کمک می‌کند.

لطفاً گزارش باگ‌ها را به این آدرس بفرستید: bug-gnu-utils@gnu.org

نکات (NOTES)

این صفحه راهنما توسط AutoGen از روی تعاریف گزینه‌های unshar تولید شده است.