uuencode(1)                    DG/UX R4.11MU05                   uuencode(1)


NAME
       uuencode, uudecode - encode/decode a binary file for transmission via
       mail

SYNOPSIS
       uuencode [source] remotedest | mail sys1!sys2!..!decode
       uudecode [ file ]

DESCRIPTION
       Uuencode and uudecode are used to send a binary file via uucp (or
       other) mail.

       Uuencode takes the named source file (default standard input) and
       produces an encoded version on the standard output.  The encoding
       uses only printing ASCII characters.  It includes the mode of the
       file and the remotedest for recreation on the remote system.

       Uudecode reads an encoded file, strips off any leading and trailing
       lines added by mailers, and recreates the original file with the
       specified mode and name, with the exception of any setuid or setgid
       bits, which are not set.

       The intent is that all mail to the user "decode" should be filtered
       through the uudecode program.  This way, the file is created
       automatically without human intervention.  This is possible on the
       uucp network by either using sendmail or by making rmail be a link to
       mailx instead of mail.  In each case, an alias must be created in a
       master file to get the automatic invocation of uudecode.

       If these facilities are not available, the file can be sent to a user
       on the remote machine who can uudecode it manually.

       The encode file has an ordinary text form and can be edited by any
       text editor to change the mode or remote name.

EXAMPLES
       To encode a file foo for mailing to user joe, use the following
       syntax:

       uuencode foo foo | mailx -s "here is file foo" joe

       To encode a file foo into a file foo.uu, and have it decode as file
       goo, use the following syntax:

       uuencode foo goo > foo.uu

SEE ALSO
       uucp(1), uux(1), mail(1), mailx(1).

NOTES
       The file is expanded by 35% (3 bytes become 4 plus control
       information) causing it to take longer to transmit.

       Uudecode will turn off any setuid or setgid bits when setting the
       mode of the destination file.

       The user on the remote system who is invoking uudecode (often uucp)
       must have write permission on the specified file.


Licensed material--property of copyright holder(s)