home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / btoa.lzh / btoa.man < prev    next >
Text File  |  1995-08-16  |  2KB  |  64 lines
  1. BTOA 1 local
  2.  
  3. NAME
  4. btoa, atob, tarmail, untarmail \- encode/decode binary to printable ASCII
  5.  
  6. SYNOPSIS
  7. btoa
  8. atob
  9. tarmail
  10. who subject files ...
  11. untarmail
  12. [ file ]
  13.  
  14. DESCRIPTION
  15.  
  16. Btoa is a filter that reads anything from the standard input, and encodes it into printable ASCII on the standard output.  It also attaches a header and checksum information used by the reverse filter atob to find the start of the data and to check integrity.
  17.  
  18. Atob reads an encoded file, strips off any leading and trailing lines added by mailers, and recreates a copy of the original file on the standard output.
  19. Atob gives NO output (and exits with an error message) if its input is garbage or the checksums do not check.
  20.  
  21. Tarmail is a shell script that tar's up all the given files, pipes them 
  22. through compress ","  btoa "," and mails them to the given person with the given subject phrase.  For example:
  23.  
  24. tarmail ralph "here it is ralph" foo.c a.out
  25.  
  26. Will package up files "foo.c" and "a.out" and mail them to "ralph" using
  27. subject "here it is ralph".  Notice the quotes on the subject.  They are
  28. necessary to make it one argument to the shell.
  29.  
  30. Tarmail with no args will print a short message reminding you what the required args are.  When the mail is received at the other end, that person should use mail to save the message in some temporary file name (say "xx").
  31. Then saying "untarmail xx" will decode the message and untar it.  
  32.  
  33. Untarmail can also be used as a filter.  By using tarmail "," binary files
  34. and entire directory structures can be easily transmitted between machines.
  35. Naturally, you should understand what tar itself does before you use 
  36. tarmail "."
  37.  
  38. Other uses:
  39.  
  40. compress < secrets | crypt | btoa | mail ralph
  41.  
  42. will mail the encrypted contents of the file "secrets" to ralph.  If ralph
  43. knows the encryption key, he can decode it by saving the mail (say in "xx"),
  44. and then running:
  45.  
  46. atob < xx | crypt | uncompress
  47.  
  48. (crypt requests the key from the terminal,
  49. and the "secrets" come out on the terminal).
  50.  
  51. AUTHOR
  52.  
  53. Paul Rutter (modified by Joe Orost)
  54.  
  55. FEATURES
  56.  
  57. Btoa uses a compact base-85 encoding so that 4 bytes are encoded into 5    characters (file is expanded by 25%). As a special case, 32-bit zero is
  58. encoded as one character.  This encoding produces less output than
  59. uuencode "(1)."
  60.  
  61. "SEE ALSO"
  62.  
  63.    compress(1), crypt(1), uuencode(1), mail(1)
  64.