home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 536.lha / QDCopy_v1.0 / QDCopy.Doc.pp / QDCopy.Doc
Text File  |  1991-08-09  |  13KB  |  292 lines
  1. QDCopy Version 1.0  (July 15, 1991)
  2.  
  3. Quick & Dirty File Copier (or Qwazy Darren File Copier!)
  4.  
  5. Copyright (C) 1991 by Darren Ewaniuk
  6.  
  7. -----------------------------------------------------------------------------
  8.  
  9. Description:
  10.  
  11. QDCopy is a file copier geared to one floppy drive systems.  It allows you
  12. to copy multiple files at one time with a minimum of disk swaps.  It also
  13. allows you to copy to multiple destination disks, so when one destination
  14. disk is full QDCopy will ask for a new one and continue on with the copy.
  15. QDCopy will duplicate the comment and protection bits for files it copies.
  16.  
  17. -----------------------------------------------------------------------------
  18.  
  19. Requirements:
  20.  
  21. ARP library V39+ is required. Other than that, any basic Amiga computer
  22. system with one or more floppy disk drives will do.  This program was
  23. actually designed for one drive users.
  24.  
  25. -----------------------------------------------------------------------------
  26.  
  27. Installation:
  28.  
  29. Install arp.library in your LIBS: directory if it isn't already there.
  30. Install QDCopy in your command path.  C: is a good candidate for floppy
  31. drive systems.
  32.  
  33. -----------------------------------------------------------------------------
  34.  
  35. Usage:
  36.  
  37. QDCopy is fairly easy to use.  The CLI/Shell command line is:
  38.  
  39.     QDCopy <Source pattern> <Destination path>
  40.  
  41.         <Source pattern> is a filename or wildcard filename which tells
  42.             QDCopy which file or files to copy.  The pattern can be any
  43.             AmigaDOS or ARP wildcard.
  44.  
  45.         <Destination path> is a disk or directory name to copy the file or
  46.             files to.  The "/" at the end of a directory name is optional
  47.             and is not required.
  48.  
  49.         If the source pattern or destination path have spaces or special
  50.             characters in them, enclose them in double quotes.
  51.  
  52. If the destination disk is full, or QDCopy cannot write to the disk (if
  53. there's an error or if the disk is write protected), QDCopy will ask for a
  54. new disk and will allow you to type in a new destination path if necessary.
  55.  
  56. If the source pattern or destination path have a device or disk name in them,
  57. QDCopy will prompt for the disk during each pass.  If the source pattern or
  58. destination path are relative to the current directory, it will not ask
  59. for the disk, assuming that you are copying to or from a hard disk.
  60.  
  61. To abort the copy, issue a break command to QDCopy be pressing Control-C.
  62. If you are currently being prompted for a disk, you must press the Return
  63. key before the break is recognized.
  64.  
  65. If possible, use disk names rather than device names, so that if you insert
  66. the wrong disk for source or destination, the system will ask for the
  67. correct one.  "DF0:" and "DF1:" are device names, while disk names are
  68. like "Music Disk # 1:" and "MyGames:".
  69.  
  70. For script users, QDCopy will return one of these error codes when completed:
  71.  
  72. 0:          All files copied successfully.
  73.  
  74. 1:          Not enough arguments in command line.
  75.  
  76. 5:  (WARN)  All files could not be copied successfully.  Either some files
  77.             could not be read or written, or some information such as
  78.             the protection bits or comment could not be set.
  79.  
  80. 6:  (WARN)  QDCopy was interrupted with a CONTROL-C break.
  81.  
  82. 10: (ERROR) QDCopy could not get enough memory to run, or could not open
  83.             the ARP library.
  84.  
  85. -----------------------------------------------------------------------------
  86.  
  87. Examples:
  88.  
  89.     QDCopy DF0:#? DF0:
  90.  
  91.         Copies all the files in the root directory of a floppy disk in drive
  92.         "DF0:" to another floppy disk in drive "DF0:"
  93.  
  94.     QDCopy ST-00:Mod#? "Music Disk:"
  95.  
  96.         Copies all the files starting with "Mod" from a floppy disk named
  97.         "ST-00:" to a floppy disk named "Music Disk:".  These disks can be in
  98.         any disk drive if you have more than one of them.
  99.  
  100.     QDCopy C/#?Virus#? DF0:
  101.  
  102.         Copies all the files in directory "C" with "Virus" as part of their
  103.         name to a floppy disk in drive "DF0:"
  104.  
  105. -----------------------------------------------------------------------------
  106.  
  107. Limitations:
  108.  
  109. -   Each file loaded must be loaded into one chunk of contiguous memory.
  110.     If more than one file is loaded, they can each be in isolated fragments
  111.     of memory, but a single file cannot be split in memory.
  112.  
  113. -   QDCopy won't split a file up.  Therefore, it can't copy files bigger than
  114.     memory. If I remove the contiguous memory limitation, this will be easy
  115.     to implement.
  116.  
  117. -   Not too much memory checking at the time.  Given enough small size files,
  118.     QDCopy will use every bit of memory availible to it, not leaving a
  119.     'stop-gap'.  Some might consider this a feature I guess, but if you're
  120.     heavily multitasking when this happens, you'll have to wait until QDCopy
  121.     releases some memory up if your other programs need more memory.  It does
  122.     ask nicely for memory, though, and shouldn't cause GURUS.
  123.  
  124. -   QDCopy doesn't optimize memory or disk space usage.  QDCopy stops the
  125.     reading phase when it encounters the first file that won't fit in the
  126.     availible contiguous memory, even if the next file could fit.  Likewise,
  127.     when it is writing to the disk, and the disk is full, it will just
  128.     prompt for another disk rather than checking to see if the rest of the
  129.     files currently buffered will fit.
  130.  
  131. -   QDCopy will only detect a full disk after it attempts to write a file
  132.     onto it.  If the disk is full, it attempts to delete the incomplete
  133.     file, and prompts for a new disk.  Checking the disk space before
  134.     writing to the disk is a little more complicated, since different file
  135.     systems have different block lengths, and since writing a new file also
  136.     involves disk space overhead.  Basically, you cannot easily calculate
  137.     if a file of a given size will fit on a disk.  Guess wrong, and
  138.     you waste space or end up with a disk full error anyways.
  139.  
  140.     The above five points I can probably improve on, given enough time and
  141.     interest from you.
  142.  
  143. -   The program will only copy files from one directory at a time.  The
  144.     wildcard routines can handle multiple directories easily enough, but the
  145.     problem is how to handle the naming of the files in the destination
  146.     path.
  147.  
  148. -   The program will not rename destination files, such as ARP's nifty
  149.     mass wildcard copy/rename operation.  I don't know how to do this.
  150.  
  151. -   No command line options.  If there are any that you want, please tell me!
  152.  
  153. -----------------------------------------------------------------------------
  154.  
  155. Bugs:
  156.  
  157. No known bugs at this time.  Please notify me of any bugs, crashes,
  158. enforcer hits, or bad programming practises you notice in this program.
  159.  
  160. -----------------------------------------------------------------------------
  161.  
  162. Revision history:
  163.  
  164. 10-Jul-91 - Creation date
  165.  
  166. 15-Jul-91 - Version 1.0     First public release
  167.  
  168. -----------------------------------------------------------------------------
  169.  
  170. Disclaimer:
  171.  
  172. This program works to my knowledge.  However, bugs may indeed be lurking
  173. in this code, so if you choose to use this program, be forewarned.
  174. I am not responsible for any loss or inconvenience caused by this program,
  175. and it has no warranty or guarantee.
  176.  
  177. If you discover any bugs or missing features, I would like to know about
  178. them so that I can fix them when I have the time.
  179.  
  180. -----------------------------------------------------------------------------
  181.  
  182. Distribution:
  183.  
  184. This program is 'User Group Ware'.
  185. If you like it, join your local Amiga users group, and send me a letter
  186. telling me about your user group.  You will then be a 'registered' user
  187. of the program.  You will also benefit from being a member of a users
  188. group, so its a win-win situation.
  189.  
  190. If you feel like it, you can send money or some freely
  191. distributable software that you like, but this is purely optional.
  192.  
  193. For companies wishing to use this program for their own internal use, a
  194. donation to the local user group greater than or equivalent to membership
  195. fees for one year will suffice to become a 'registered' user.
  196.  
  197. The local user group here is AmiCUE (Amiga Commodore Users of Edmonton).
  198. Meetings are on the third Thursday of every month.
  199. Call 469-6694 for more information.
  200.  
  201. If you want updates, or request a new feature, send me a disk and enough
  202. postage to get it back to you from here and I'll send you the latest
  203. version, and anything else new I might come up with (if anything).
  204.  
  205. This program is freely distributable, with the following conditions:
  206.  
  207. 1) This program shall not be used commercially without my prior permission.
  208.    Companies using this for their own internal use are free to use it as
  209.    stated above.  All in all, this means that, without prior permission:
  210.  
  211.    a) This program cannot be used in a commercial package.
  212.  
  213.    b) This program cannot be used on disk magazines and on disks which sell
  214.       for more than what Fred Fish charges for his disk collection at the
  215.       time.  Currently, this is $6.00US.  Convert this to local currency, and
  216.       if the selling price without tax is more than this, you can't sell it!
  217.  
  218.       Permission is explicitly granted to Fred Fish and all registered
  219.       Amiga user groups to distribute this program.
  220.  
  221. 2) This program shall be distributed with all files intact.  This means that:
  222.  
  223.    a) All files must be distributed, including the executable, source code,
  224.       and documentation.
  225.  
  226.    b) This program must not be disk warped.  Disk warps are a pain for hard
  227.       drive users, are prone to virus infections, and some are not reliable.
  228.       LZH, ZIP, ZOO, ARC, PAK, and similiar file-oriented archives are fine.
  229.  
  230.    c) None of the files should be distributed in powerpacked or likewise
  231.       crunched form.  You may do so for your own use, but keep the original
  232.       uncrunched form for distribution, so that others may use it without
  233.       requiring special programs or suffering from that 'uncrunch' flash.
  234.  
  235.    d) If you modify this program and wish to distribute it, you are free to
  236.       do so as long as you include your modified source code and executable
  237.       AS WELL AS the original source code, executable, and other files in
  238.       this distribution.  Also, the conditions of the distribution must not
  239.       be changed (you still can't sell it or use it commercially).
  240.  
  241. In short, I don't want others taking credit for or making money from this
  242. software, and don't want it to be distributed with missing or hacked up
  243. files.  Remember that I can waive any of the rules if you talk to me first!
  244.  
  245. -----------------------------------------------------------------------------
  246.  
  247. How to reach me:
  248.  
  249. MAIL:    Darren Ewaniuk
  250.          Box 1262
  251.          Vegreville AB CANADA
  252.          T0B 4L0
  253.  
  254.          This is my permanent address and will not change, unlike my
  255.          present address, as I am currently a student.
  256.  
  257. PHONE:   (403)452-2658 (until end of December 1991)
  258.          (403)768-2431 (after December 1991 or if above fails)
  259.  
  260. USENET:  ewaniu@ee.ualberta.ca  -or-  ewaniu@bode.ee.ualberta.ca
  261.               (until end of December 1991)
  262.  
  263.          darrene@ersys.edmonton.ab.ca
  264.               (after December 1991 or if above fails)
  265.  
  266. BBS:     I can be reached through Devil BBS in Edmonton AB CANADA.
  267.          I'm NOT the sysop here, but I do frequent this system.
  268.          My user name is (naturally) Darren Ewaniuk.
  269.  
  270.          Its a very nice BBS with over 300 megs of Amiga files.  If
  271.          its near you or if you don't mind long distance, try it out!
  272.  
  273.          Devil BBS
  274.          Sysop Basil Barnes
  275.          (403)484-9200
  276.          Running on an Amiga 2500/30, with USRobotics Dual Standard
  277.          HST/V.32/V.42 capable modem and multi-serial card.
  278.          All Amiga files, over 300MB storage, running Skyline software.
  279.          Freely distributable software only - no pirated stuff here!
  280.  
  281. -----------------------------------------------------------------------------
  282.            _________                       _________
  283.  This is  |         |            This is  |         |         DON'T DO IT!
  284.     your  |  O   O  |               your  |  x   x  |
  285. computer  |    +    |           computer  |   ___   |         Just say NO!
  286.           |  \___/  |         on pirated  |  /  U\  | ___      to piracy
  287.           |_________|           software  |_________|    \
  288.            _________   _                   _________   _  \[Computer sick
  289.           |[][][][][| |_|                 |#&%@!%$&!| |x|   with a virus]
  290.           |][][][][]| | |                /|^!*%@&*@#| | |\
  291.           |_________| |_|   [Nasty words] |_________| |_| [Dead mouse]
  292.