BSD 4_3_Tahoe development
[unix-history] / usr / man / cat1 / uudecode.0
UUENCODE(1C) UNIX Programmer's Manual UUENCODE(1C)
N\bNA\bAM\bME\bE
uuencode, uudecode - encode/decode a binary file for
transmission via mail
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
u\buu\bue\ben\bnc\bco\bod\bde\be [ source ] remotedest | m\bma\bai\bil\bl sys1!sys2!..!decode
u\buu\bud\bde\bec\bco\bod\bde\be [ file ]
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
_\bU_\bu_\be_\bn_\bc_\bo_\bd_\be and _\bu_\bu_\bd_\be_\bc_\bo_\bd_\be are used to send a binary file via
uucp (or other) mail. This combination can be used over
indirect mail links even when _\bu_\bu_\bs_\be_\bn_\bd(1C) is not available.
_\bU_\bu_\be_\bn_\bc_\bo_\bd_\be takes the named source file (default standard
input) and produces an encoded version on the standard out-
put. The encoding uses only printing ASCII characters, and
includes the mode of the file and the _\br_\be_\bm_\bo_\bt_\be_\bd_\be_\bs_\bt for recrea-
tion on the remote system.
_\bU_\bu_\bd_\be_\bc_\bo_\bd_\be reads an encoded file, strips off any leading and
trailing lines added by mailers, and recreates the original
file with the specified mode and name.
The intent is that all mail to the user ``decode'' should be
filtered through the _\bu_\bu_\bd_\be_\bc_\bo_\bd_\be program. This way the file is
created automatically without human intervention. This is
possible on the uucp network by either using _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl or by
making _\br_\bm_\ba_\bi_\bl be a link to _\bM_\ba_\bi_\bl instead of _\bm_\ba_\bi_\bl. In each
case, an alias must be created in a master file to get the
automatic invocation of _\bu_\bu_\bd_\be_\bc_\bo_\bd_\be.
If these facilities are not available, the file can be sent
to a user on the remote machine who can uudecode it manu-
ally.
The encode file has an ordinary text form and can be edited
by any text editor to change the mode or remote name.
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
atob(n), uusend(1C), uucp(1C), uux(1C), mail(1), uuencode(5)
B\bBU\bUG\bGS\bS
The file is expanded by 35% (3 bytes become 4 plus control
information) causing it to take longer to transmit.
The user on the remote system who is invoking _\bu_\bu_\bd_\be_\bc_\bo_\bd_\be
(often _\bu_\bu_\bc_\bp) must have write permission on the specified
file.
Printed 7/9/88 April 24, 1986 1