نام (NAME)

uuencode - کدگذاری یک فایل به متنی مناسب برای رایانامه

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

uuencode [-flags] [-flag [value]] [--option-name[[=| ]value]] [<in-file>] <output-name>

توضیحات (DESCRIPTION)

دستور uuencode برای ایجاد یک نمای اسکی (ASCII) از فایلی به کار می‌رود که می‌تواند از طریق کانال‌هایی ارسال شود که در غیر این صورت ممکن است داده‌ها را خراب کنند. به‌طور مشخص، رایانامه نمی‌تواند داده‌های باینری را مدیریت کند و اغلب حتی هنگام مشاهده توالی شش نویسه‌ای «\nFrom » یک نویسه درج می‌کند.

دستور uuencode در صورت ارائه، فایل ورودی in-file را می‌خواند و در غیر این صورت داده‌ها را از ورودی استاندارد خوانده و شکل کدگذاری‌شده را در خروجی استاندارد می‌نویسد. خروجی با یک سطر سرآیند جهت استفاده توسط uudecode آغاز می‌شود که نام فایل پیشنهادی حاصل output-name و حالت دسترسی را در اختیار آن قرار می‌دهد. اگر output-name به‌طور خاص /dev/stdout باشد، سپس uudecode فایل رمزگشایی‌شده را به خروجی استاندارد هدایت خواهد کرد.

نکته: دستور uuencode از ورودی بافرشده استفاده می‌کند و فرض را بر این می‌گذارد که ورودی به‌صورت دستی از یک tty تایپ نمی‌شود. در نتیجه ممکن است در یک tty نیاز باشد برای پایان دادن به ورودی، کلید Ctl-D را چندین بار فشار دهید.

گزینه‌ها (OPTIONS)

-m, --base64

تبدیل با استفاده از base64.

به‌طور پیش‌فرض، uuencode با استفاده از تبدیل سنتی کدگذاری را انجام می‌دهد. این روش کندتر بوده و تراکم کمتری نسبت به base64 دارد. شکل کدگذاری‌شدهٔ فایل برای کدگذاری UU به میزان ۳۷٪ و برای کدگذاری base64 به میزان ۳۵٪ افزایش می‌یابد (هر ۳ بایت به ۴ بایت به‌علاوه اطلاعات کنترلی تبدیل می‌شود).

-e, --encode-file-name

کدگذاری نام فایل خروجی.

از آنجا که ممکن است نام فایل‌های خروجی شامل نویسه‌هایی باشد که توسط روش‌های گوناگون انتقال به‌خوبی مدیریت نمی‌شوند، می‌توانید مشخص کنید که output-name نیز با base64 کدگذاری شود. (کدگذاری سنتی uuencoding برای نام فایل پشتیبانی نمی‌شود.)

-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 بارگذاری فایل‌های پیکربندی/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_FAILURE)

عملیات شکست خورد یا نحو دستور نامعتبر بود.

66 (EX_NOINPUT)

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

70 (EX_SOFTWARE)

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

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

uudecode(1), uuencode(5)

تاریخچه (HISTORY)

دستور uuencode نخستین بار در BSD 4.0 ظاهر شد.

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

Free Software Foundation, Inc.

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

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

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

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

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

نکات (NOTES)

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