home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / old / ckermit4e / ckdker.utl < prev    next >
Text File  |  2020-01-01  |  5KB  |  128 lines
  1. The PC Kermit boo and de-boo programs do not work, and I found them too
  2. cumbersome and complicated to install on the DG.  In their place, I have
  3. provided a few other tools:
  4.  
  5.      uuencode and uudecode:  
  6.           Convert any binary file to a non-binary file, and preserve the
  7.           DG record and file types, if done on DG systems.
  8.      sq and usq:
  9.           CP/M (and others) squeeze and unsqueeze programs.  Should be
  10.           compatible with Unix and other hosts.
  11.      compress:
  12.           a more efficient compression than sq/usq.  Also compatible with
  13.           many hosts.
  14.  
  15. If anyone can get these other files working, more power to you.  I have made
  16. an initial attempt in ckdmkb.c and ckdpct.c, but these files do not work.
  17.  
  18. The uudecode program is slow, but the squeeze programs are very fast.  The
  19. uudecode could be faster, but I did not want to wasted alot of time on it. 
  20. Anyway, the uudecode source is very simple, and should be easy to convert to
  21. another language.  If you do convert the uudecode program, please let me know,
  22. so that it can be distributed to hosts that do not have the C compiler. 
  23.  
  24. In order to unpack all the encoded and compressed files, you must first get
  25. the uudecode program running.  The C source can be compiled easily and
  26. directly by:
  27.  
  28.      rename ckdecod.c uudecode.c
  29.      cc/link uudecode
  30.      
  31. But, if you don't have the C compiler, then uudecode.c could be translated
  32. easily into another language (see notes in ckdker.bld).  Assuming the program
  33. is now running, enter this command first to decode the unsqueeze program:
  34.  
  35.      x uudecode ckdusq.enc
  36.      
  37. Now, you should have an executable usq.pr program.  Now, use the usq program
  38. to unsqueeze the encoded compress program, and then decode the compress
  39. program: 
  40.  
  41.      x usq ckdcomp.enc.SQ
  42.      x uudecode ckdcomp.enc
  43.  
  44. Now, you will have an excutable compress.pr program.  The ckdcomp.cli and
  45. ckdunco.cli can now be used, and expect an input argument in the /file
  46. switch, such as:
  47.  
  48.      ckdcomp/file=ckdker.enc
  49.  
  50.           -or-
  51.  
  52.      x compress/i=ckdker.enc/o=ckdker.enc.Z
  53.      
  54. was used to compress the Kermit program encoded source, and produced the file
  55. ckdker.enc.Z.  To uncompress this file, you would enter:
  56.  
  57.      ckdunco/file=ckdker.enc.Z
  58.  
  59.           -or-
  60.  
  61.      x compress/i=ckdker.enc.Z/o=ckdker.enc -d
  62.      
  63.      
  64. Now, we need to uncompress the rest of the utilities mentioned above, so do
  65. the following:        
  66.  
  67.      ckdunco/file=ckdsq.enc.Z
  68.      x uudecode ckdsq.enc
  69.      ckdunco/file=ckdusq.enc.Z
  70.      x uudecode ckdusq.enc
  71.      ckdunco/file=ckdenc.enc.Z
  72.      x uudecode ckdenc.enc
  73.      
  74. The first pair of lines creates sq.pr, the next usq.pr, and the next
  75. uuencode.pr.  Now all the tools are decoded into program files.     
  76.  
  77. If you have the C compiler, or you have a system other than AOS/VS, you can
  78. recompile the sources according to the instructions in the "man" files:  
  79.  
  80.      ckdcomp.hlp         Documentation for installing compress
  81.      ckdsq.hlp           Documentation for installing sq and usq
  82.      
  83. Note that uuencode and uudecode do not have any installation instructions.    
  84.  
  85. The acknowledment for the original Unix authors is in the program source and
  86. the documentation.  Additional thanks go the Fred Fish for compiling the Fish
  87. disks of public domain software for the Commodore Amiga, which is where I got
  88. the source for these programs.  The programs should be able to compile and run
  89. as is on Amigas, the Data General minis, Unix systems, IBM PC's, and VAXes. 
  90.  
  91. These tools are also useful for porting larges files or sending over slow
  92. communication lines.  I have used the compress program to send up a file,
  93. using binary mode, of course, and then I decompressed it on the DG.  See the
  94. section in ckdker.bld, "INSTALLATION OF KERMIT FROM THE BINARY ENCODED FILES"
  95. for example usage and for additional features in the encode/decode programs. 
  96. The utility files are described below:
  97.  
  98.  
  99.      ckdker.enc          Encoded version of kermit.pr
  100.      ckdker.enc.SQ       Squeezed version of ckdker.enc
  101.      ckdker.enc.Z        Compressed version of ckdker.enc
  102.      ckdker.utl          This file
  103.      ckdmkb.c            Abortive attempt to convert msbmkb.c
  104.      ckdpct.c            Abortive attempt to convert msbpct.c
  105.      ckdcomp.c           Source to compression program (compress.c)
  106.      ckdcomp.cli         CLI macro to run compress program for compression
  107.      ckdcomp.man         compress manual 
  108.      compress.pr         compress program
  109.      ckdcomp.enc.SQ      Squeezed and compressed file for compress.pr
  110.      ckdcomp.man         Documentation for installing compress
  111.      ckdsq.man           squeeze and unsqueeze manual
  112.      sq.pr               squeeze program
  113.      ckdsq.enc.Z         Compressed and encoded file for sq.pr
  114.      ckdsq.man           Documentation for installing sq and usq
  115.      ckdunco.cli         uncompress CLI macro (uses compress program)
  116.      usq.pr              unsqueeze program
  117.      ckdusq.enc          Encoded file for usq.pr
  118.      ckdecod.c           Source for uudecode program (uudecode.c)
  119.      uudecode.pr         decode program
  120.      ckdenco.c           encode source (uuencode.c)
  121.      ckdenco.man         decode and encode manual
  122.      uuencode.pr         encode program
  123.      ckdenc.enc.Z        Compressed and encoded file for uuencode.pr
  124.  
  125.  
  126. Phil Julian, SAS Institute, Inc., Box 8000, Cary, NC 27512-8000
  127.  
  128.