version 2, including all changes.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
uuencode |
|
|
2 |
!!!uuencode |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
EXAMPLES |
|
|
7 |
SEE ALSO |
|
|
8 |
STANDARDS |
|
|
9 |
BUGS |
|
|
10 |
HISTORY |
|
|
11 |
---- |
|
|
12 |
!!NAME |
|
|
13 |
|
|
|
14 |
|
|
|
15 |
uuencode - encode a binary file |
|
|
16 |
|
|
|
17 |
|
|
|
18 |
uudecode - decode a file created by uuencode |
|
|
19 |
!!SYNOPSIS |
|
|
20 |
|
|
|
21 |
|
|
|
22 |
__uuencode__ [[-m] [[ file ] name |
|
|
23 |
|
|
|
24 |
|
|
|
25 |
__uudecode__ [[-o outfile] [[ file ]... |
|
|
26 |
!!DESCRIPTION |
|
|
27 |
|
|
|
28 |
|
|
|
29 |
''Uuencode'' and ''uudecode'' are used to transmit |
2 |
StuartYeates |
30 |
[Binary] files over transmission mediums that do not support |
|
|
31 |
other than simple [ASCII] data. |
1 |
perry |
32 |
|
|
|
33 |
|
|
|
34 |
''Uuencode'' reads ''file'' (or by default the |
|
|
35 |
standard input) and writes an encoded version to the |
|
|
36 |
standard output. The encoding uses only printing ASCII |
|
|
37 |
characters and includes the mode of the file and the operand |
|
|
38 |
''name'' for use by ''uudecode.'' If ''name'' is |
|
|
39 |
''/dev/stdout'' the result will be written to standard |
|
|
40 |
output. By default the standard UU encoding format will be |
|
|
41 |
used. If the option ''-m'' is given on the command line |
|
|
42 |
__base64__ encoding is used instead. |
|
|
43 |
|
|
|
44 |
|
|
|
45 |
''Uudecode'' transforms uuencoded ''files'' (or by |
|
|
46 |
default, the standard input) into the original form. The |
|
|
47 |
resulting file is named ''name'' (or ''outfile'' if |
|
|
48 |
the -o option is given) and will have the mode of the |
|
|
49 |
original file except that setuid and execute bits are not |
|
|
50 |
retained. If ''outfile'' or ''name'' is /dev/stdout |
|
|
51 |
the result will be written to standard output. |
|
|
52 |
''Uudecode'' ignores any leading and trailing lines. The |
|
|
53 |
program can automatically decide which of the both supported |
|
|
54 |
encoding schemes are used. |
|
|
55 |
!!EXAMPLES |
|
|
56 |
|
|
|
57 |
|
|
|
58 |
The following example packages up a source tree, compresses |
|
|
59 |
it, uuencodes it and mails it to a user on another system. |
|
|
60 |
When ''uudecode'' is run on the target system, the file |
|
|
61 |
``src_tree.tar.Z'' will be created which may then be |
|
|
62 |
uncompressed and extracted into the original |
|
|
63 |
tree. |
|
|
64 |
|
|
|
65 |
|
|
|
66 |
tar cf - src_tree | compress | uuencode src_tree.tar.Z | |
|
|
67 |
mail sys1!sys2!user |
|
|
68 |
!!SEE ALSO |
|
|
69 |
|
|
|
70 |
|
|
|
71 |
compress(1), mail(1), uucp(1), uuencode(5) |
|
|
72 |
!!STANDARDS |
|
|
73 |
|
|
|
74 |
|
|
|
75 |
This implementation is compliant with |
|
|
76 |
P1003.2b/D11. |
|
|
77 |
!!BUGS |
|
|
78 |
|
|
|
79 |
|
|
|
80 |
If more than one file is given to ''uudecode'' and the -o |
|
|
81 |
option is given or more than one ''name'' in the encoded |
|
|
82 |
files are the same the result is probably not what is |
|
|
83 |
expected. |
|
|
84 |
|
|
|
85 |
|
|
|
86 |
The encoded form of the file is expanded by 37% for UU |
|
|
87 |
encoding and by 35% for base64 encoding (3 bytes become 4 |
|
|
88 |
plus control information). |
|
|
89 |
!!HISTORY |
|
|
90 |
|
|
|
91 |
|
2 |
StuartYeates |
92 |
The ''uuencode'' command appeared in [BSD] |
1 |
perry |
93 |
4.0. |
|
|
94 |
---- |