.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 uudecode 1 "30 مه 2015" "GNU sharutils (4.15.2)" "دستورهای کاربری"
.\"
.\" DO NOT EDIT THIS FILE (in-mem file)
.\"
.\" It has been AutoGen-ed
.\" From the definitions uudecode-opts.def
.\" and the template file agman-cmd.tpl
.SH "نام (NAME)"
\f\*[B-Font]uudecode\fP
\- رمزگشایی یک فایل کدگذاری‌شده
.SH "خلاصه دستور (SYNOPSIS)"
\f\*[B-Font]uudecode\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

اگر هیچ \fIfile\fP (فایلی) مشخص نشود، ورودی استاندارد رمزگشایی می‌شود.
.SH "توضیحات (DESCRIPTION)"
دستور \fIuudecode\fP فایل‌های کدگذاری‌شده با uuencode را به حالت اصلی‌شان بازمی‌گرداند.
.sp
فایل(های) کدگذاری‌شده را می‌توان در خط فرمان مشخص کرد، یا از ورودی استاندارد خواند. نام فایل خروجی درون فایل کدگذاری‌شده تعیین شده است، اما می‌توان آن را با گزینهٔ \fB-o\fP بازنویسی کرد. این فایل حالت دسترسی (mode) فایل اصلی را خواهد داشت، به جز اینکه بیت‌های setuid و قابلیت اجرا (execute) حفظ نمی‌شوند. اگر فایل خروجی به صورت \fI/dev/stdout\fP یا \fI-\fP مشخص شود، نتیجه در خروجی استاندارد نوشته می‌شود. اگر چندین فایل ورودی وجود داشته باشد و فایل دوم یا فایل‌های بعدی خروجی استاندارد را مشخص کنند، داده‌های رمزگشایی‌شده در همان فایل خروجی قبلی نوشته خواهند شد. این کار را انجام ندهید.
.sp
دستور \fIuudecode\fP از خطوط ابتدا و انتهای فایل چشم‌پوشی می‌کند. این دستور به دنبال خطی می‌گردد که با «\fBbegin\fP» شروع شود و تا رسیدن به نشانگر پایان کدگذاری پیش می‌رود. برنامه از روی خط سرایند (header) فایل کدگذاری‌شده تشخیص می‌دهد که کدام‌یک از دو طرح کدگذاری پشتیبانی‌شده استفاده شده است و آیا نام فایل خروجی با کدگذاری base64 کدگذاری شده است یا خیر. به \fIuuencode(5)\fP مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.NOP \f\*[B-Font]\-o\f[] \f\*[I-Font]file\f[], \f\*[B-Font]\-\-output\-file\f[]=\f\*[I-Font]file\f[]
هدایت مستقیم خروجی به \fIfile\fP.
.sp
در صورت تعیین شدن، داده‌های رمزگشایی‌شده در این فایل نوشته می‌شوند. هنگامی که چندین ورودی در خط فرمان مشخص شده باشند، این گزینه قابل استفاده نیست. تمام داده‌های رمزگشایی‌شده باید در نام فایلی که در خود داده‌ها کدگذاری شده است، نوشته شوند.
.TP
.NOP \f\*[B-Font]\-c\f[], \f\*[B-Font]\-\-ignore\-chmod\f[]
نادیده گرفتن خطاهای \fBfchmod(3P)\fP.
.sp
به طور پیش‌فرض، اگر مجوزهای فایل خروجی نتوانند به مجوزهای مشخص‌شده در داده‌های کدگذاری‌شده تغییر یابند، فایل نوشته نخواهد شد و اجرای برنامه متوقف می‌شود. این گزینه باعث نادیده گرفته شدن این خطا می‌شود. فایل حاصل حاوی تمامی داده‌ها خواهد بود، اما تنظیمات حالت (mode) دسترسی آن نادرست خواهد بود.
.sp
همچنین اگر متغیر \fBPOSIXLY_CORRECT\fP در محیط تنظیم شده باشد، خطاهای \fBfchmod()\fP نادیده گرفته می‌شوند. ارجاع به:
\fIhttp://austingroupbugs.net/view.php?id=635\fP
.sp
هنگامی که \fBfchmod()\fP با شکست مواجه شود، همواره یک هشدار صادر می‌شود.
.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
.sp
.SH "پیش‌تنظیم‌های گزینه (OPTION PRESETS)"
هر گزینه‌ای که به عنوان \fInot presettable\fP (غیرقابل پیش‌تنظیم) علامت‌گذاری نشده باشد، می‌تواند با بارگذاری مقادیر از فایل(های) پیکربندی («RC» یا «.INI») پیش‌تنظیم شود.
در صورت وجود، فایل «\fI$HOME/.sharrc\fP» استفاده خواهد شد.
.SH "استانداردها (STANDARDS)"
این پیاده‌سازی با P1003.2b/D11 سازگار است.
.SH "فایل‌ها (FILES)"
برای فایل‌های پیکربندی به بخش \fBپیش‌تنظیم‌های گزینه (OPTION PRESETS)\fP مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
یکی از مقادیر خروج زیر بازگردانده خواهد شد:
.TP
.NOP 0 " (EXIT_SUCCESS)"
اجرای موفقیت‌آمیز برنامه.
.TP
.NOP 1 " (EXIT_OPTION_ERROR)"
گزینه‌های دستور به نادرستی پیکربندی شده‌اند.
.TP
.NOP 2 " (EXIT_INVALID)"
(هشدار) یک یا چند فایل ورودی فاقد داده‌های معتبر بودند.
.TP
.NOP 4 " (EXIT_NO_INPUT)"
(هشدار) فایل ورودی مشخص‌شده یافت نشد.
.TP
.NOP 8 " (EXIT_NO_OUTPUT)"
فایل خروجی مشخص‌شده نتوانست ایجاد شود (خطا)؛ یا یکی از فایل‌های خروجی قابل نوشتن نبود یا حالت دسترسی آن تغییر نیافت (هشدارها). پیام(های) همراه تفاوت را مشخص خواهد کرد.
.TP
.NOP 9 " (EXIT_NO_MEM)"
حافظه پردازشی در دسترس نیست.
.TP
.NOP 66 " (EX_NOINPUT)"
یک فایل پیکربندی مشخص‌شده بارگذاری نشد.
.TP
.NOP 70 " (EX_SOFTWARE)"
کتابخانه libopts دچار خطای عملیاتی داخلی شد. لطفاً آن را به autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.
.sp \n(Ppu
.ne 2

کدهای وضعیت خروج (عمدتاً) کدهای هشدار هستند.
به همین دلیل، با پردازش فایل‌های ورودی، هر کد با کد خروج نهایی عمل «OR» منطقی می‌شود. به عنوان مثال، کد خروج «6» در بالا فهرست نشده است. این مقدار، حاصل‌جمع \fBEXIT_INVALID\fP و \fBEXIT_NO_INPUT\fP است؛ به این معنا که حداقل یک فایل ورودی حاوی داده‌های نامعتبر بوده و همچنین حداقل یک فایل ورودی اصلاً یافت نشده است.
.PP
.SH "همچنین ببینید (SEE ALSO)"
uuencode(1), uuencode(5)
.SH "نویسندگان (AUTHORS)"
Free Software Foundation, Inc.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Copyright (C) 1994-2015 Free Software Foundation, Inc. کلیه حقوق محفوظ است.
این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License)، نسخه ۳ یا بالاتر منتشر شده است.
.SH "گزارش باگ‌ها (BUGS)"
لطفاً برای گزارش‌های اشکال که از طریق رایانامه ارسال می‌شوند، عبارت \fBsharutils\fP را در خط موضوع (subject) قرار دهید. این کار به شناسایی پیام کمک می‌کند.
.sp \n(Ppu
.ne 2

اگر بیش از یک \fIname\fP در فایل‌های کدگذاری‌شده یکسان باشد، یا اگر فایل ورودی دوم یا فایل‌های بعدی خروجی استاندارد را برای فایل خروجی مشخص کنند، احتمالاً نتیجه مورد انتظار نخواهد بود.
به طور مشخص، داده‌ها به خروجی استاندارد اضافه (append) خواهند شد و فایل‌های خروجی نام‌گذاری‌شده جایگزین می‌شوند.
.sp \n(Ppu
.ne 2

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