Commit | Line | Data |
---|---|---|
daacd5f0 | 1 | .\" Copyright (c) 1980, 1990 The Regents of the University of California. |
33075542 | 2 | .\" All rights reserved. |
e0107ca5 | 3 | .\" |
daacd5f0 | 4 | .\" %sccs.include.redist.man% |
33075542 | 5 | .\" |
daacd5f0 | 6 | .\" @(#)uuencode.1 6.8 (Berkeley) %G% |
e0107ca5 | 7 | .\" |
daacd5f0 | 8 | .TH UUENCODE 1 "%Q" |
e0107ca5 KM |
9 | .UC 4 |
10 | .SH NAME | |
7ccf7324 | 11 | uuencode, uudecode \- encode/decode a binary file |
e0107ca5 KM |
12 | .SH SYNOPSIS |
13 | .B uuencode | |
7ccf7324 | 14 | [ file ] name |
e0107ca5 KM |
15 | .br |
16 | .B uudecode | |
7ccf7324 | 17 | [ file ... ] |
e0107ca5 KM |
18 | .SH DESCRIPTION |
19 | .I Uuencode | |
20 | and | |
21 | .I uudecode | |
7ccf7324 KB |
22 | are used to transmit binary files over transmission mediums |
23 | that do not support other than simple ASCII data. | |
e0107ca5 KM |
24 | .PP |
25 | .I Uuencode | |
7ccf7324 KB |
26 | reads |
27 | .I file | |
28 | (or by default the standard input) and writes an encoded version | |
29 | to the standard output. | |
30 | The encoding uses only printing ASCII characters and includes the | |
31 | mode of the file and the operand | |
32 | .I name | |
33 | for use by | |
34 | .IR uudecode . | |
e0107ca5 KM |
35 | .PP |
36 | .I Uudecode | |
7ccf7324 KB |
37 | transforms |
38 | .I uuencoded | |
39 | files (or by default, the standard input) into the original form. | |
40 | The resulting file is named | |
41 | .IR name | |
2da676fd KB |
42 | and will have the mode of the original file except that setuid |
43 | and execute bits are not retained. | |
7ccf7324 KB |
44 | .I Uudecode |
45 | ignores any leading and trailing lines. | |
46 | .SH EXAMPLES | |
47 | The following example packages up a source tree, compresses it, | |
48 | uuencodes it and mails it to a user on another system. | |
49 | When | |
92db425a | 50 | .I uudecode |
7ccf7324 KB |
51 | is run on the target system, the file ``src_tree.tar.Z'' will be |
52 | created which may then be uncompressed and extracted into the original | |
53 | tree. | |
54 | .sp | |
55 | .in +5 | |
56 | tar cf - src_tree | compress | uuencode src_tree.tar.Z | mail sys1!sys2!user | |
57 | .sp | |
92db425a | 58 | .SH SEE ALSO |
1dc700ea | 59 | compress(1), mail(1), uucp(1), uuencode.format(5) |
e0107ca5 | 60 | .SH BUGS |
7ccf7324 KB |
61 | The encoded form of the file is expanded by 35% (3 bytes become 4 plus |
62 | control information). |