GNU sharutils (4.15.2)
30 May 2015
Aliases: uudecode(1), uudecode(1), uudecode(1)
sharutils
The GNU shar utilities for packaging and unpackaging shell archives
NAME
-Font]uuencode - encode a file into email friendly text
SYNOPSIS
-Font]uuencode [-Font]-flags
]] [-Font]-flag] [-Font]value]]] [-Font]--option-name][[=| ]-Font]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. Specifically, 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
| convert using base64. | |
|
By default, uuencode will encode using the traditional conversion. 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 handled well by various transmission modes, you may specify that the output-name be base64 encoded as well. (Traditional uuencoding of the file name is not supported.)
|
|
| Display usage information and exit.
Pass the extended usage information through a pager. Save the option state to cfgfile. The default is the last |
|
| configuration file listed in the OPTION PRESETS section, below. The command will exit after updating the config file. | |
| 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. | |
| 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 loading 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:
| 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 autogen-users. Thank you. | |
SEE ALSO
HISTORY
The uuencode command first appeared in BSD 4.0.
AUTHORS
Free Software Foundation, Inc.
COPYRIGHT
Copyright (C) 1994-2015 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.
Please send bug reports to: bug-gnu-utils
NOTES
This manual page was AutoGen-erated from the uuencode option definitions.
