NAME

       uuencode - encode a file into email friendly text

SYNOPSIS

       uuencode [-flags] [-flag [value]] [--option-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.  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

       -m, --base64
              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).

       -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 base64 encoded as well.
              (Traditional uuencoding of the file name is not supported.)

       -h, --help
              Display usage information and exit.

       -!, --more-help
              Pass the extended usage information through a pager.

       -R [cfgfile], --save-opts [=cfgfile]
              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.

       -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.

       -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), uuencode(5)

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

NOTES

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