home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64-128Toolkit / ACE14E.SFX / ace14-fx.doc < prev    next >
Encoding:
Text File  |  1990-02-12  |  9.0 KB  |  177 lines
  1.  
  2. ┴├┼-128/64 ╞╪ ─╧├╒═┼╬╘┴╘╔╧╬  FOR VERSION 0.98   [╩UNE 22, 1995]
  3. ------------------------------------------------------------------------------
  4. 1. ╔╬╘╥╧─╒├╘╔╧╬
  5.  
  6. ╔F YOU USE YOUR ├OMMODORE FOR TELECOMMUNICATIONS, THEN YOU ARE BASICALLY
  7. INTERESTED IN TWO THINGS: USING YOUR ├= TO EMULATE A TERMINAL FOR INTERACTIVE
  8. STUFF, AND USING MODEM-FILE-TRANSFER PROTOCOLS TO UPLOAD AND DOWNLOAD FILES
  9. FROM AND TO YOUR ├OMMODORE.
  10.  
  11. ╘HIS DOCUMENT DESCRIBES A CUSTOM UPLOAD/DOWNLOAD PROTOCOL THAT WAS DESIGNED
  12. FOR USE WITH THE ┴├┼-128/64 SYSTEM AND IS FREELY AVAILABLE TO ANYONE WHO WANTS
  13. IT (WELL, WHEN ╔ FINISH WITH THE ╥ELEASE #14 OF ┴├┼).  ╫HILE THIS PROTOCOL
  14. NON-STANDARD, IT BLOWS THE DOORS OFF OF ALL OTHER PROTOCOLS AVAILABLE FOR
  15. ├OMMODORE COMPUTERS, EVEN THOUGH IT USES A SIMPLE "STOP-AND-WAIT"
  16. ACKNOWLEDGEMENT SCHEME.  ╘HERE ARE TWO REASONS FOR ITS SPEED: THE FAST DEVICE
  17. DRIVERS AVAILABLE WITH ┴├┼, AND ITS LARGE PACKET SIZE, UP TO ABOUT 18╦
  18. (ALTHOUGH THIS COULD BE SIGNIFICANTLY LARGER IF ┴├┼'S MEMORY USAGE WERE
  19. REORGANIZED).
  20.  
  21. ╘HE NAME OF THE PROTOCOL IS "├RAIG'S ╞ILE E╪CHANGE ╨ROTOCOL", OR JUST "╞╪" FOR
  22. SHORT.  ╔T IS "FILE EXCHANGE" RATHER THAN "UPLOAD" OR "DOWNLOAD" BECAUSE YOU
  23. WILL USE THE SAME ACTIVATION OF THE PROGRAM TO BOTH UPLOAD AND DOWNLOAD ALL OF
  24. THE FILES YOU NAME.
  25.  
  26. ╧NE NOTE ABOUT THIS DOCUMENT: IT IS AN ABBREVIATED FORM OF AN ARTICLE WRITTEN
  27. BY ME IN ├= ╚ACKING #10.  ╥EFER THERE FOR AN IN-DEPTH DISCUSSION OF THE
  28. IMPLEMENTATION DETAILS.
  29.  
  30. 2. ╒╙┴╟┼
  31.  
  32. ╘HE CURRENT IMPLEMENTATION OF ╞╪ CONSISTS OF A "CLIENT" PROGRAM FOR YOU TO RUN
  33. ON YOUR ├OMMODORE COMPUTER AND A "SERVER" PROGRAM THAT YOU RUN ON YOUR ╒NIX
  34. HOST.  ╘HERE IS CURRENTLY NO SERVER PROGRAM FOR ANY OTHER PLATFORM, BUT THE
  35. NECESSARY CHANGES TO THE ├-LANGUAGE PROGRAM WOULDN'T BE TOO HARD.  ╘HE CLIENT
  36. PROGRAM IS WRITTEN IN 6502 ASSEMBLER, OF COURSE (FOR THE ┴├┼-ASSEMBLER TO BE
  37. SPECIFIC).
  38.  
  39. ╞╪ IS AN EXTERNAL PROGRAM FROM THE TERMINAL PROGRAM, SO (FOR NOW) TO ACTIVATE
  40. ╞╪, YOU HAVE TO EXIT FROM THE TERMINAL PROGRAM AND ENTER THE ╞╪ COMMAND LINE,
  41. EXCHANGE THE FILES, AND THEN RE-ENTER THE TERMINAL PROGRAM FROM THE COMMAND
  42. LINE.
  43.  
  44. ╫HEN YOU RUN ╞╪, YOU WILL ACTIVATE THE ╙ERVER PROGRAM FIRST ON YOUR ╒NIX HOST
  45. AND THEN EXIT THE TERMINAL PROGRAM AND RUN THE ├LIENT PROGRAM ON YOUR
  46. ├OMMODORE.  ┘OU RUN THE COMMAND "FX" ON BOTH THE CLIENT AND SERVER MACHINES,
  47. WHICH MAY BE A LITTLE CONFUSING (BUT ╔ THINK YOU'LL GET USED TO IT), AND NAME
  48. THE FILES THAT YOU WANT TO HAVE TRANSFERRED AS ARGUMENTS TO THE COMMAND ON THE
  49. MACHINE THAT YOU WANT TO TRANSFER THE FILES ╞╥╧═.  ╘HE USAGE OF THE "FX"
  50. COMMAND IS AS FOLLOWS:
  51.  
  52. FX [-DLV╓78K] [-M MAXIMUMS] [-F ARGFILE] [[-B] BINFILE ...] [-T TEXTFILE ...]
  53.  
  54. -D = DEBUG MODE
  55. -L = WRITE TO LOG FILE ("FX.LOG")
  56. -V = VERBOSE LOG/DEBUG MODE
  57. -╓ = EXTREMELY VERBOSE LOG/DEBUG MODE
  58. -7 = USE SEVEN-BIT ENCODING
  59. -8 = USE SEVEN-BIT ENCODING
  60. -K = USE 1╦ PACKET SIZES FOR ALL TRANSFER TYPES
  61. -M = SET MAXIMUM PACKET SIZES; MAXIMUMS = ULBIN/ULTXT/DLBIN/DLTXT (BYTES)
  62. -F = TAKE ARGUMENTS ONE-PER-LINE FROM GIVEN ARGFILE
  63. -B = BINARY FILES PREFIX
  64. -T = TEXT FILES PREFIX
  65. -HELP = HELP
  66.  
  67. WELL, FOR THE SERVER, ANYWAY.  ╘HE CLIENT PROGRAM DOESN'T HAVE THE MORE
  68. EXOTIC OPTIONS.  ╘HE "-D", "-L", "-V", AND "-╓" OPTIONS ARE AVAILABLE ONLY
  69. ON THE ╙ERVER PROGRAM, AND ARE FOR DEBUGGING PURPOSES ONLY.
  70.  
  71. ╘HE "-7" OPTION TELLS THE PROTOCOL TO USE ONLY 7-BIT DATA.  ╔.E., IT TELLS IT
  72. TO NOT USE THE 8TH BIT POSITION IN THE DATA IS TRANSMITTED.  ╘HIS IS USEFUL IF
  73. YOU ARE FORCED INTO THE HUMILIATION OF ONLY BEING ABLE TO USE A 7-BIT CHANNEL
  74. TO YOUR ╒NIX HOST.  ┘OU NEED ONLY NEED TO GIVE THIS OPTION ON EITHER THE
  75. CLIENT OR THE HOST COMMAND LINE AND THE OTHER SIDE WILL BE INFORMED.  ╔T MAY
  76. BE USEFUL TO CREATE AN ALIAS FOR THIS COMMAND WITH ALL OF YOUR OPTIONS SET TO
  77. WHAT YOU WANT THEM TO BE.  ╘HE "-8" OPTION IS DEFAULT.
  78.  
  79. ╘HE PROTOCOL HAS THE CAPACITY TO USE DIFFERENT PACKET SIZES FOR FOUR TYPES OF
  80. FILE-TRANSFER SITUATIONS: UPLOADING BINARY DATA, UPLOADING TEXT, DOWNLOADING
  81. BINARY DATA, AND DOWNLOADING TEXT.  ╘HESE ARE USEFUL DISTINCTIONS, SINCE YOUR
  82. HOST MAY OR MAY NOT BE ABLE TO HANDLE THE LARGER PACKET SIZES WITHOUT LOSING
  83. BYTES (YOUR ├OMMODORE, OF COURSE, CAN HANDLE THE LARGER PACKET SIZES WITH NO
  84. PROBLEMS).
  85.  
  86. ╔N DETERMINING WHICH PACKET SIZE TO USE FOR A FILE TRANSFER (WHERE THE TYPE OF
  87. TRANSFER IS KNOWN), THE PROTOCOL FINDS THAT LARGEST PACKET SIZE THAT BOTH THE
  88. CLIENT AND THE SERVER CAN HANDLE AND THEN TAKE THE MINIMUM OF THESE TWO
  89. VALUES.  ╘HE DEFAULTS FOR THE CLIENT ARE ALL THE SAME: THE MAXIMUM AMOUNT OF
  90. PROGRAM-AREA MEMORY THAT IT CAN USE, ABOUT 18╦.  ╞OR THE SERVER PROGRAM, ╔
  91. HAVE PROGRAMMED IN DEFAULT MAXIMUM UPLOADING PACKET SIZES OF 1╦ AND MAXIMUM
  92. DOWNLOADING PACKET SIZES OF 64╦-1.  ┘OU CAN CHANGE THESE DEFAULTS IN THE ├
  93. PROGRAM EASILY BY CHANGING SOME "#DEFINE"S.
  94.  
  95. ╘HE "-M" OPTION ALLOWS YOU TO MANUALLY SET THE DEFAULT PACKET SIZES FOR A
  96. TRANSFER.  ╘HE ARGUMENT FOLLOWING THE "-M" FLAG SHOULD HAVE FOUR NUMBERS
  97. WITH SLASHES BETWEEN THEM, WHICH GIVE THE MAXIMUM ULBIN/ULTXT/DLBIN/DLTXT
  98. PACKET SIZES, RESPECTIVELY.  ╬OTE THAT THE PACKET SIZES ONLY INCLUDE THE
  99. SIZE OF THE USER DATA ENCODED INTO PACKETS AND NOT THE CONTROL OR QUOTING
  100. INFORMATION (BELOW).  ╘HE "-K" COMMAND-LINE OPTION SAYS TO USE 1╦ PACKET
  101. SIZES FOR EVERYTHING, WHICH MAY BE NECESSARY IF THE HARDWARE FLOW CONTROL
  102. ISN'T SET UP PROPERLY ALL THE WAY FROM HOST TO ├OMMIE.
  103.  
  104. ╘HE "-F" OPTION ON THE SERVER ALLOWS YOU TO READ ARGUMENTS FROM A FILE RATHER
  105. THAN THE COMMAND LINE.  ╘HIS IS USEFUL IF WANT TO GENERATE AND EDIT THE LIST
  106. OF FILES TO DOWNLOAD BEFORE YOU RUN THE ╞╪ COMMAND.  ╔T'S ALSO USEFUL IF YOU
  107. DON'T WANT OTHER USERS TO SEE THE NAMES OF THE FILES THAT YOU ARE
  108. DOWNLOADING.  ╘HE NAME OF THE FILE COMES IN THE FIRST ARGUMENT FOLLOWING THE
  109. "-F" FLAG AND THE ARGUMENTS ARE PUT INTO THIS FILE ONE-PER-LINE.  ┘OU CAN PUT
  110. IN "-" OPTIONS IN ADDITION TO FILENAMES IF YOU WISH (LIKE "-T" AND "-B").
  111. ╘HIS OPTION IS NOT SUPPORTED ON THE CLIENT PROGRAM.
  112.  
  113. ╞INALLY COME THE "-B", "-T", AND FILENAME ARGUMENTS.  ╘HE "-B" ARGUMENT TELLS
  114. ╞╪ THAT ALL OF THE FOLLOWING FILENAMES (UNTIL THE NEXT "-T" OPTION) ARE BINARY
  115. FILES AND THE "-T" ARGUMENT SAYS THAT THE FOLLOWING FILENAMES ARE ALL OF TEXT
  116. FILES.  ┘OU CAN USE AS MANY "-B" AND "-T" ARGUMENTS AS YOU WANT.  ╔F YOU DON'T
  117. USE ANY, THEN ALL OF THE FILES YOU NAME WILL BE ASSUMED TO BE BINARY FILES.
  118.  
  119. ╞OR EACH FILENAME YOU GIVE ON A COMMAND LINE, THAT FILE WILL BE TRANSFERRED
  120. FROM THAT MACHINE TO THE OTHER MACHINE.  ╧N BOTH ╒NIX AND ┴├┼, YOU CAN USE
  121. WILDCARDS IN YOUR FILENAMES, OF COURSE, TO TRANSFER GROUPS OF FILES.
  122.  
  123. ╘HE CLIENT PROGRAM CONTROLS THE FILE EXCHANGE, AND IT UPLOADS ALL OF ITS FILES
  124. FIRST AND THEN ASKS THE SERVER IF THE SERVER HAS ANY FILES TO BE DOWNLOADED.
  125. ╫HEN THE EXCHANGE IS COMPLETED, BOTH THE CLIENT AND SERVER ╞╪ PROGRAMS WILL
  126. EXIT AND YOU WILL FIND YOURSELF BACK ON THE COMMAND LINES IN BOTH
  127. ENVIRONMENTS.  ╥E-ENTER THE TERMINAL PROGRAM TO CONTINUE WITH YOUR ONLINE
  128. SESSION.  ╔F SOMETHING GOES VERY WRONG DURING A TRANSFER OR IF YOU DECIDE THAT
  129. YOU DON'T REALLY WANT TO TRANSFER ANY FILES AFTER ACTIVATING THE SERVER
  130. PROGRAM, YOU CAN TYPE THREE ├TRL-╪'S TO ABORT THE SERVER.  ╘HIS IS THE SAME AS
  131. FOR THE ╪-MODEM PROTOCOL.
  132.  
  133. 3. ╨┼╥╞╧╥═┴╬├┼
  134.  
  135. ╚ERE IS MY PERFORMANCE TESTING SO FAR, USING MY ╒╙╥ ╙PORTSTER MODEM OVER A
  136. 14.4-KBPS PHONE CONNECTION, WITH A 38.4-KBPS LINK TO MY MODEM FROM MY ├128, TO
  137. MY USUAL ╒NIX HOST:
  138.  
  139. ╒SING ╞╪ TO/FROM THE ┴├┼ RAMDISK, ╥┼╒:
  140.  
  141. ─OWNLOAD 156,260 BYTES OF ▐TEXT:        TIME= 54.1 SEC, RATE=2888 CPS.
  142. ─OWNLOAD 151,267 BYTES OF TABULAR TEXT: TIME= 45.9 SEC, RATE=3296 CPS.
  143. ─OWNLOAD 141,299 BYTES OF ╩╨┼╟ IMAGE:   TIME= 92.5 SEC, RATE=1528 CPS.
  144. ╒PLOAD   156,260 BYTES OF ▐TEXT:        TIME= 57.4 SEC, RATE=2722 CPS.
  145. ╒PLOAD   151,267 BYTES OF TABULAR TEXT: TIME= 45.3 SEC, RATE=3339 CPS.
  146. ╒PLOAD   141,299 BYTES OF ╩╨┼╟ IMAGE:   TIME= 95.0 SEC, RATE=1487 CPS.
  147.  
  148. ╒SING ╞╪ TO/FROM MY ├═─ ╚ARD ─RIVE:
  149.  
  150. ─OWNLOAD 156,260 BYTES OF ▐TEXT:        TIME= 83.4 SEC, RATE=1874 CPS.
  151. ─OWNLOAD 151,267 BYTES OF TABULAR TEXT: TIME= 75.4 SEC, RATE=2006 CPS.
  152. ─OWNLOAD 141,299 BYTES OF ╩╨┼╟ IMAGE:   TIME=118.2 SEC, RATE=1195 CPS.
  153. ╒PLOAD   156,260 BYTES OF ▐TEXT:        TIME= 77.9 SEC, RATE=2006 CPS.
  154. ╒PLOAD   151,267 BYTES OF TABULAR TEXT: TIME= 66.2 SEC, RATE=2285 CPS.
  155. ╒PLOAD   141,299 BYTES OF ╩╨┼╟ IMAGE:   TIME=114.2 SEC, RATE=1237 CPS.
  156.  
  157. ╒SING ─ES╘ERM-128 V2.00 TO/FROM MY ├═─ ╚ARD ─RIVE, ┘-═ODEM:
  158.  
  159. ─OWNLOAD 156,260 BYTES OF ▐TEXT:        TIME=189.5 SEC, RATE= 824 CPS.
  160. ─OWNLOAD 151,267 BYTES OF TABULAR TEXT: TIME=180.4 SEC, RATE= 839 CPS.
  161. ─OWNLOAD 141,299 BYTES OF ╩╨┼╟ IMAGE:   TIME=199.9 SEC, RATE= 707 CPS.
  162. ╒PLOAD   156,260 BYTES OF ▐TEXT:        TIME=255.1 SEC, RATE= 611 CPS.
  163. ╒PLOAD   151,267 BYTES OF TABULAR TEXT: TIME=238.6 SEC, RATE= 634 CPS.
  164. ╒PLOAD   141,299 BYTES OF ╩╨┼╟ IMAGE:   TIME=233.0 SEC, RATE= 606 CPS.
  165.  
  166. ╒SING ╬OVA╘ERM-64 V9.5 TO MY ├═─ ╚ARD ─RIVE, ┌-═ODEM, ├64 MODE:
  167.  
  168. ─OWNLOAD 156,260 BYTES OF ▐TEXT:        TIME=245.8 SEC, RATE= 636 CPS.
  169. ─OWNLOAD 151,267 BYTES OF TABULAR TEXT: TIME=230.0 SEC, RATE= 658 CPS.
  170. ─OWNLOAD 141,299 BYTES OF ╩╨┼╟ IMAGE:   TIME=262.6 SEC, RATE= 538 CPS.
  171.  
  172. (╘HERE IS NO ┌-═ODEM UPLOADING SUPPORT)
  173.  
  174. ╙O THERE YOU HAVE IT: MY SIMPLE PROTOCOL BLOWS THE OTHERS AWAY.  ╤┼─.
  175. ------------------------------------------------------------------------END---
  176.  
  177.