Unix/Linux Go Back    


Linux 2.6 - man page for uuencode (linux section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


uuencode(1)									      uuencode(1)

NAME
       uuencode, uudecode - encode a binary file, or decode its representation

SYNOPSIS
       uuencode [-m] [ file ] name

       uudecode [-o outfile] [ file ]...

DESCRIPTION
       Uuencode  and  uudecode	are used to transmit binary files over channels that support only
       simple ASCII data.

       Uuencode reads file (or by default the standard input) and writes an  encoded  version  to
       the  standard  output,  using  only printable ASCII characters.	The encoded output begins
       with a header, for use by uudecode, which records the mode of the input file and  suggests
       name  for  the  decoded	file that will be created.  (If name is /dev/stdout then uudecode
       will decode to standard output.)  The encoding has the format documented  at  uuencode(5),
       unless the option -m is given, when base64 encoding is used instead.

       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.

       Uudecode transforms uuencoded files (or standard  input)  into  the  original  form.   The
       resulting file is named name (or outfile if the -o option is given) and will have the mode
       of the original file except that setuid and execute bits are not retained.  If outfile  or
       name  is  /dev/stdout the result will be written to standard output.  Uudecode ignores any
       leading and trailing lines.  The program determines from the header which of the two  sup-
       ported encoding schemes was used.

EXAMPLES
       The  following example packages up a source tree, compresses it, uuencodes it and mails it
       to a user on another system.  When  uudecode  is  run  on  the  target  system,	the  file
       ``src_tree.tar.Z''  will  be created which may then be uncompressed and extracted into the
       original tree.

	      tar cf - src_tree | compress | uuencode src_tree.tar.Z | mail sys1!sys2!user

SEE ALSO
       compress(1), mail(1), uucp(1), uuencode(5)

STANDARDS
       This implementation is compliant with P1003.2b/D11.

BUGS
       If more than one file is given to uudecode and the -o option is given  or  more	than  one
       name in the encoded files are the same the result is probably not what is expected.

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

REPORTING BUGS
       Report bugs to <bug-gnu-utils@gnu.org>.	Please put sharutils or uuencode in  the  subject
       line.  It helps to spot the message.

HISTORY
       The uuencode command appeared in BSD 4.0.

										      uuencode(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 06:12 PM.