home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / fileutil / tcpy202.zip / TCTECH.DOC < prev   
Text File  |  1993-10-15  |  10KB  |  196 lines
  1.  
  2.      TTTTT  U   U  RRRR   BBBB    OOO    CCC    OOO   PPPP   Y   Y
  3.        T    U   U  R   R  B   B  O   O  C   C  O   O  P   P  Y   Y
  4.        T    U   U  RRRR   BBBB   O   O  C      O   O  PPPP    YYYY
  5.        T    U   U  R   R  B   B  O   O  C   C  O   O  P          Y
  6.        T     UUU   R   R  BBBB    OOO    CCC    OOO   P      YYYY
  7.  
  8.  
  9.                               version 2.02
  10.  
  11.                      by Pierre J. le Riche 1991-93
  12.  
  13.               A Speedy Multi-Volume File Transfer Program
  14.  
  15.                           Technical Reference
  16.  
  17. ***************
  18. *Introduction:*
  19. ***************
  20. TurboCopy version 1.00 was completed during October 1991, since then I
  21. have constantly updated the program and added new options. TurboCopy
  22. progressed until version 1.15 when I decided a complete rewrite has
  23. become necessary. From the outset I wanted TurboCopy 2.00 to be the
  24. fastest and most versatile copy program available, and yet keep it as
  25. simple to operate as possible. I hope you will agree that I have been
  26. successful in this endeavour. To maintain high speed and small code size
  27. I have opted to write the complete package in 8088 assembly language. At
  28. the moment the source is just under 10,000 lines long. I am not
  29. distributing the source code for version 2, but I am including the
  30. source for version 1.15 in this package. (If you can yank my arm hard
  31. enough I might consider sending you the source for version 2, but that
  32. is only in very exceptional circumstances!)
  33.  
  34. ****************
  35. *Compatibility:*
  36. ****************
  37. TurboCopy is compatible with the xcopy command line except for the /e
  38. and /p options that have been given new meanings. TurboCopy has been
  39. tested with Christoph H. Hochstätter's FDRead and works fine (However,
  40. since version 2.01, TC also has FDRead emulation built in, so you would
  41. normally not need this driver). I also recommend that if you want even
  42. more speed, that you use his FDFormat program to format your floppies
  43. with sector sliding. Due to TurboCopy's internal cache, you are not
  44. allowed to TurboCopy to a phantom floppy drive B:. Furthermore,
  45. TurboCopy runs on any IBM compatible computer under DOS (version 3.00 or
  46. later), OS/2 or Windows. TC will automatically disable it's built in
  47. cache under OS/2 and on some older XTs, due to compatibility problems.
  48.  
  49. IMPORTANT! Disable TC's built in writeback cache with the /Z- option (or
  50.            in the setup with the /U option) if you intend to use a cache
  51.            with delayed writes on your floppy drives (read caching is
  52.            OK). Two writeback cache programs competing for the same
  53.            floppy disk at the same time could lead to an unhealthy state
  54.            of affairs (at least for the floppy)!
  55.  
  56. **********************
  57. *Memory requirements:*
  58. **********************
  59. TurboCopy will utilise all conventional, extended and expanded memory if
  60. it is available (up to a maximum of 3072K). For the cache to be enabled,
  61. TurboCopy requires 384K conventional memory. With the cache disabled TC
  62. can operate with as little as 196K conventional memory. During a DOS
  63. shell TC will typically occupy about 25K conventional memory. Do not
  64. load any TSR programs while in a DOS shell for this will fragment your
  65. conventional memory pool, and TC will refuse to continue.
  66.  
  67. *******************
  68. *Errorlevel codes:*
  69. *******************
  70. If you want to detect any errors that may have ocurred during a
  71. file transfer fromout a batch file, you may expect one of the following
  72. return codes:
  73.         0 = No error ocurred, the copy was successfully completed
  74.         1 = The user tried a illegal combination of options, i.e.
  75.             A and M together.
  76.         2 = The user pressed break or selected "Quit" from a prompt.
  77.         3 = An error ocurred from inside the floppy disk cache.
  78.         4 = An error ocurred during memory allocation
  79.         5 = A bad or invalid source path was specified.
  80.         6 = A bad or invalid destination path was specified.
  81.         7 = TurboCopy couldn't match any files to copy.
  82.         8 = No source path specified.
  83.         9 = You tried to TurboCopy to a phantom floppy drive B:.
  84.         10 = The source contained too many files for TC to handle.
  85.         11 = The source contained too many subdirectories for TC to
  86.              handle.
  87.         12 = TC couldn't save your configuration (encountered with
  88.              TC/U).
  89.         13 = A nonexistant or corrupt list file was specified.
  90.         14 = The TC.COM file has been corrupted.
  91.         15 = TC was unable to delete a file in manual file selection box
  92.         16 = TC was unable to rename a file in manual file selection box
  93.  
  94. ****************
  95. *Error messages*
  96. ****************
  97. TurboCopy checks for numerous different error conditions. I have tried
  98. to make TC's error messages as informative as possible, and therefore
  99. you should not experience any trouble determining what went wrong in the
  100. event of a failed copy. For completeness I will include a list of error
  101. messages with a short discription for those that might be a bit
  102. confusing:
  103.  
  104. Unable to reclaim conventional memory.
  105.         TC will issue this error after a shell if it is unable to
  106.         reclaim the full amount of conventional memory it had before the
  107.         shell, i.e. if you loaded a TSR while in a DOS shell.
  108. Not enough space on disk for any files.
  109. Destination root directory full.
  110.         All disks have a limit to the number of files their root
  111.         directories can contain. For 360K floppies it is 112 and for
  112.         most others it is 224 (including the volume label), so if you
  113.         are out of root directory enrtries you may waste precious space
  114.         on the disk.
  115. Error writing file xxxxxxxx.xxx
  116. Error reading source
  117. Error during floppy cache writeback
  118.         This error is encountered when the floppy cache encountered an
  119.         error while doing a disk writeback and was unable to recover.
  120. Bad source file skipped.
  121.         If your source drive contained a file with a bad sector or data
  122.         error, TC will ask you whether you want to skip the bad file and
  123.         continue or if you want to quit.
  124. Sliced file will continue on next disk.
  125.         If you are busy slicing a file and TC detects that there already
  126.         exists a file with the name of the current sliced volume on the
  127.         current destination disk, and you opted to skip the file, then
  128.         TC will continue with the sliced file on the next disk.
  129. xxxxxxxx.xxx exists. AppEnd, SkIp all, Overwrite all or Rename?
  130. Unable to create subdirectory.
  131. Unable to delete source file.
  132. Unable to reset source file's archive attribute.
  133. Unable to remove empty source directories.
  134. Unable to quickformat destination disk.
  135.         TC will only format floppy disks in drive A: or B: that meets
  136.         the following criteria: It must have two FATs, 512 byte sectors
  137.         and 12-bit FAT entries.
  138. Quickformat warning: Disk has not been changed!
  139.         If you specified the /Q option and TC prompted you for the next
  140.         floppy disk, and you pressed any key before changing the disk,
  141.         TC will display this message. It is to prevent TC from deleting
  142.         data just copied.
  143. Bad source drive 'x:'
  144. Bad destination drive 'x:'
  145. Bad source path: c:\xxxxxx\xxxxx
  146. Move operation might require more workspace.
  147.         The /X option, when the source and destination is the same
  148.         drive, uses a minimal amount of workspace (typically one
  149.         cluster).
  150. No files to copy.
  151. Duplicate xxxxxxxx.xxx with /C option. Skip file, Ignore or Quit?
  152.         If you specifies /S and /C and TC encounters two files with
  153.         exactly the same filename, TC will display this message.
  154. Too many subdirectories.
  155. Too many files.
  156. Invalid date specified.
  157.         Dates specified with /D must be in the format specified by the
  158.         COUNTRY setting in your Config.sys file.
  159. Cannot TurboCopy to/from phantom floppy drive B:.
  160.         Due to the built-in cache, TC can only copy to actual physical
  161.         drives and not substituted floppies.
  162. Bad verbosity level specified.
  163.         Verbosity levels specified with /T range from 0 to 9.
  164. A and M options may not be used together.
  165. I, E, N and O options may not be used together.
  166. Turbocopy requires ?K of memory, thus you will have to free another ?K.
  167. No source specified.
  168. Bad list file specified.
  169. Illegal command in list file.
  170. Destination is ambiguous. Is 'xxxxxxxx.xxx' a Directory or a File?
  171. WARNING! Insufficient conventional memory for cache.
  172. (Mirror buffer full)
  173.         TC will append this message to your mirror output file (refer to
  174.         /K option) if it ran out of buffer space (approximately 64K).
  175. Unable to delete file xxxxxxxx.xxx
  176. Unable to rename file xxxxxxxx.xxx
  177.         Both error messages given above may occur in the manual file
  178.         selection box with the use of the ALT-D and ALT-R functions.
  179.  
  180. ************
  181. *Final Note*
  182. ************
  183. If you would like any personalised changes, or you have any suggestions,
  184. feel free to contact me at the address given. If you are writing
  185. something similar, or if you are just interested in obtaining some of my
  186. routines; feel free to contact me and I will send them to you (on the
  187. condition that you mention in your program where you got them). Finally,
  188. please don't hack this program into itsy little bits or edit the
  189. documentation or something equally low. I have not built any heavy copy
  190. protection into TC, so it should not be difficult to change the program
  191. at all; so don't see it as an achievement if you manage to mess it up.
  192. Please contact me if you want any changes.
  193.  
  194. Thank you for your interest in this program.
  195.  
  196.