uuencode, uudecode - encode/decode a binary file for transmission via mail
uuencode [ source ] remotedest | mail sys1!sys2!..!decode
uudecode [ file ]
Uuencode and uudecode are used to send a binary file via uucp (or other) mail. This combination can be used over indirect mail links even
when uusend(1C) is not available.
Uuencode takes the named source file (default standard input) and produces an encoded version on the standard output. The encoding uses
only printing ASCII characters, and includes the mode of the file and the remotedest for recreation on the remote system.
Uudecode reads an encoded file, strips off any leading and trailing lines added by mailers, and recreates the original file with the speci-
fied mode and name.
The intent is that all mail to the user ``decode'' should be filtered through the uudecode program. This way the file is created automati-
cally without human intervention. This is possible on the uucp network by either using sendmail or by making rmail be a link to Mail
instead of mail. In each case, an alias must be created in a master file to get the automatic invocation of uudecode.
If these facilities are not available, the file can be sent to a user on the remote machine who can uudecode it manually.
The encode file has an ordinary text form and can be edited by any text editor to change the mode or remote name.
atob(n), uusend(1C), uucp(1C), uux(1C), mail(1), uuencode(5)BUGS
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 uudecode (often uucp) must have write permission on the specified file.
4th Berkeley Distribution April 24, 1986 UUENCODE(1C)
Check Out this Related Man Page
uuencode(1) General Commands Manual uuencode(1)NAME
uuencode, uudecode - Encodes or decodes a binary file
uuencode [file] remotefile
Interfaces documented on this reference page conform to industry standards as follows:
Refer to the standards(5) reference page for more information about industry standards and associated tags.
The uuencode and uudecode commands are used to send a binary file via uucp or other mail. This combination can be used over indirect mail
links even when uusend is not available.
The uuencode command takes the named file (default standard input) and produces an encoded version on the standard output. The encoding
uses only printing ASCII characters, and includes the mode of the file and the name for re-creation on the remote system, specified by
The uudecode command 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. Filter the encode through the uudecode program. Filtering the file causes the original file to be auto-
matically recreated. This is possible on the uucp network by using sendmail or by making rmail be a link to mailx. In each case, an alias
must be created in a master file to get the automatic invocation of uudecode.
If neither of the preceding facilities is available on a user's system, uudecode can be applied to the file manually by editing the file
with any text editor, removing the trailing and leading lines, and changing the mode or remote system name. The encoded file is an ordinary
In the following example, the ex1 file is encoded; the output is also redirected to the ex1.out file: prompt> uuencode ex1 ex1.en > ex1.out
If the source ex1 file is as follows:
This example shows how to encode a file using uuencode and how to decode a file using uudecode.
The encoded ex1.out file would be as follows:
begin 644 ex1.en M5&AI<R!E>&%M<&QE('-H;W=S"G1H92!H;W<@=&@96YC;V1E"F$@9FEL92!U
M<VEN9PIU=65N8V]D90IA;F0@:&]W('1O"F1E8V]D92!A(&9I;&4*=7-I;F<@ *=75D96-O9&4N"F]D ` end In the following example, the ex1.out file is
decoded: prompt> uudecode ex1.out
In this example, the uudecode command decodes the file and puts the output in ex1.en. To package up a source tree using tar, com-
press it, uuencode it, and mail it to a user on another system, enter: tar cf - src_tree | compress | uuencode src_tree.tar.Z |
(Enter the command entirely on one line, not on two lines as shown above.)
When uudecode is run on the target system, the src_tree.tar.Z file is created; it may then be uncompressed and dearchived with tar.
Commands: ct(1), cu(1), mailx(1), Mail(1), rmail(1), sendmail(8), tip(1), uucico(8), uucleanup(8), uucp(1), uulog(1), uuname(1),
uupick(1), uusched(8), uusend(1), uustat(1), uuto(1), uux(1)