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  specifi-
       cally /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 conversion.  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 handled 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 configuration 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 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:

       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@lists.sourceforge.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@gnu.org

NOTES

       This manual page was AutoGen-erated from the uuencode option definitions.

GNU sharutils (4.13.3)						    06 Jan 2013 						       uuencode(1)