home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Disk&HD / DISKEXPANDER1_2.DMS / in.adf / xpk / ts133.lzh / TrackSalve.doc < prev    next >
Encoding:
Text File  |  1990-12-14  |  12.7 KB  |  244 lines
  1.  
  2.                              TRACKSALVE
  3.  
  4.     TrackSalve is made to improve the Trackdisk device.  TD has some
  5.     problems and lacks some options.  As far as I know there are three bugs,
  6.     from which one is very bad if more than one drive is connected.
  7.     SetPatch 1.3.2 tries to do something about it, but it is not enough.
  8.     There are people who do not like the sound of an empty drive.  Trackdisk
  9.     cannot handle a track with an error on it.  Then all data on that track
  10.     is lost.  We never know whether the just written data is well stored on
  11.     disk.  Some programs do not switch off the motor.  And yet we are poking
  12.     in Trackdisk, we can just as well make a drive optional readonly.
  13.  
  14.  
  15.                              FUNCTIONS
  16.  
  17.     As already stated, TrackSalve can perform six functions:
  18.  
  19.  1. Standard modification of Trackdisk existing of:  Bugs patched.  The
  20.     patch of the bugs (as far as I know them).  See for a list of patched
  21.     bugs near the end of this file.  Among others there was a bug the NoDisk
  22.     routine (oef!).  Now it is save to do I/O on one drive and let all your
  23.     other drives empty.  Write to protected disk returns an error, and
  24.     leaves the unit undisturbed.  Prewrite mfm update.  Before a track is
  25.     written back to disk, all timing bits are validated again.  This is to
  26.     prevent the declining of never updated sectors on much used tracks.  New
  27.     coding routines.  Now it is possible to use fast memory to do I/O.  This
  28.     has no obvious function now, but imagine the effects when adopted by
  29.     Commodore and the Filesystem with AddBuffers.
  30.  
  31.  2. Noclick.  Can be switched on and off for each drive apart.  I think the
  32.     situation is as follows:  Some drives have an electrical switch at the
  33.     home position to prevent stepping below zero.  Other types have a
  34.     mechanical stop.  These you cannot get completely silent.  I think it
  35.     is save to use noclick on the first.  For those with a mechanical stop
  36.     I would not switch noclick on.
  37.     Because the drives with noclick on do not step, disk presence check is
  38.     done every .5 instead of 2.5 seconds.  So they will react sooner upon
  39.     disk insertion.
  40.  
  41.  3. Readonly simulation.  Each drive can act as if the tab of the inserted
  42.     disk is open.  This is not as simple as it sounds.  The FileSystem
  43.     (DOS) keeps track of disk swapping.  And it assumes that you are not
  44.     able to shift the tab while a disk is in the drive.  Therefore IF there
  45.     is a disk in the drive AND its tab is closed (write-enabled), and the
  46.     drive is switched over to read-only or read/write, a DiskChange is sent
  47.     out.  This is very unfriendly during a write, so this is delayed until
  48.     the motor is switched off.  Nevertheless, switch a drive from r/w to ro
  49.     or back only when it is quiet.
  50.  
  51.  4. TrackSalvage.  If Trackdisk gives up on a track, this function (if
  52.     enabled) comes to action.  The track is read again and analyzed.  All
  53.     unsuspicious data is recovered and stored in Trackdisk's buffers.  If
  54.     the requested data is recovered, no error is passed to the calling
  55.     task.  But an attempt to write to this track is denied and results into
  56.     a diskerror.  So faulting tracks are readonly.
  57.  
  58.  5. Verify.  TrackSalve can read back a just written track to check whether
  59.     the data well arrived on disk.  It reads the track into a special
  60.     buffer which is compared with the original write buffer.  Since the
  61.     Amiga is multitasking, it is not possible to know which task should be
  62.     notified about an error.  Therefore it is the user who must decide
  63.     about this.  He can choose between rewrite and ignore.  Rewrite writes
  64.     the original buffer again to disk, and ignore as if we never knew about
  65.     the bad track.  It may be that subsequent rewrites does not lead to a
  66.     good result.  At least the fact is known that something is wrong.  It
  67.     is possible to read-retry by repeating the command:  v read only once,
  68.     vv twice and vvv triple, subsequent v's are ignored.  Multiple reads
  69.     for verify may be useful for usage with very bad drives.
  70.  
  71.  6. Auto update.  The write to disk is delayed until the trackbuffer is
  72.     needed for another track or until an update command is received.  The
  73.     motor also keeps running until a motor off command is received.
  74.     TrackSalve can both do by itself if this function is enabled.  It is
  75.     delayed for about five seconds, that is, the track is updated five
  76.     seconds after the last write command.  The motor is switched off five
  77.     seconds after the last disk access.  Especially Sectorama (which was
  78.     intended for harddisks) will be helped with this function.  But there
  79.     are more. (Diskcopy:  try to diskcopy to a write protected disk).
  80.  
  81.  
  82.                                 COMMANDLINE
  83.  
  84.     If anywhere on the command line one of the chars h, H, or ? are found,
  85.     the whole command line is ignored and nothing is done but a small usage
  86.     explanation is printed:
  87.  
  88.     Syntax: TrackSalve  {[!]<unit>|a {<unit>} {<Command>}}
  89.     Function: Modify a Trackdisk device unit addressed by its unit number
  90.      <no args>         Show present status
  91.     Units:
  92.      0-3   Unit(s)     Succeeding commands are applied to listed units
  93.       a    All         Succeeding commands are applied to all TD units
  94.       !    Warning     Suppress error if the following unit does not exist
  95.     Commands:
  96.     <none> TD in RAM   No special functions (.=default), improved reliability
  97.       o    Original    Let TD execute in its original ROM code
  98.       s    SectorDisk  Let Trackdisk only give errors from bad sectors
  99.       t   .TrackDisk   Normal: Let TD give errors from bad tracks
  100.       n    NoClick     Perform noclick on the unit(s)
  101.       c   .Click       Normal: No noclick
  102.       r    ReadOnly    Make unit read-only, simulate open disk-tab
  103.       w   .WriteEnable Normal: Unit is read/write according to disk-tab
  104.       v    Verify      Read written track back and compare (vv, vvv)
  105.       b   .Believe     Normal: Assume track is written well
  106.       u    Update      Flush track and stop motor after 5 sec idling
  107.       e   .ExtUpdate   Normal: External update and motor off
  108.       /    Separator   E.g. "0/2n"  Units 0 and 2 in RAM, noclick only on 2
  109.      h ?   Explain     If given (anywhere), no commands are executed
  110.  
  111.     Comma's, spaces and dashes are completely ignored.  Characters which are
  112.     not defined lead to an abortion of the program without executing any
  113.     function.  This will be emphasized by a message via standard out.
  114.     Abortion always has a return value of 20.
  115.  
  116.     Units
  117.  
  118.     You must address an unit by its number instead of its DOS-name.  This
  119.     is because we are modifying an Exec-device and not a DOS-device.  This
  120.     device has nothing to do with DOS.  DOS uses it, and builds a system
  121.     around it.  The name of this system is for example "DF0:". Valid
  122.     numbers are 0, 1, 2, 3, a and A or any combination of them. 'A' means
  123.     all units.  Commands are single characters.  Before you give a command
  124.     you must specify one or more units to apply the command to.  A command
  125.     will be passed to all directly preceding listed units.  If a unit is
  126.     given that does not exist, then this is an error and nothing will be
  127.     done at all.  It can come handy if it is possible to give a unit that
  128.     does not exist.  Normal would be aborted with return code 20.  But if
  129.     a '!' is put before a possible non-existing unit, a message is printed
  130.     and the program continues normally, but returns 5.
  131.  
  132.     Commands
  133.  
  134.     Just a list of units and no commands results in the execution of
  135.     Trackdisk in RAM with repaired bugs. "TrackSalve a" or "TrackSalve
  136.     023". Commands are applied only to preceding units.  F.e. TrackSalve
  137.     01n lets units 0 and 1 stop clicking.  Now you can add new unit numbers
  138.     like:  TrackSalve 01n2r1s.  This results into noclick on units 0 and 1,
  139.     unit is 2 readonly and unit can salve tracks.  It is also possible to
  140.     give contradictory commands:  TrackSalve an1c lets all units except 1
  141.     noclicking.  The separator '/' is a do nothing command or "unit list
  142.     reset". TrackSalve 012/2n lets the units 0, 1 and 2 execute in ram, but
  143.     noclick is only performed by unit 2. Reset to a defined state can be
  144.     done by TrackSalve ao followed by the new state.  TrackSalve without
  145.     any parameters prints the present situation and changes nothing.
  146.  
  147.  
  148.                               HOW TO USE IT
  149.  
  150.     Although Disksalv works well without, both programs work very well
  151.     together.  Disksalv with TrackSalve will generally operate faster and
  152.     more clearly.  It also is possible (not yet happened) that the
  153.     combination can salve more data.  Sometimes only one file is the effort
  154.     of salvage worthy, like the latest modification not yet on a backup.
  155.     Now there is a chance that the file can be saved with copy.  Might save
  156.     some time.  Then it is possible that immediately after disk insertion a
  157.     requester appears with "unreadable" and "diskdoctor" or so.  There is a
  158.     fair chance that with TrackSalve these requesters stay away and the
  159.     disk will be accepted as a DOS disk.  You can do more in that case.
  160.  
  161.  
  162.                              IMPLEMENTATION
  163.  
  164.     The Trackdisk code will be copied from the operating system program and
  165.     modified and extended.  For each unit apart, the unit task can execute
  166.     this code or stay with the original in ROM.  If a unit cannot be brought
  167.     to execute the patched code, this is told in a message on standard out
  168.     and the program will continue normally but its return value will be 10.
  169.     There are two functions which use a buffer of about 26k.  If not
  170.     available at the moment of enabling, every .5 second this is tried to
  171.     allocate again.  Until the allocation is successful, the function
  172.     becomes not active.  This is reported through a message and the return
  173.     value will be 10. Execute TrackSalve without parameters to be sure the
  174.     function became active.  This buffer is shared among all tasks.
  175.     Normally this will work smoothly and without delay except when a
  176.     requester is displayed.  The requester is used when a verify error has
  177.     been detected.  If for some reason it is not possible to pop up a
  178.     requester, TrackSalve will loop rewriting the track and blink the
  179.     drive's led until the conditions have changed.  These are:
  180.  
  181.     1. The disk is removed.
  182.     2. The track is found well on disk.
  183.     3. There is enough memory to display the requester.
  184.  
  185.  
  186.                               PERFORMANCE
  187.  
  188.     The mfm revalidation costs some time.  It is not an exact value, but it
  189.     will stay well under 2 percent.  The encoding routines and track
  190.     maintenance became much faster because these can now ignore the timing
  191.     bits.  Track verify takes a lot of time, but it is done very efficient
  192.     this close to the object.  I measured an average increase of 30 percent.
  193.     To get these results, I did a file level diskcopy of a 70 percent full
  194.     disk to a duplicate.
  195.  
  196.  
  197.                               PATCHED BUGS
  198.  
  199.     Disk presence check routine.  Now a call to disk.resource GetUnit() is
  200.     done before accessing the hardware.
  201.  
  202.     In TD_RAWREAD and TD_RAWWRITE the size if the track was compared with
  203.     some value at location $8000 instead of $8000 itself.
  204.  
  205.     In TD_FORMAT, TD_RAWREAD and TD_RAWWRITE the tracknumber was compared
  206.     wrong sized, permitting a seek to track number zillion.
  207.  
  208.     A write to a protected disk was not rejected immediately.  The
  209.     trackbuffer was permitted to be modified.
  210.  
  211.     TD does not restore drives at its init.  So it will never know on which
  212.     track an initial empty drive is, and still a seek to track 6 is done.
  213.     TS restores empty drives upon entry, followed by the seek to track 6.
  214.  
  215.  
  216.                                 HISTORY
  217.  
  218.     Version 1.0 had a guru 3 type bug, but the faulting code was (almost)
  219.     never executed.  This version could be updated to 1.01 by a patch
  220.     program PatchTS.
  221.     Version 1.2 had multiple reads with verify implemented for users with
  222.     very bad drives.
  223.     Version 1.3 had mfm revalidation adopted from Pcopy, new coding and
  224.     decoding routines allowing fast buffers and auto update implemented.
  225.     Also a write to a write protected disk is denied.  Verify comparison
  226.     is now done by the blitter.  And a unit is more likely to be caught.
  227.     Version 1.31 removes two more trackdisk bugs.  Better !<unit> logic.
  228.     Version 1.33 checks every .5 sec for disk insertion with noclicking
  229.     drives.  Restores empty drives at entry.
  230.  
  231.  
  232.                                COPYRIGHT
  233.  
  234.     Copyright (c) 1990 D.W.Reisig.  This program may be distributed on
  235.     non-commercial base.  This program may not be distributed on commercial
  236.     base without my permission. You must include this file (TrackSalve.doc)
  237.     with the program (TrackSalve).  You may not change these files.  
  238.  
  239.  
  240.     D.W.Reisig
  241.     Woudweeren 10
  242.     1151 AV  Broek in Waterland
  243.     Holland
  244.