source: trunk/athena/bin/tarmail/btoa.man @ 6954

Revision 6954, 2.1 KB checked in by probe, 31 years ago (diff)
Initial revision
  • Property svn:executable set to *
Line 
1
2
3
4btoa(LOCAL)         UNIX Programmer's Manual          btoa(LOCAL)
5
6
7
8NAME
9     btoa, atob, tarmail, untarmail - encode/decode binary to
10     printable ASCII
11
12SYNOPSIS
13     btoa < inbinary > outtext
14
15     atob < intext > outbinary
16
17     tarmail who subject files ...
18
19DESCRIPTION
20     _b_t_o_a is a filter that reads anything from the standard
21     input, and encodes it into printable ASCII on the standard
22     output.  It also attaches checksum information used by the
23     reverse filter "atob" to check integrity.  atob gives NO
24     output (and exits with an error message) if its input is
25     garbage or the checksums do not check.
26
27     tarmail ralph here-it-is-ralph foo.c a.out
28
29     _t_a_r_m_a_i_l is   a shell that tar's up all the given files, pipes
30     them through btoa, and mails them to the given person with
31     the given subject phrase.  "tarmail" with no args will print
32     a short message reminding you what the required args are.
33     When the mail is received at the other end, that person
34     should use mail to save the message in some temporary file
35     name (say "xx").  Then saying "untarmail xx" will decode the
36     message and untar it.  By using tarmail, binary files and
37     entire directory structures can be easily transmitted
38     between machines.  Naturally, you should understand what tar
39     itself does before you use tarmail.
40
41     Other uses:
42
43     crypt < secrets | btoa | mail ralph
44
45     will mail the encrypted contents of the file "secrets" to
46     ralph.  If ralph knows the encryption key, he can decode it
47     by saving the mail (say in "xx"), and then running:
48
49     atob < xx | crypt
50
51     (crypt requests the key from the terminal, and the "secrets"
52     come out on the terminal).
53
54FILES
55     /usr/local/bin:  the programs
56
57AUTHOR
58     Paul Rutter
59
60
61
62
63Bell Version 7                  1
64
65
66
67
68
69
70btoa(LOCAL)         UNIX Programmer's Manual          btoa(LOCAL)
71
72
73
74FEATURES
75     It uses a compact base-85 encoding so that 4 bytes are
76     encoded into 5 characters.
77
78BUGS
79     It uses an obscure base-85 "squoz code" scheme to encode 4
80     bytes into 5 characters.
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129Bell Version 7                  2
130
131
132
Note: See TracBrowser for help on using the repository browser.