uuencode(1) uuencode(1)
NAME
uuencode - encode mailed files
SYNOPSIS
uuencode[ source-file] destination-file
DESCRIPTION
uuencode and uudecode are used in combination to send a text or binary
file via uucp or mail. You can send the file either directly or via a
mail chain linking a series of directly linked systems.
uuencode takes the named source file or the data from standard input
and produces an encoded version of it on the standard output. Only
printing ASCII characters are used for encoding, which among other
things enables the transfer of 8-bit data over systems that are not
8-bit transparent. The encoding includes the file mode (permissions)
and destination file name for recreating the file on the remote sys-
tem.
ARGUMENTS
source-file
File to be encoded.
source-file not specified:
uuencode reads from standard input.
destination-file
Name of the destination file. Here you specify a path name which
refers to the remote system.
uuencode and uudecode should be used as follows:
You call uuencode:
uuencode [source-file] destination-file | mail system1!system2!..!user
The encoded file is sent to the specified user on the remote system,
who can then decode it with uudecode. The user on the remote system
must have write permission for the file.
The encoded file produced by uuencode is a normal text file and can be
edited with any text editor to change the file mode or the name of the
destination file.
Encoding the source file expands it by 35% (3 bytes become 4 plus con-
trol information) and thus increases the time required to transmit it.
Page 1 Reliant UNIX 5.44 Printed 11/98
uuencode(1) uuencode(1)
LOCALE
The LCMESSAGES environment variable governs the language in which
message texts are displayed. If LCMESSAGES is undefined or is defined
as the null string, it defaults to the value of LANG. If LANG is like-
wise undefined or null, the system acts as if it were not internation-
alized.
The LCALL environment variable governs the entire locale. LCALL
takes precedence over all the other environment variables which affect
internationalization.
EXAMPLES
Example 1:
A file called letter is to be encoded and to be renamed to letter.uue:
$ uuencode letter < letter > letter.uue
Example 2:
A file called letter is to be sent in encoded form to user bill work-
ing on system roland. Once decoded the file is to be called scrpt:
$ uuencode letter scrpt | mail roland!bill
SEE ALSO
mail(1), mailx(1), uucp(1), uudecode(1), uux(1).
Page 2 Reliant UNIX 5.44 Printed 11/98