home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / assemblr / library / sampler0 / fmt.doc < prev    next >
Text File  |  1990-01-23  |  6KB  |  204 lines
  1. ************************************************************************
  2.  
  3. FMT version 1.00, Copyright (C) 1990 Clair Alan Hardesty
  4.  
  5.   Floppy disk formatter for AT compatible computers
  6.  
  7. Features:
  8.  
  9.   1: Format verification is an option, allowing fast formatting on
  10.       known good media.
  11.  
  12.   2: The system files may be copied, producing a bootable floppy
  13.  
  14.   3: The `insert disk' prompt may be bypassed, easing use in batch files
  15.  
  16.   4: All program output is to STDOUT, allowing redirection
  17.  
  18.   5: Extensively commented source code included
  19.  
  20.   6: The boot sector data is coded entirely in assembly language
  21.  
  22.   7: A plethora of error messages and exit codes provide detailed
  23.       program fault information
  24.  
  25.   8: Program progress display is informative without being verbose
  26.  
  27.   9: Small code size: less than 6 Kb
  28.  
  29.  10: The floppy boot sector contains the drive parameter table,
  30.       this should help in making nonstandard formats bootable,
  31.       (something for the next revision)
  32.  
  33.  11: A liberal source code license is available at resonable cost
  34.  
  35. ************************************************************************
  36.  
  37. The source code for FMT has been included for several major reasons:
  38.  
  39.   1: To provide the user with peace of mind, (you are encouraged to
  40.       examine the source and compile it yourself), as any program
  41.       that does low level disk I/O is a potential nemesis
  42.  
  43.   2: To share what I have learned from writing it with others
  44.  
  45.   3: To encourage others to do likewise
  46.  
  47.   4: To show off (not too boisterously, but I am proud of my work)
  48.  
  49. The source code is copyrighted, unlicensed users are not permitted to
  50.  use any portion of the source code in programs they distribute, they
  51.  are, however, permitted to use any part or all of the source code in
  52.  programs written and maintained for personal use.
  53.  
  54. Licensed users are permitted to use any portion of the source code in
  55.  any program written for distribution, commercial or otherwise,
  56.  including distribution of the source code, providing credit is given
  57.  where credit is due.
  58.  
  59. You are encouraged to distribute the original files, provided they
  60.  are unaltered and distributed as a set.  The files are:
  61.  
  62.   1: FMT.ASM
  63.   2: FMT.COM
  64.   3: FMT.DOC
  65.  
  66. If you use and enjoy this program, any contribution to encourage my
  67.  efforts would br greatly appriciated.
  68.  
  69.   If you send $10 or more, you will be receive:
  70.  
  71.     1: The latest version of the source code on your choice of media
  72.  
  73.         (3½" 720 Kb or 5¼" 1.2 Mb)
  74.  
  75.     2: A selection of other utilities I have written (with source code)
  76.  
  77.   If you send $25 or more, you will also receive:
  78.  
  79.     1: A signed and dated source code license
  80.  
  81.     2: The next major release (with source) when available
  82.  
  83.   Make check or money order payable to: Clair Hardesty
  84.  
  85.   Send to:
  86.  
  87.   Clair Alan Hardesty
  88.   10301 Johnson Av
  89.   Cupertino, CA 95014
  90.  
  91. I may be contacted at:
  92.  
  93.   (408) 446-0550 Voice,
  94.  
  95.   CompuServe 75350,16,
  96.  
  97.   or in writing at the above address
  98.  
  99. ************************************************************************
  100.  
  101.  command line syntax: fmt d: size [v] [s] [n]
  102.  
  103.   where: d = drive (A or B), size = floppy size in Kb,
  104.  
  105.    the optional v enables format verification,
  106.  
  107.    the optional s copies the system files,
  108.  
  109.    and the optional n bypasses the `insert floppy' prompt
  110.  
  111.   supported sizes are:
  112.  
  113.    360 for a 360 Kb floppy in a 360 Kb or 1.2 Mb drive
  114.    720 for a 720 Kb floppy in a 720 Kb or 1.44 Mb drive
  115.    1200 for a 1.2 Mb floppy in a 1.2 Mb drive
  116.    1440 for a 1.44 Mb floppy in a 1.44 Mb drive
  117.  
  118. ************************************************************************
  119.  
  120. Exit codes:
  121.  
  122.   0 = successful format
  123.   1 = failure during format, verify, or write
  124.   2 = disk size / drive type combination is not supported
  125.   3 = requested drive does not exist
  126.   4 = invalid or null command line
  127.   5 = system files not found or error writing system files
  128.   6 = computer is not AT compatible
  129.   7 = insufficient memory for file copy buffer (system transfer)
  130.  
  131. ************************************************************************
  132.  
  133. In order to use the system transfer option, the following files
  134.  
  135.   must be in the root directory of the default drive:
  136.  
  137.     1: IBMBIO.COM (should be a hidden file)
  138.  
  139.     2: IBMDOS.COM (should be a hidden file)
  140.  
  141.     3: COMMAND.COM
  142.  
  143. ************************************************************************
  144.  
  145. To ease use in batch files:
  146.  
  147.   1: use the no prompt option
  148.   2: redirect output to the NUL file
  149.   3: test the exit code
  150.  
  151.   example:
  152.  
  153.     fmt b: 360 n > nul
  154.     if errorlevel 1 goto failure
  155.     echo Format succeeded
  156.     goto success
  157.     :failure
  158.     echo Format failed
  159.     :success
  160.  
  161. ************************************************************************
  162.  
  163. To compile with Borland Turbo Assembler version 1.0 or greater:
  164.  
  165.     tasm /t fmt
  166.  
  167.     tlink /t /x fmt
  168.  
  169.       or
  170.  
  171.     tasm /t /zi fmt
  172.  
  173.     tlink /v /x fmt
  174.  
  175.     tdstrip -c -s fmt
  176.  
  177.       for use with Turbo Debugger
  178.  
  179. ************************************************************************
  180.  
  181. To compile with Microsoft Macro Assembler version 5.1 or greater:
  182.  
  183.     masm /t fmt;
  184.  
  185.     link fmt;
  186.  
  187.     exe2bin fmt fmt.com
  188.  
  189.     del fmt.exe
  190.  
  191. ************************************************************************
  192.  
  193.   Microsoft(R) is a registered trademark of Microsoft Corporation
  194.  
  195.   IBM(R) and PS/2 are registered trademarks of International
  196.  
  197.    Business Machines Corporation
  198.  
  199.   Turbo Assembler(R) and Turbo Debugger(R) are registered trademarks
  200.  
  201.    of Borland International
  202.  
  203. ************************************************************************
  204.