UUENCODE(1)         RISC/os Reference Manual          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 out-
     put.  The encoding uses only printing ASCII characters, and
     includes the mode of the file and the remotedest for recrea-
     tion 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.

     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 Mail 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 manu-
     ally.

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

SEE ALSO
     atob(n), uucp(1), uux(1), mail(1), uuencode(4)

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

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

     The syntax can confuse the unwary.  A single argument is
     interpreted as the remote name, with input coming from
     stdin.  This will hang waiting for input.




                        Printed 11/19/92                   Page 1