Annotation of 43BSDReno/usr.bin/uuencode/uuencode.1, revision 1.1.1.1

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).

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.