uuencode(1) User Commands uuencode(1)
NAME
uuencode - encode a file into email friendly text
SYNOPSIS
uuencode [-flag [value]]... [--opt-name[[=| ]value]]... [ in-file ]
output-name
DESCRIPTION
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 resulting suggested
file output-name and access mode. If the output-name is specifically
/dev/stdout, then uudecode will emit the decoded file to standard out.
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.
OPTIONS
-m, --base64
convert using base 64.
By default, uuencode will encode using the traditional conver-
sion. It is slower and less compact than base 64. 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).
-e, --encode-file-name
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 hex encoded as well.
-h, --help
Display usage information and exit.
-!, --more-help
Pass the extended usage information through a pager.
-R [rcfile], --save-opts[=rcfile]
Save the option state to rcfile. The default is the last con-
figuration file listed in the OPTION PRESETS section, below.
-r rcfile, --load-opts=rcfile, --no-load-opts
Load options from rcfile. The no-load-opts form will disable
the loading of earlier RC/INI files. --no-load-opts is handled
early, out of order.
-v [{v|c|n}], --version[={v|c|n}]
Output version of program and exit. The default mode is `v', a
simple version. The `c' mode will print copyright information
and `n' will print the full copyright notice.
OPTION PRESETS
Any option that is not marked as not presettable may be preset by load-
ing values from configuration ("RC" or ".INI") file(s). The file
"$HOME/.sharrc" will be used, if present.
STANDARDS
This implementation is compliant with P1003.2b/D11.
FILES
See OPTION PRESETS for configuration files.
EXIT STATUS
One of the following exit values will be returned:
0 (EXIT_SUCCESS)
Successful program execution.
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
66 (EX_NOINPUT)
A specified configuration file could not be loaded.
70 (EX_SOFTWARE)
libopts had an internal operational error. Please report it to
autogen-users AT lists.net. Thank you.
SEE ALSO
uudecode(1)
HISTORY
The uuencode command first appeared in BSD 4.0.
AUTHORS
Free Software Foundation, Inc.
COPYRIGHT
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.
BUGS
Please put sharutils in the subject line for emailed bug reports. It
helps to spot the message.
The output file name must not begin with the 11 character sequence:
hex-encode:
unless you specify the -h (encode-file-name) option.
Please send bug reports to: bug-gnu-utils AT gnu.org
NOTES
This manual page was AutoGen-erated from the uuencode option defini-
tions.
GNU sharutils (4.13.3) 06 Jan 2013 uuencode(1)