home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 440.lha / Formatter_v2.7 / Formatter.doc < prev    next >
Encoding:
Text File  |  1990-11-13  |  10.3 KB  |  214 lines
  1. ========================== Formatter 2.7 =============================
  2. ======================================================================
  3. A  floppy  disk formatting program, written by Olaf 'Olsen' Barthel of
  4. MXM.   Copyright,  © 1990 by MXM.  Shareware, all rights reserved.  No
  5. guarantee  of  any  kind is made that the program(s) described in this
  6. document are 100% reliable.  You use this material on your own risk.
  7.  
  8. ============================== Purpose ===============================
  9. ======================================================================
  10. The  standard  'format'  command surely does a brilliant job, since it
  11. gets  around  with  any device driver and partitions of any size.  But
  12. which  data media is formatted most oftenly?  Floppy disks (3½" format
  13. hardwired  to  the  Amiga  computer)  of  course.  'Formatter 2.7' was
  14. written  to fit the niche for fast(er) and user friendlier floppy disk
  15. formatting  programs.   It  also  shows  how to format file systems in
  16. general and how to get AmigaDOS to accept them.
  17.  
  18. =============================== Usage ================================
  19. ======================================================================
  20. 'Formatter  2.7'  can  be  called both from  Shell and Workbench. Note
  21. that arp.library is required to run the program (Yuck!).
  22.  
  23.          The following command line parameters are supported:
  24.  
  25. Drive..........    This can be any disk drive from DF0:  through DF3:  as
  26.         long  as it's really connected.  You will get an error
  27.         message  if  the  disk  drive  cannot  be found in the
  28.         current DOS mountlist.
  29.  
  30. NAME/K.........    The  name you wish the formatted disk to receive.  Any
  31.         name longer than 31 characters will be truncated.
  32.  
  33. FAST/S.........    No  secret  fast formatting tricks yet, this option is
  34.         similar to the 'QUICK' switch of the standard 'format'
  35.         command:   if enabled only the root block and the boot
  36.         block  of  the  disk  will  be rewritten (clearing all
  37.         relevant  data).   If  your  disks  have  already been
  38.         formatted clearing those blocks can save much time.
  39.  
  40. INSTALL/S......    If  you  want  to use the formatted disk as a bootable
  41.         AmigaDOS disk,'Formatter 2.7' will install  it just as
  42.         if you had used the AmigaDOS 'Install' command on it.
  43.  
  44. VERIFY/S.......    If   enabled,  each  write  access  to  disk  will  be
  45.         verified,  i.e.  the disk blocks being written will be
  46.         reread and compared with the source data.  Needless to
  47.         say,  verification  slows  down  the  disk  formatting
  48.         process  but  helps  to  tell  the good disks from the
  49.         corrupt ones.
  50.  
  51. AUTOSTART/S....    If enabled, any disk inserted into the specified drive
  52.         will be formatted automatically.  This saves some time
  53.         if  lots  of  disks have to be formatted one after the
  54.         other.
  55.  
  56. FFS/S..........    In  behalf of the new Kickstart release, the fast file
  57.         system  is  supported  as well.  The disk receives the
  58.         FFS IDs where the standard format program places them.
  59.  
  60. A  small  window  will pop up on the Workbench screen (right under the
  61. mouse  pointer  if  possible).   The window will look like this (well,
  62. roughly, I never claimed being a graphic artist, did I?):
  63.  
  64.       #X#Formatter2.6======================##|##
  65.       |..   ..   ..   ..   ..   ..   ..   ..   | <- Track numbers
  66.       ||    |    |    |    |    |    |    |    |
  67.       |----------------------------------------|
  68.       |                                        | <- Process indicator
  69.       |------------+--+-------------+----------|
  70.       | Auto start |  | Fast format |          | <- Some gadgets
  71.       |------------+  +-------------+   Start  |
  72.       |Verify write|  |Install disk |          | <- Some more gadgets
  73.       |--------+-+-+------+-+-------++ +-------|
  74.       |  DF0:  | |  DF1:  | |  DF2:  | |  DF3: | <- Drive selection
  75.       |--------+ +--------+ +--------+ +-------|
  76.       |         +------------------------------|
  77.       | Name:   | Blank                        | <- Name string gadget
  78.       |         +------------------------------|
  79.       +----------------------------------------+
  80.  
  81. Control  should  be  intuitively  (why  shouldn't  it,  you're running
  82. Intuition  anyway, aren't you?), if you've understood the command line
  83. options  (to  which  the gadgets somehow correspond to) you should get
  84. along with the rest of the program easily.
  85.  
  86. ========================= Keyboard shortcuts =========================
  87. ======================================================================
  88. To  make  life  easier,  each  gadget  in  the  control  window can be
  89. enabled/toggled  via  keyboard.  These shortcuts are supported through
  90. the Intuition menu attached to the 'Formatter 2.7' window.
  91.  
  92. About...         (-> ?)    Display a short program info.
  93. Auto start        (-> A)    Toggle auto-start option
  94. Fast format        (-> F)    Toggle fast formatting
  95. Verify write        (-> V)    Toggle write verification
  96. Install disk        (-> I)    Toggle disk installation
  97. Use FFS            (-> U)    Toggle FastFileSystem support
  98.  
  99. Drive DFx:        (1..4)    Select a disk drive to be formatted
  100. Modify stepdelay    (-> M)    Modify the drive step delay rates
  101. Start formatting    (-> S)    This should speak for itself
  102. Quit            (-> Q)    Close the window and leave the program
  103.  
  104. ====================== Formatter 2.7 vs. format ======================
  105. ======================================================================
  106. 'Formatter  2.7' is  limited to the 3½" drives  hardwired to the Amiga
  107. computer, no other filesystems will be formatted (I haven't tried yet,
  108. but  I  suppose that 5¼" drives won't be formatted either).  The disks
  109. will  be  formatted  using  either the old standard file system or the
  110. FastFileSystem.
  111.     Formatting  time  is  well  below  the  time  'format'  needs;
  112. formatting  a  disk without verify takes between 47 and 50 seconds, if
  113. verify  is enabled formatting will take between 1:34 and 1:40 minutes.
  114.     You  are  daring  and  adventurous?  Why not try to modify the
  115. step  delay  rate  of your disk drives?  A little change can provide a
  116. welcome  speedup.  The step delay rate usually is about 3000 ms.  Most
  117. drives  will  feel  happy with about 2000 ms, some will even work with
  118. step  rates below 1800 ms.  'Formatter 2.7' will bring up a small menu
  119. allowing  you  to  adjust  the  step delay rate for all connected disk
  120. drives.  These settings may be saved to/restored from disk.
  121.     Caution:   You  are  doing quite dangerous things in modifying
  122. the default values!
  123.  
  124. ============================== Credits ===============================
  125. ======================================================================
  126. Credits  go  to  Mark Rinfret for the very, very basic disk formatting
  127. routines  employed  by his harddisk backup program.  It took some time
  128. to  spy out the default disk format information.  The block types were
  129. picked  up  both  from  Ralph Babel's 'Amiga Guru' book and the Bantam
  130. AmigaDOS Programmers' manual.
  131.  
  132. =============================== Author ===============================
  133. ======================================================================
  134. This  program was written by Olaf Barthel of MXM.  All files have been
  135. placed in the public domain.  You may freely distribute this material,
  136. even  a  small  copy  fee  is  okay  but  everything  which looks like
  137. commercial distribution is forbidden.  Still you may use this material
  138. for software development without giving credit to the original author.
  139.  
  140. The  program  and the accompanying files are distributed as Shareware.
  141. If  you  like  'Formatter 2.7'  and use it frequently, please send at
  142. least  7  US$  or  DM 15,- to cover our media costs.  If you enclose a
  143. self  adressed  (and  stamped)  envelope (note:  Germany only, for all
  144. other  countries  enclose  postage  separately)  you  will receive new
  145. material and updates from MXM.
  146.  
  147. Send   new   program  revisions,  comments,  bug  reports,  donations,
  148. unmarried   sisters,   non-poisoned   candy,  home-grown  palm  trees,
  149. horoscopes, promising capital investments, etc.  to:
  150.  
  151.                           Olaf Barthel, MXM
  152.                           Brabeckstrasse 35
  153.                           D-3000 Hannover 71
  154.  
  155.                      Federal Republic of Germany
  156.  
  157. ============ Revision history (most recent change first) =============
  158. ======================================================================
  159. V2.7    The  name  of  the  disk inserted is displayed if autostart is
  160.     enabled.   The  program  will  wait three seconds in which the
  161.     'Stop'-button can be pressed to cancel the formatting process.
  162.  
  163. V2.6    The  data  verification  is  handled by the blitter.  Added an
  164.     option  to  modify  the  step delay rate of all connected disk
  165.     drives.
  166.  
  167. V2.5    This  version  will  also  format the sector label information
  168.     available  for each disk track.  The additional 352 bytes will
  169.     be  set to zero.  Window height and gadgets will be adapted to
  170.     reflect the current system font settings.  Unfortunately, this
  171.     does not affect the string gadget border.
  172.  
  173. V2.4a    Very  much  the same as Formatter 2.4, different only in parts
  174.     of  the  user  interface.   The  older  release did not handle
  175.     menus/gadgets correctly.
  176.  
  177. V2.4    The  bootblock  installation  process  obviously never worked,
  178.     this  has  been  fixed.   Funny  enough,  if  several disk I/O
  179.     requests   were   queued,  the  root  track  was  not  written
  180.     correctly.  This occured particularly often on Turbo-Amigas or
  181.     A3000  computers.   Holger  Lubitz  suggested  that  the disks
  182.     should  be  validated  after  the  formatting process.  If two
  183.     Formatters  were  run simultaneously, the disk validator could
  184.     accidentally  modify the contents of the rootblock.  All known
  185.     other errors have been fixed.
  186.  
  187. V2.3    The disk formatting and verification process have been sped up
  188.     greatly.  The  disk  root  block  is written during formatting
  189.     rather than after it.  The data on disk will be verified after
  190.     the  disk  has been formatted and will start at track 79 going
  191.     down to track 0.
  192.  
  193.     There   is   a  debug  switch  available  from  Shell.   If  a
  194.     verification  error occurs, both track buffers will be written
  195.     to RAM:.
  196.  
  197. V2.2    Added  a  menu  and  FastFileSystem  support.   Applied  small
  198.     changes to the code to make the program work smoother.
  199.  
  200. V2.1    Removed  a  bunch of suspicious code passages which caused the
  201.     various  gadgets  to  get  mixed  up  by the message broadcast
  202.     system.
  203.  
  204. V2.0    A complete rewrite  of  the  original  program,  first  public
  205.     release.
  206.  
  207. V1.0    A very limited disk formatting program.
  208.  
  209.                                   *
  210.  
  211.              Do only its possibilities make it an Amiga?
  212.  
  213.                         WHERE IS THE MAGIC ???
  214.