.\" 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