home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 12: Textmags & Docs / nf_archive_12.iso / TOOLS / WIN32 / STDISK.ZIP / stdisk / readme.txt next >
Text File  |  1999-03-11  |  11KB  |  237 lines
  1. --------------------------------------------------------------------------------
  2. STDISK diskimage writing utility v2.0b (b)- readme.txt
  3.  
  4. (c) 1999 8Hz Productions - http://www.8hz.com/stdisk
  5. --------------------------------------------------------------------------------
  6.  
  7.  
  8.  
  9. --------------------------------------------------------------------------------
  10. - General Information ----------------------------------------------------------
  11. --------------------------------------------------------------------------------
  12.  
  13. Because of the lack of any usable tools for making disks out of .st
  14. image files, we have decided to have a go at such a tool.
  15.  
  16. Makedisk (latest v1.4) does not work for us, it usually goes on about bad 
  17. sectors/tracks and after pressing 'i' (ignore) a couple of billion times
  18. it finishes after about 25 minutes. More than 1/2 the disks we've tried to 
  19. make did not work on my ST, STe or Mega ST4. Other options, like using the 
  20. tools fdformat and then dcopy work better, but give too much trouble. 
  21. I've tried the linux /dev/fd0xxxx devices to format floppies and copy/cat/dd 
  22. the images directly to them. Seems not to work too reliably and is a lot 
  23. of work also. 
  24.  
  25. So, there :) We have hacked an alternative and we love it! It looks 
  26. kind of great (anachronism though it is), it seems to work pretty 
  27. reliably for the less exotic formats and again, we love it! Our first
  28. attempt at a, kind of hardware oriented thingy. (Not counting the 'ol
  29. assembler vga stuff).
  30.  
  31. The executable runs under MS-DOS or in a win95/win98/(NT) MS-DOS box.
  32. It's a 16bit executable, so it should work on any Intel/Microsoft PC.
  33. (NOTE: This is an assumption, not a fact :) 
  34.  
  35. Our tool only makes DD floppies, but using HD floppies as such should work 
  36. (providing your ST will read them). It just takes a couple of minutes, including 
  37. formatting and writing/verifying, to make a disk. 
  38.  
  39. Oh yeah... We are /not/ responsible for giving your floppy drive (or any other 
  40. part of your system) an early 'fare thee well'... You might want to check the 
  41. extensive disclaimer at the bottom of this page.
  42.   
  43.  
  44. --------------------------------------------------------------------------------
  45. - Helpscreen looks as follows --------------------------------------------------
  46. --------------------------------------------------------------------------------
  47.  
  48.     STDISK diskimage writing utility v2.0b (b)
  49.      (c)1999 8Hz Productions  (http://www.8hz.com)
  50.  
  51.     Usage: stdisk <drive> <file> [h:# t:# s:#] [v]    (format/write)
  52.            stdisk <drive> h:# t:# s:#                 (format only)
  53.            stdisk <drive> <file> [h:# t:# s:#] w [v]  (write only)
  54.     Where:
  55.         'drive' Can be one of: a or b
  56.         'file'  Filename of image.
  57.         'h:#'   Where '#' is number of heads.   Default: 2.
  58.         't:#'   Where '#' is number of tracks.  Default: 80.
  59.         's:#'   Where '#' is number of sectors. Default: 9.
  60.         'w'     Write only.
  61.         'v'     Enable verifying writes.
  62.  
  63. This is about it. If you leave out the h/t/s parameters, then the tool will
  64. try to decide what disk parameters to use. If it cannot find an internal
  65. setting to match the image, it will ask you to specify settings and exit.
  66. Most general sizes are supported, though. 
  67.  
  68. (!) Please note, that the tool will determine the file format (either .ST or 
  69. .MSA) from the extention of the file. When reading MSA files, the h/t/s 
  70. parameters are ignored and the parameters provided in the MSA header are used.
  71.  
  72. The 'v' switch enables verifying writes. It reads back a written track and 
  73. compares it to the original. Verifying the tracks after formatting is
  74. enabled by default. Because this is a critical stage and writing on a
  75. nonformatted disk is bogus anyway ;)
  76.  
  77. Leaving out a filename will result in formatting the disk only and as an added
  78. feature the w flag will result in writing only.
  79.  
  80.  
  81. --------------------------------------------------------------------------------
  82. - Files in the archive ---------------------------------------------------------
  83. --------------------------------------------------------------------------------
  84.  
  85. - stdisk.exe  The program.
  86. - readme.txt  This here readme.
  87. - test.zip    A zipfile containing diskimages to test stdisk.
  88.  
  89.  
  90. --------------------------------------------------------------------------------
  91. - Testing stdisk  --------------------------------------------------------------
  92. --------------------------------------------------------------------------------
  93.  
  94. The 'test.zip' contains these images of valid formatted st disks :
  95.  
  96. - 360k.st       Single sided   9 sector  80 track disk  (standard ST format)
  97. - 720k.st       Double sided   9 sector  80 track disk  (standard ST format)
  98. - 720k.msa      same but in uncompressed MSA file format
  99. - 720k_com.msa  same but in compressed MSA fileformat
  100. - 729k.st       Double sided   9 sector  81 track disk
  101. - 738k.st       Double sided   9 sector  82 track disk
  102. - 800k.st       Double sided  10 sector  80 track disk
  103. - 810k.st       Double sided  10 sector  81 track disk
  104. - 820k.st       Double sided  10 sector  82 track disk
  105. - 880k.st       Double sided  11 sector  80 track disk
  106. - 891k.st       Double sided  11 sector  81 track disk
  107. - 902k.st       Double sided  11 sector  82 track disk
  108.  
  109. You can use these to test if you can create floppies that your Atari ST will 
  110. read. There are images to test if your drive will write 9/10/11 sectors per 
  111. track and images to test if your drive will write beyond the standard 80 tracks.
  112. (Actually the utility will do up to 12 sectors and up to 84 tracks).
  113.  
  114. They contain a file 'readme.txt', you can test if they work in your atari by 
  115. double clicking that file and 'show' it, it should read:
  116.  
  117.     WOW !,
  118.  
  119.     If you can read this on your ST,
  120.     you successfully wrote a diskimage !
  121.  
  122.     Have fun with stdisk !
  123.  
  124. If your drive writes all these images successfully you'll be able to write 
  125. just about every ST image out there...
  126.  
  127.  
  128.  
  129. --------------------------------------------------------------------------------
  130. - Future features --------------------------------------------------------------
  131. --------------------------------------------------------------------------------
  132.  
  133. - Disk to file.
  134. - With luck, better parameters for the floppydrives so 11 and 12 sectors give
  135.   less problems.
  136.  
  137.  
  138.  
  139. --------------------------------------------------------------------------------
  140. - Known Bugs -------------------------------------------------------------------
  141. --------------------------------------------------------------------------------
  142.  
  143. -This is a bit hairy... (It actually is not a bug.)
  144.  Some floppydrives are more flexible than others, so it can happen that one 
  145.  particular format will work and another will not. It's worse than that. 
  146.  Often it helps if you first format a couple of tracks of the disk with a 
  147.  standard format: ie. h:2 t:80 s:9 *which sould work on all drives*. It seems 
  148.  the floppy controller has calibrated the drive properly after this. Then
  149.  doing a nonstandard format works (usually).
  150.  
  151.  For the same reason 9 and 10 sectors/track work nearly all the time, 11 and
  152.  12 sectors/track is difficult, your mileage may vary.
  153.  
  154. -NOTE: 
  155.  This utility will not format (at this time anyway) nonstanderd disks that can
  156.  be read by MS-DOS. 
  157.  
  158. -Floppy drive light stays on sometimes (minor detail in the grand scheme of 
  159.  things).
  160.  
  161.  
  162. --------------------------------------------------------------------------------
  163. - Revision history -------------------------------------------------------------
  164. --------------------------------------------------------------------------------
  165.  
  166. v2.0b (b): Wed Mar 10 23:59:55 CET 1999
  167.    - Fixed compressed MSA format writing. It didn't seem to work.
  168.  
  169.  
  170. v2.0b (a): Mon Mar  8 22:59:21 CET 1999
  171.    - Added MSA file format support...
  172.  
  173.  
  174. v1.0b (c): Wed Mar  3 23:33:12 CET 1999
  175. - Fixed some minor bugs and other un-niceties. Notably:
  176.    - Added 'Format Only' and 'Write Only' options.
  177.    - Tweaked the DDPT parameters.
  178.    - Added more possible formats.
  179.    - Patched up this readme.
  180.    - What is this thing called 'life' you're always talkin'bout ?
  181.  
  182.  
  183. v1.0b (b): Mon Mar  1 02:47:15 CET 1999
  184. - Fixed number of bugs and other un-niceties. Notably:
  185.    - Fixed rogue output functions.
  186.    - Fixed semantics in format/verify loop. Prints sensible errors now (I hope).
  187.    - Fixed some string code.
  188.    - Added signal handler for 'SIGINT'. Resets system tables and resets drive 
  189.      before exit. Now does the same on most fatal errors.
  190.    - Added another useless field in the output.
  191.    - Cleaned up code a bit.
  192.    - Written this here readme.
  193.    - Lost a substantial piece of my life (again). Personal note: 'Stop hacking, 
  194.      start living'. Well, whatever...
  195.  
  196.  
  197. v1.0b (a): Sun Feb 28 12:17:32 CET 1999 
  198.    - STDISK has first seen the day of light...
  199.    - Cost us about a weekend of our lives.
  200.  
  201.  
  202.  
  203. --------------------------------------------------------------------------------
  204. - Disclaimer -------------------------------------------------------------------
  205. --------------------------------------------------------------------------------
  206.  
  207.        You can distribute this utility to all your friends, but 
  208.        please note the following:
  209.        THE PROGRAM MAY NOT BE ALTERED IN ANY WAY AND ALL
  210.        ACCOMPANYING DOCUMENTS HAVE TO BE INCLUDED. 
  211.        NO PART OF THIS PRODUCT MAY BE COMMERCIALLY REDISTRIBUTED
  212.        IN ANY WAY WITHOUT WRITTEN PERMISSION FROM THE COPYRIGHT
  213.        HOLDERS.
  214.  
  215.       -THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT 
  216.        PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN OTHERWISE
  217.        STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER
  218.        PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  219.        OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
  220.        BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF IT 
  221.        (THE PROGRAM) BEING MERCHANTABLE AND FIT FOR A PARTICULAR
  222.        PURPOSE. SHOULD THE PROGRAM PROVE DEFECTIVE, PLEASE 
  223.        CONTACT THE WRITERS. ANY GUARRANTEES DO NOT COVER 
  224.        ADDITIONS AND/OR CHANGES TO THE SOFTWARE. 
  225.      
  226.       -THE COPYING, INSTALLATION AND USE OF THE PROGRAM IS AT 
  227.        YOUR OWN RISK. IN NO EVENT WILL THE COPYRIGHT HOLDER BE
  228.        LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
  229.        SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  230.        OUT OF THE USE OR INABILITY TO USE THE PROGRAM 
  231.        (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING        
  232.        RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  233.        PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
  234.        OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY
  235.        HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  236.  
  237.