man/man1/uue.1

   1 .TH UUE 1
   2 .SH NAME
   3 uue, uuencode \- encode a binary file to ASCII (e.g., for mailing)
   4 .SH SYNOPSIS
   5 \fBuue\fR [\fB\-\fIn\fR] \fIfile\fR [\fB\-\fR]\fR
   6 .br
   7 .de FL
   8 .TP
   9 \\fB\\$1\\fR
  10 \\$2
  11 ..
  12 .de EX
  13 .TP 20
  14 \\fB\\$1\\fR
  15 # \\$2
  16 ..
  17 .SH OPTIONS
  18 .TP 5
  19 .B \-\fIn\fR
  20 # How many lines to put in each file
  21 .SH EXAMPLES
  22 .TP 20
  23 .B uue file
  24 # Encode \fIfile\fR to \fIfile.uue\fR
  25 .TP 20
  26 .B uue file \- >x
  27 # Encode \fIfile\fR and write on \fIstdout\fR
  28 .TP 20
  29 .B uue \-800 file
  30 # Output on \fIfile.uaa\fR, \fIfile.uab\fR etc.
  31 .SH DESCRIPTION
  32 .PP
  33 \fIUuencode\fR is a famous program that converts an arbitrary (usually binary)
  34 file to an encoding using only 64 ASCII characters.
  35 \fIUudecode\fR converts it back to the original file.
  36 The \fIuue\fR and \fIuud\fR programs are the
  37 \s-1MINIX 3\s-1
  38 versions of these programs, and are compatible with the \s-2UNIX\s0 ones.
  39 The files produced can even be sent successfully over BITNET, which is
  40 notorious for mangling files.
  41 It is possible to have \fIuue\fR automatically split the encoded file up
  42 into small chunks.
  43 The output files then get the suffixes \fI.uaa\fR, \fI.uab\fR, etc., instead
  44 of \fI.uue\fR.
  45 When \fIuud\fR is given \fIfile.uaa\fR to decode, it automatically includes
  46 the subsequent pieces.
  47 The encoding takes 3 bytes (24 bits) from the input file and renders it
  48 as 4 bytes in the output file.
  49 .SH "SEE ALSO"
  50 .BR btoa (1),
  51 .BR uud (1).