uuencode [-flag [value]]... [--opt-name[[=| ]value]]... [<in-file>]
uuencode is used to create an ASCII representation of a file that can
be sent over channels that may otherwise corrupt the data. Specifi-
cally, email cannot handle binary data and will often even insert a
character when the six character sequence "0rom " is seen.
uuencode will read in-file if provided and otherwise read data from
standard in and write the encoded form to standard out. The output
will begin with a header line for use by uudecode giving it the result-
ing suggested file output-name and access mode. If the output-name is
specifically /dev/stdout, then uudecode will emit the decoded file to
Note: uuencode uses buffered input and assumes that it is not hand
typed from a tty. The consequence is that at a tty, you may need to
hit Ctl-D several times to terminate input.
convert using base64.
By default, uuencode will encode using the traditional conver-
sion. It is slower and less compact than base64. The encoded
form of the file is expanded by 37% for UU encoding and by 35%
for base64 encoding (3 bytes become 4 plus control information).
encode the output file name.
Since output file names may contain characters that are not han-
dled well by various transmission modes, you may specify that
the output-name be base64 encoded as well. (Traditional uuen-
coding of the file name is not supported.)
Display usage information and exit.
Pass the extended usage information through a pager.
-R [cfgfile], --save-opts[=cfgfile]
Save the option state to cfgfile. The default is the last con-
figuration file listed in the OPTION PRESETS section, below.
The command will exit after updating the config file.
-r cfgfile, --load-opts=cfgfile, --no-load-opts
Load options from cfgfile. The no-load-opts form will disable
the loading of earlier config/rc/ini files. --no-load-opts is
handled early, out of order.
This implementation is compliant with P1003.2b/D11.
See OPTION PRESETS for configuration files.
One of the following exit values will be returned:
Successful program execution.
The operation failed or the command syntax was not valid.
A specified configuration file could not be loaded.
libopts had an internal operational error. Please report it to
email@example.com. Thank you.
The uuencode command first appeared in BSD 4.0.
Free Software Foundation, Inc.
Copyright (C) 1994-2013 Free Software Foundation, Inc. all rights
reserved. This program is released under the terms of the GNU General
Public License, version 3 or later.
Please put sharutils in the subject line for emailed bug reports. It
helps to spot the message.
Please send bug reports to: firstname.lastname@example.org
This manual page was AutoGen-erated from the uuencode option defini-
GNU sharutils (4.14) 18 Oct 2013 uuencode(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2018
All Rights Reserved.