نام (NAME)

uudecode - رمزگشایی یک فایل کدگذاری‌شده

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

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

اگر هیچ file (فایلی) مشخص نشود، ورودی استاندارد رمزگشایی می‌شود.

توضیحات (DESCRIPTION)

دستور uudecode فایل‌های کدگذاری‌شده با uuencode را به حالت اصلی‌شان بازمی‌گرداند.

فایل(های) کدگذاری‌شده را می‌توان در خط فرمان مشخص کرد، یا از ورودی استاندارد خواند. نام فایل خروجی درون فایل کدگذاری‌شده تعیین شده است، اما می‌توان آن را با گزینهٔ -o بازنویسی کرد. این فایل حالت دسترسی (mode) فایل اصلی را خواهد داشت، به جز اینکه بیت‌های setuid و قابلیت اجرا (execute) حفظ نمی‌شوند. اگر فایل خروجی به صورت /dev/stdout یا - مشخص شود، نتیجه در خروجی استاندارد نوشته می‌شود. اگر چندین فایل ورودی وجود داشته باشد و فایل دوم یا فایل‌های بعدی خروجی استاندارد را مشخص کنند، داده‌های رمزگشایی‌شده در همان فایل خروجی قبلی نوشته خواهند شد. این کار را انجام ندهید.

دستور uudecode از خطوط ابتدا و انتهای فایل چشم‌پوشی می‌کند. این دستور به دنبال خطی می‌گردد که با «begin» شروع شود و تا رسیدن به نشانگر پایان کدگذاری پیش می‌رود. برنامه از روی خط سرایند (header) فایل کدگذاری‌شده تشخیص می‌دهد که کدام‌یک از دو طرح کدگذاری پشتیبانی‌شده استفاده شده است و آیا نام فایل خروجی با کدگذاری base64 کدگذاری شده است یا خیر. به uuencode(5) مراجعه کنید.

گزینه‌ها (OPTIONS)

-o file, --output-file=file

هدایت مستقیم خروجی به file.

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

-c, --ignore-chmod

نادیده گرفتن خطاهای fchmod(3P).

به طور پیش‌فرض، اگر مجوزهای فایل خروجی نتوانند به مجوزهای مشخص‌شده در داده‌های کدگذاری‌شده تغییر یابند، فایل نوشته نخواهد شد و اجرای برنامه متوقف می‌شود. این گزینه باعث نادیده گرفته شدن این خطا می‌شود. فایل حاصل حاوی تمامی داده‌ها خواهد بود، اما تنظیمات حالت (mode) دسترسی آن نادرست خواهد بود.

همچنین اگر متغیر POSIXLY_CORRECT در محیط تنظیم شده باشد، خطاهای fchmod() نادیده گرفته می‌شوند. ارجاع به: http://austingroupbugs.net/view.php?id=635

هنگامی که fchmod() با شکست مواجه شود، همواره یک هشدار صادر می‌شود.

-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» استفاده خواهد شد.

استانداردها (STANDARDS)

این پیاده‌سازی با P1003.2b/D11 سازگار است.

فایل‌ها (FILES)

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

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

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

0 (EXIT_SUCCESS)

اجرای موفقیت‌آمیز برنامه.

1 (EXIT_OPTION_ERROR)

گزینه‌های دستور به نادرستی پیکربندی شده‌اند.

2 (EXIT_INVALID)

(هشدار) یک یا چند فایل ورودی فاقد داده‌های معتبر بودند.

4 (EXIT_NO_INPUT)

(هشدار) فایل ورودی مشخص‌شده یافت نشد.

8 (EXIT_NO_OUTPUT)

فایل خروجی مشخص‌شده نتوانست ایجاد شود (خطا)؛ یا یکی از فایل‌های خروجی قابل نوشتن نبود یا حالت دسترسی آن تغییر نیافت (هشدارها). پیام(های) همراه تفاوت را مشخص خواهد کرد.

9 (EXIT_NO_MEM)

حافظه پردازشی در دسترس نیست.

66 (EX_NOINPUT)

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

70 (EX_SOFTWARE)

کتابخانه libopts دچار خطای عملیاتی داخلی شد. لطفاً آن را به autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.

کدهای وضعیت خروج (عمدتاً) کدهای هشدار هستند. به همین دلیل، با پردازش فایل‌های ورودی، هر کد با کد خروج نهایی عمل «OR» منطقی می‌شود. به عنوان مثال، کد خروج «6» در بالا فهرست نشده است. این مقدار، حاصل‌جمع EXIT_INVALID و EXIT_NO_INPUT است؛ به این معنا که حداقل یک فایل ورودی حاوی داده‌های نامعتبر بوده و همچنین حداقل یک فایل ورودی اصلاً یافت نشده است.

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

uuencode(1), uuencode(5)

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

Free Software Foundation, Inc.

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

Copyright (C) 1994-2015 Free Software Foundation, Inc. کلیه حقوق محفوظ است. این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License)، نسخه ۳ یا بالاتر منتشر شده است.

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

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

اگر بیش از یک name در فایل‌های کدگذاری‌شده یکسان باشد، یا اگر فایل ورودی دوم یا فایل‌های بعدی خروجی استاندارد را برای فایل خروجی مشخص کنند، احتمالاً نتیجه مورد انتظار نخواهد بود. به طور مشخص، داده‌ها به خروجی استاندارد اضافه (append) خواهند شد و فایل‌های خروجی نام‌گذاری‌شده جایگزین می‌شوند.

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

نکات (NOTES)

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