home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / rawrit20.zip / readme.txt < prev   
Text File  |  2000-06-10  |  4KB  |  100 lines
  1. RAWRITE for OS/2, DOS and Windows NT
  2. ====================================
  3.  
  4. Overview
  5. --------
  6.  
  7. RAWRITE is available in two versions; both are provided in this release. 
  8.  
  9. There is a pure 32-bit version, which runs only on OS/2 version 2.0 and
  10. above; this is the smaller, more functional version.
  11.  
  12. There is also a 16-bit dual mode version, that will run on any version
  13. of OS/2, and will also run on any version of DOS as long as it is
  14. version 3.2 or later.  Additionally, it will run in a command window on
  15. Windows NT.  Unless otherwise noted, everything herein applies to both
  16. versions. Naturally, it may be useful to rename the 16-bit version to
  17. RAWRITE.EXE before use.
  18.  
  19. RAWRITE copies a diskette image file to a diskette.  The image file can
  20. be the same size as a diskette, or smaller.  If the image is smaller,
  21. the rest of the last used track is set to zeros, and the rest of the
  22. diskette is left untouched. 
  23.  
  24. The program works only with 3.5 inch diskettes; it is unlikely that
  25. functionality for 5.25 inch diskettes is required. It does, however,
  26. work with 720KB, 1.44MB and 2.88MB 3.5 inch diskettes.
  27.  
  28. RAWRITE attempts to discover the size of the output diskette
  29. dynamically.  First, it attempts a hardware media sense [only on the
  30. 32-bit version].  This seems to work on MCA systems, but not on some
  31. others (e.g., it doesn't work on a PC Server 325 (8639-PT0).  If the
  32. media sense fails [and always on the 16-bit version], the program uses
  33. the size of the image file as a clue, assuming the smallest diskette
  34. size that is sufficient to accept the whole of the image.  In case this
  35. guess is incorrect, or the media sense [if done] is inaccurate, a flag
  36. can be used to force a particular diskette size. 
  37.  
  38. Usage of the program differs from some other versions.  The program is
  39. driven entirely from the command line; no prompts are issued.  Partly,
  40. this is because it is in the UNIX 'tradition', and partly because it is
  41. easier to specify options. 
  42.  
  43. Version summary
  44. ---------------
  45.  
  46. 32-bit        - Runs on OS/2 2.x and above only
  47.         - Can detect diskette drive type on some hardware
  48.         - Smaller executable file; more efficient
  49.  
  50. 16-bit        - Runs on any version of OS/2, and DOS, and Windows NT
  51.         - Cannot detect diskette drive types
  52.         - Larger executable file; less efficient
  53.  
  54. Using the program
  55. -----------------
  56.  
  57. Synopsis: rawrite [-dhe] imagefile drive
  58.  where:
  59.     -d           forces DD (720K) diskette type
  60.     -h           forces HD (1.44MB) diskette type
  61.     -e           forces ED (2.88MB) diskette type
  62.     imagefile    is the name of the file containing the diskette image
  63.     drive        is the drive to be written to
  64.  
  65. Examples:  rawrite boot.img a:
  66.            rawrite -e bigboot.img a:
  67.  
  68. If the program is invoked by name alone, or with the wrong number of
  69. parameters, a short help text is generated. 
  70.  
  71. Windows NT limitations
  72. ----------------------
  73.  
  74. When using the program on Windows NT, the target diskette must first be
  75. formatted with a file system understandable by Windows NT; this is an NT
  76. imposed limitation.  However, the image written to the diskette may be
  77. of any format at all. 
  78.  
  79. Package contents
  80. ----------------
  81.  
  82. README.TXT    this file
  83. RAWRITE.EXE    32-bit OS/2 executable
  84. RAWRITEB.EXE    16-bit dual mode executable
  85.  
  86. Versions
  87. --------
  88. 1.0    - Initial version.
  89. 1.1    - Improved some error messages.
  90.     - Now checks that output is really a diskette.
  91. 1.2    - Fixed media sense broken by version 1.1.
  92.     - Added author contact information to help text.
  93. 2.0    - 16-bit dual mode, and compatible 32-bit single mode, versions.
  94.  
  95. Bob Eager
  96. rde@tavi.co.uk
  97. 10th June 2000
  98.  
  99.  
  100.