.\" Copyright (c) 1989-2015
.\"   The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.TH UUENCODE 5
.SH "نام (NAME)"
uuencode \- قالب یک فایل کدگذاری‌شده با uuencode
.SH "توضیحات (DESCRIPTION)"
فایل‌های خروجی تولیدشده توسط
.BR uuencode (1)
شامل یک سطر سرآیند (header)، به دنبال آن تعدادی سطر بدنه (body) و یک سطر پایانی (trailer) هستند.
دستور
.BR uudecode (1)
هر سطری را که پیش از سرآیند یا پس از سطر پایانی باشد نادیده می‌گیرد.
البته سطور پیش از سرآیند نباید شبیه به یک سرآیند باشند.
.PP
سطر سرآیند با داشتن ۵ نویسه اول به صورت
.I begin
که به دنبال آن یک فاصله یا یک خط تیره و یکی از مقادیر
.I base64
یا
.I encoded
یا هر دو (که آن‌ها نیز با خط تیره از هم جدا شده‌اند) می‌آید، مشخص می‌شود.
گزینه
.I base64
بیانگر آن است که فایل با استفاده از base64 کدگذاری شده است.
گزینه
.I encoded
نشان می‌دهد که
.I نام
فایل خروجی با base64 کدگذاری شده است؛ این نام هرگز با کدگذاری سنتی uuencode کدگذاری نمی‌شود. این یک افزونه گنو (GNU) است.
پس از این موارد، حالت دسترسی فایل (در مبنای ۸ یا اکتال) و رشته‌ای که نام فایل مقصد را مشخص می‌کند قرار می‌گیرند. حالت دسترسی با یک نویسه فاصله از عبارت
.I begin
و نام فایل جدا می‌شود.
.SS "کدگذاری سنتی uuencode"
.PP
بدنه فایل سنتی
.I uuencode
شامل تعدادی سطر است که طول هر یک حداکثر ۶۲ نویسه (با احتساب نویسه خط جدید پایانی) است. این سطرها شامل یک نویسه شمارش، نویسه‌های کدگذاری‌شده و در نهایت یک نویسه خط جدید هستند.
نویسه شمارش، یک نویسه منفرد قابل چاپ است و یک عدد صحیح را نشان می‌دهد که بیانگر تعداد بایت‌هایی است که بقیه سطر نمایش می‌دهند.
چنین اعداد صحیحی همیشه در بازه 0 تا 63 هستند و می‌توان آن‌ها را با کم کردن نویسه فاصله (octal 40) از مقدار عددی آن نویسه به دست آورد.
.PP
گروه‌های ۳ بایتی در ۴ نویسه، با ۶ بیت به ازای هر نویسه ذخیره می‌شوند.
همه نویسه‌ها با یک فاصله شیفت داده می‌شوند تا به نویسه‌های قابل چاپ تبدیل گردند.
آخرین سطر ممکن است کوتاه‌تر از مقدار معمول ۴۵ بایت باشد.
اگر اندازه داده‌ها مضربی از ۳ نباشد، این موضوع را می‌توان از مقدار شمارش در سطر پایانی تشخیص داد.
داده‌های زائد اضافی گنجانده می‌شوند تا تعداد نویسه‌ها به مضربی از ۴ برسد.
بدنه با سطری خاتمه می‌یابد که شمارش آن صفر است.
این سطر از یک نویسه فاصله اسکی تشکیل شده است.
.PP
سطر پایانی تنها شامل کلمه
.I end
در یک سطر مستقل است.
.PP
.SS "کدگذاری base64"
فایل‌های کدگذاری‌شده با
.I base64
از قالب مشخص‌شده برای بدنه پیروی می‌کنند، اما شامل سرآیند
.I begin-base64
و یک سطر پایانی متشکل از چهار نویسه
\fI=\fP
هستند.
.SH "مثال‌ها (EXAMPLES)"
.nf
.na
.in +5
begin-base64-encoded 644 VE9ETw==
.in -5
.fi
.ad
این سطر نشان‌دهنده یک فایل کدگذاری‌شده با base64 به نام
.I TODO
است که نام آن نیز با استفاده از کدگذاری base64 رمز شده است.
.sp
.nf
.na
.in +5
begin-encoded 644 5$]$3P``
.in -5
.fi
.ad
این سطر نشان‌دهنده یک فایل کدگذاری‌شده به نام
.I TODO
است که نام آن با استفاده از uuencode رمز شده است.
این نوع کدگذاری بسیار ناخواناتر است؛ لطفاً کدگذاری base64 را ترجیح دهید.
.SH "سازگاری با استانداردها (CONFORMING TO)"
استاندارد IEEE Std 1003.1، به همراه افزونه‌ها.
.sp
پسوند
.I \-encoded
به سطر سرآیند
.I begin
یک افزونه گنو است. دریافت‌کنندگان باید برنامه
.I uudecode
گنو را برای رمزگشایی آن‌ها داشته باشند.
.SH "همچنین ببینید (SEE ALSO)"
uuencode(1), uudecode(1), base64(1GNU)
.SH "تاریخچه (HISTORY)"
قالب فایل
.I uuencode
نخستین بار در BSD 4.0 ظاهر شد.