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 .FL "\-\fIn\fR" "How many lines to put in each file"
  19 .SH EXAMPLES
  20 .EX "uue file" "Encode \fIfile\fR to \fIfile.uue\fR"
  21 .EX "uue file \- >x" "Encode \fIfile\fR and write on \fIstdout\fR"
  22 .EX "uue \-800 file" "Output on \fIfile.uaa\fR, \fIfile.uab\fR etc."
  23 .SH DESCRIPTION
  24 .PP
  25 \fIUuencode\fR is a famous program that converts an arbitrary (usually binary)
  26 file to an encoding using only 64 ASCII characters.
  27 \fIUudecode\fR converts it back to the original file.
  28 The \fIuue\fR and \fIuud\fR programs are the
  29 \s-1MINIX 3\s-1
  30 versions of these programs, and are compatible with the \s-2UNIX\s0 ones.
  31 The files produced can even be sent successfully over BITNET, which is
  32 notorious for mangling files.
  33 It is possible to have \fIuue\fR automatically split the encoded file up
  34 into small chunks.
  35 The output files then get the suffixes \fI.uaa\fR, \fI.uab\fR, etc., instead
  36 of \fI.uue\fR.
  37 When \fIuud\fR is given \fIfile.uaa\fR to decode, it automatically includes
  38 the subsequent pieces.
  39 The encoding takes 3 bytes (24 bits) from the input file and renders it
  40 as 4 bytes in the output file.
  41 .SH "SEE ALSO"
  42 .BR btoa (1),
  43 .BR uud (1).