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