|
|
1.1 root 1: .\" Copyright (c) 1980, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)uuencode.1 6.8 (Berkeley) 6/24/90
19: .\"
20: .TH UUENCODE 1 "%Q"
21: .UC 4
22: .SH NAME
23: uuencode, uudecode \- encode/decode a binary file
24: .SH SYNOPSIS
25: .B uuencode
26: [ file ] name
27: .br
28: .B uudecode
29: [ file ... ]
30: .SH DESCRIPTION
31: .I Uuencode
32: and
33: .I uudecode
34: are used to transmit binary files over transmission mediums
35: that do not support other than simple ASCII data.
36: .PP
37: .I Uuencode
38: reads
39: .I file
40: (or by default the standard input) and writes an encoded version
41: to the standard output.
42: The encoding uses only printing ASCII characters and includes the
43: mode of the file and the operand
44: .I name
45: for use by
46: .IR uudecode .
47: .PP
48: .I Uudecode
49: transforms
50: .I uuencoded
51: files (or by default, the standard input) into the original form.
52: The resulting file is named
53: .IR name
54: and will have the mode of the original file except that setuid
55: and execute bits are not retained.
56: .I Uudecode
57: ignores any leading and trailing lines.
58: .SH EXAMPLES
59: The following example packages up a source tree, compresses it,
60: uuencodes it and mails it to a user on another system.
61: When
62: .I uudecode
63: is run on the target system, the file ``src_tree.tar.Z'' will be
64: created which may then be uncompressed and extracted into the original
65: tree.
66: .sp
67: .in +5
68: tar cf - src_tree | compress | uuencode src_tree.tar.Z | mail sys1!sys2!user
69: .sp
70: .SH SEE ALSO
71: compress(1), mail(1), uucp(1), uuencode.format(5)
72: .SH BUGS
73: The encoded form of the file is expanded by 35% (3 bytes become 4 plus
74: control information).
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.