.\" Copyright (c) 1980, 1990 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.
.\"
.\" Modified from
.\"     @(#)uuencode.1	6.9 (Berkeley) 4/23/91
.\"
.TH uuencode 1
.SH NAME
uuencode \- 對二進制文件編碼
.PP
uudecode \- 解碼由 uuencode 創建的文件

.SH "總覽 (SYNOPSIS)"
.B uuencode
[\-m] [ file ] name
.PP
.B uudecode
[-o outfile] [ file ]...

.SH "描述 (DESCRIPTION)"
.I Uuencode
和
.I uudecode
用於 在 某些 只能 傳輸 簡單 ASCII 數據 的 信道 上 傳送 二進制文件.
.PP
.I Uuencode
讀入 文件
.I file
(缺省爲 標準輸入)的 內容, 編碼後 的 文件 送往 標準輸出.
編碼 只使用 可顯示 ASCII 字符, 同時 將 文件訪問模式 和 目標文件名
.I name
存放在 目標文件 中, 供
.I uudecode
使用. 如果 目標文件名
.I name
是 標準輸出
.I /dev/stdout ,
Uuencode 將把 生成結果 送往 標準輸出. 缺省標準 使用 UU 編碼格式.
如果 在 命令行上 指定了 
.I \-m
選項, Uuencode 就 改用
.B base64
編碼格式.

.PP
.I Uudecode
把 uuencode 編碼過的 文件
.I file
(缺省是 標準輸入) 解碼成 原來的 形式. 產生的 文件 命名爲
.I name
(如果 使用了 \-o 選項, 文件名 就是
.I outfile 
), 擁有 原來的 文件訪問模式, 但會 去除 setuid
和 可執行 位. 如果
.I outfile
或
.I name
是 /dev/stdout, Uudecode 將把 生成結果 送往 標準輸出.
.I Uudecode
忽略 任何(多餘的) 前後行. 它 能夠 自動 識別 編碼格式, 並採用 相應的 解碼方案.

.SH "例子 (EXAMPLES)"
下面的 例子 顯示了 打包 一棵 源文件樹, 壓縮, UU 編碼, 然後 寄給
另一個 系統 的 用戶.
在 目的地 運行
.I uudecode
時 將 產生 ``src_tree.tar.Z'' 文件, 展開 這個 文件 就可以 還原成
原來的 文件樹.
.PP
.IP
.nf
tar cf \- src_tree \&| compress \&|
uuencode src_tree.tar.Z \&| mail sys1!sys2!user
.fi
.LP
.SH "另見 (SEE ALSO)"
compress(1), mail(1), uucp(1), uuencode(5)
.SH "標準 (STANDARDS)"
本實現遵循 P1003.2b/D11.
.SH BUGS
如果 使用了 \-o 選項 的 同時 要求 解碼 一個以上 的 文件
.I file ,
或者 這些 已經 編碼的 文件 中, 出現了 相同的 文件名
.I name , 
其結果 可能 不是 你 想要的.

.PP
用 UU 格式 編碼 的 文件 增大 37%, 用 base64 格式 (3編碼成4字節, 加上控制信息)
編碼 的 文件 增大 35%

.SH "歷史 (HISTORY)"
.I uuencode
命令始於 BSD 4.0.

.SH "[中文版維護人]"
.B 徐明 <xuming@users.sourceforge.net>
.SH "[中文版最新更新]"
.BR 2003/05/13
.SH "《中國Linux論壇man手冊頁翻譯計劃》"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR