home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 12: Textmags & Docs / nf_archive_12.iso / TOOLS / WIN32 / WFDCOPY-1.02.ZIP / wfdcopy.txt < prev   
Text File  |  2002-03-14  |  10KB  |  243 lines
  1.        Documentation for "Windows Floppy Disk Copy" (wfdcopy) v1.02
  2.        ------------------------------------------------------------
  3.  
  4. Copyright (c) 2000-2002, HervΘ PARISSI <hparissi@laposte.net>
  5.  
  6. http://sourceforge.net/project/?group_id=8584
  7. http://sourceforge.net/projects/wfdcopy/
  8.  
  9. -----------------------------------------------------------------------------
  10.  
  11.  This program is free software; you can redistribute it and/or modify
  12.  it under the terms of the GNU General Public License as published by
  13.  the Free Software Foundation; either version 2 of the License, or
  14.  (at your option) any later version.
  15.  
  16.  This program is distributed in the hope that it will be useful,
  17.  but WITHOUT ANY WARRANTY; without even the implied warranty of
  18.  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19.  GNU General Public License for more details.
  20.  
  21.  You should have received a copy of the GNU General Public License
  22.  along with this program; if not, write to the Free Software
  23.  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  24.  
  25. -----------------------------------------------------------------------------
  26.  
  27. 1) LICENSE
  28. ----------
  29.  
  30. wfdcopy is available under the terms of the GNU General Public License.
  31. See the file "COPYING" that is included in the distribution for details.
  32.  
  33. 2) OVERVIEW
  34. -----------
  35.  
  36. wfdcopy is a floppy disk image maker for Windows, its main purpose is to read
  37. floppy disks into image-files but it can be used to write them back or to copy
  38. a disk (be warned that these features aren't working fine, see below).
  39.  
  40. I wrote it mainly to convert floppy disks into image-files for use in emulators,
  41. especially Atari ST emulators (that why the filename extension is ".st" by
  42. default).
  43.  
  44. It should read any Atari ST and PC disks, including "overformatted" ST disks.
  45.  
  46. Warning: if you have something else than a *real* 3"1/2 1.44Mb floppy drive
  47. then your drive is not supported and wfdcopy may not work properly.
  48.  
  49. wfdcopy works under any 32-bit version of Windows.
  50.  
  51. Requirements:
  52. - Any PC running Windows 9x/ME/NT/2000/XP (including i386 : I've tested it)
  53. - 8 Mb RAM
  54. - a 3"1/2 floppy drive
  55. - some hard-disk space (2 Mb should be enough)
  56.  
  57. Read Section 7 for informations on running wfdcopy under Windows NT/2000/XP.
  58. Read Section 8 if you want to compile the sources.
  59.  
  60. 3) USAGE
  61. --------
  62.  
  63. Launch wfdcopy.exe, you should see a window with a big box splitted in several
  64. parts: it's the progression bar.
  65. The higher half corresponds to the 1st side of the disk, the lower part to the
  66. 2nd side, the little bars corresponds to each tracks.
  67.  
  68. There are 5 pushbuttons: "Disk-to-file", "File-to-disk", "Copy", "About" and
  69. "Exit" (which turns into "Cancel" while reading/writing/copying).
  70.  
  71. It's a good idea to put the floppy disk in the drive *before* pressing
  72. "Disk-to-file" and "Copy" (it's good too to do so before "File-to-disk") since
  73. the program will access the floppy to read its 1st sector.
  74.  
  75. 3a) "Disk-to-file"
  76. -----------------
  77.  
  78. The most advanced feature of this program! ;-)
  79.  
  80. It begins by reading the boot sector (1st sector of the disk) to find out the
  81. disk geometry (number of sides, tracks, sectors/tracks). You'll see an error
  82. message "Insert floppy disk" if you didn't put a disk into the drive.
  83. You should see an error like "disk changed (floppy)" too, you can ignore it
  84. and go on.
  85. You may have a Abort-Retry-Ignore Error message, that means wfdcopy didn't
  86. read the boot sector correctly. Choosing "Abort" aborts the whole operation,
  87. choosing "Retry" makes wfdcopy re-read the boot sector, and "Ignore"
  88. makes wfdcopy ignore the error and go on (be warned that, then, the disk
  89. geometry may be wrong).
  90.  
  91. Then you see the "Floppy parameters" dialog box (see below, section 4)
  92. You shouldn't have to change anything unless you know what you're doing.
  93.  
  94. Then the program asks you for a file where the read disk will be put so you
  95. will need as much disk-space as the size of the floppy to hold it.
  96. Note: don't try to put the file on the floppy, it's surely not big enough ;-)
  97. and it's really no good idea (but you're free... just do not complain)
  98.  
  99. After that, the read process should begin, you will see the progression in the,
  100. well, progression bar (see below, section 6, for the meaning of the colors).
  101.  
  102. 3b) "File-to-disk"
  103. ------------------
  104.  
  105. Just the opposite of "Disk-to-file", it asks for a file then tries to figure
  106. out the disk geometry from the 1st 512 bytes (boot-sector) of the file then
  107. asks you for "Floppy parameters" (see below, section 4).
  108. The file should be a valid floppy disk image or else you'll end up with a
  109. strange disk (but if you know what you're doing, you can put any file on a
  110. floppy disk, just like under unices).
  111.  
  112. Since formatting doesn't work well (or at all), you should use a floppy disk
  113. already formatted with the *same* geometry as the source disk.
  114.  
  115. 3c) "Copy"
  116. ----------
  117.  
  118. It's just a combination of "Disk-to-file" and "File-to-disk", using a temporary
  119. file (so you will need enough disk-space in your temporary folder to hold the
  120. disk).
  121.  
  122. 3d) "About"
  123. -----------
  124.  
  125. Well, a "nice" about dialog box...
  126.  
  127. 3e) "Exit"
  128. ----------
  129.  
  130. Are you surprised if I tell you that you can press this to exit wfdcopy ?
  131. Well, Alt+F4 or pressing the 'X' box will do the same !
  132.  
  133. 3f) "Cancel"
  134. ------------
  135.  
  136. While in operation, the "Exit" button turns into a "Cancel" button, so it just
  137. cancels any operation ("Disk-to-file", "File-to-disk", "Copy") straightforward.
  138. For instance, if you were reading a disk, you will have an unfinished file,
  139. likewise, if you were writing a disk, you will have an unfinished disk (that's
  140. quite more annoying...)
  141.  
  142. 4) "Floppy parameters" dialog-box
  143. ---------------------------------
  144.  
  145. 4a) "Tracks"
  146.     tracks/side (should be between 80 and 85)
  147.  
  148. 4b) "Sectors"
  149.     sectors/tracks (should be between 9 to 12 for 720k disk, 18 to 21 for 1.44M
  150.     disks)
  151.  
  152. 4c) "Heads"
  153.     sides/disk (1 or 2)
  154.  
  155. 4d) "Attempts"
  156.     number of read/format/write attempts before considering an error (see
  157.     below, section 5) (should be at least 3)
  158.  
  159. 4e) "Slow Mode (sector mode)"
  160.     by default, wfdcopy reads/writes the disk track-by-track, if checked,
  161.     wfdcopy    reads/writes the disk sector-by-sector which is slower but safer
  162.     since if there's a bad sector in a track and this option is not checked,
  163.     the whole track is marked as bad
  164.  
  165. 4f) "Auto-Ignore errors"
  166.     if unchecked any errors will be submited for an "Abort/Retry/Ignore"
  167.     message-box, if checked any errors will be ignored
  168.  
  169. 4g) "Format floppy" ("File-to-disk" and "Copy" only)
  170.     if checked, format the destination floppy (left this unchecked since
  171.     IT DOES NOT WORK!)
  172.  
  173. 5) About "attempts"
  174. -------------------
  175.  
  176. Most programs (including OSes) have an assumption: "if I can't read it the 1st
  177. time, I couldn't read it at all" (well some programs make 3 attempts), wfdcopy
  178. just doesn't have this assumption, instead it assumes "if I can't read it the
  179. 1st time, I try again some more times until it works or a certain amount of
  180. attempts has been done".
  181.  
  182. That's the use of the "attempts" option: to specify how many times a sector or
  183. track (depending on the "slow-mode" option) is read/write before marking it as
  184. "bad". And yes, it sometimes works : I've managed to read some bad disks with
  185. this.
  186.  
  187. By default, 10 attempts are made, it should be enough, but you should play with
  188. it. And don't forget that if you have a bad sector/track the 1st time you read
  189. a disk, you should retry with the "slow-mode" option and/or more attempts to
  190. get the most "good" sectors out of your disk.
  191.  
  192. 6) What do the colors in the progress bar mean ?
  193. ------------------------------------------------
  194.  
  195. - "Light Green" means "read ok"
  196. - "Green" means "write ok"
  197. - "Blue" means "format ok"
  198. - "Red" means "bad read/format/write"
  199.  
  200. And yes, I'm aware that there are few cosmetic bugs in the progress bar.
  201.  
  202. 7) Running wfdcopy under Windows NT/Windows 2000/XP
  203. ---------------------------------------------------
  204.  
  205. You'd better use wfdcopy under Windows 9x since floppy access is faster (and
  206. maybe more reliable ?) than under Windows NT/2000/XP. But don't worry, it
  207. works smoothly under Windows NT/2000/XP.
  208.  
  209. Under NT/2000/XP formatting 720k and 1.44M disks works but it's NOT WORKING for
  210. non-standard disks with more than 9 sectors/track (double-density) or 18
  211. sectors/track (high density), and it may not work for disk with more than 80
  212. tracks.
  213.  
  214. Error handling is still quite crude so there might be some problems with this
  215. too.
  216.  
  217. 8a) COMPILING
  218. ------------
  219.  
  220. I've used MingW32 (gcc 2.95.3) to compile wfdcopy, find it at 
  221. http://www.mingw.org, http://www.xraylith.wisc.edu/~khan/software/gnu-win32,
  222. and you can use CygWin too, http://sources.redhat.com/cygwin/ (since it can
  223. compile Mingw32 projects), but CygWin support is rather untested.
  224.  
  225. MingW32 is the only development environment that I support.
  226.  
  227. Oh, by the way, I use VIM (http://www.vim.org) as an editor.
  228.  
  229. 8b) UNSUPPORTED COMPILERS
  230. -------------------------
  231.  
  232. - You can also use LCC-Win32 from http://www.cs.virginia.edu/~lcc-win32 or
  233. http://ps.qss.cz/lcc but it doesn't seem to evolve much
  234. - You can also use Borland C++ 5.5 (freely available, check
  235. http://www.borland.com) but I don't recommend it at all
  236. - You can also use Watcom C++ (as found at http://www.openwatcom.org/) but I
  237. didn't test it yet and the Makefile for it isn't correct
  238. - You can also use Visual C++ if you're rich enough but it'll never ever be
  239. supported: we got FREE compilers so why bother for the worst and most
  240. expensive one ?
  241. - Any other compiler *may* work, but I just don't know them.
  242.  
  243.