home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / diskutil / dlii024.arc / DLII_024.DOC next >
Encoding:
Text File  |  1988-09-14  |  11.5 KB  |  266 lines
  1.  
  2.             VERY PRELIMINARY MANUAL FOR BETA-TEST VERSIONS OF DL II
  3.                    (c) 1987 Simon Poole ALL RIGHTS RESERVED
  4.  
  5.                                DL II User's Guide
  6.  
  7.      I. Introduction
  8.  
  9.      DL II is a checkdisk/unerase/diskedit program with following
  10.      functions:
  11.         -Disk usage display
  12.         -Check of FAT integrity
  13.         -Check for lost and crosslinked clusters
  14.         -Some disk fix functions
  15.         -Automatic and manual unerase
  16.         -File attribute change
  17.         -Disk editing, file or sector oriented
  18.         -Editing of harddisk bootsector
  19.      
  20.      DL II is completely GEM based and will run on any Atari-ST model in
  21.      medium or high resolution.
  22.  
  23.      I (Simon Poole) make no warranty of any kind in respect to this manual
  24.      and the software described in this manual. The user assumes all risk
  25.      as to the quality and performance of this product. In no event will I
  26.      be liable for direct, indirect, incidental or consequential damages
  27.      resulting from any defect in the performance and use of this product.
  28.  
  29.                                 GETTING STARTED
  30.  
  31.      II.1 Running DL II
  32.  
  33.      Copy the files DLII.PRG and DLII.RSC to a undamaged disk or harddisk
  34.      partition. DL II trys to uses the a filename mask of the form
  35.      DLII*.RSC to search for the resource file, so it will load the first
  36.      file fitting this specification in the search path.
  37.  
  38.      To run DL II double click on DLII.PRG, if you don't want an automatic
  39.      diskcheck performed after most operations, deselect Autocheck in the
  40.      Options menu (the default value is not to perform a diskcheck).
  41.  
  42.      II.2 Terminology
  43.  
  44.      A sector is the smallest entity on a disk from the view of the BIOS
  45.      (Basic Input Output System). On the ST a sector is normally 512 bytes
  46.      large. Sectors are numbered from zero (normally the so-called
  47.      bootsector) to the maximum amount of sectors on the device minus one.
  48.  
  49.      A cluster is the smallest unit of diskspace allocated for files on the
  50.      disk by GEMDOS. On the ST a cluster is normally two sectors.
  51.  
  52.      The FAT (File Allocation Table) keeps track of which clusters are
  53.      allocated to which file.
  54.  
  55.      II.3 Implementation Restrictions
  56.  
  57.      The current version of DL II will only handle a sector size of 512
  58.      bytes and a maximum cluster size of two sectors. Possibly future
  59.      versions will support a cluster size of 4 (MS-DOS harddisks).
  60.  
  61.      II.4 Command Overview
  62.  
  63.      The functions of DL II can be divided into three groups:  commands
  64.      which access the disk via the information in the device's bootsector;
  65.      commands which do not need a correct bootsector; and commands that
  66.      are not disk related. Do not try to use any of the functions which
  67.      use the bootsector information on a disk with a corrupted bootsector!
  68.  
  69.      Use bootsector:
  70.         Menu Disk:
  71.         View/Edit...          View and edit the disk on a sector by
  72.                               sector basis (see II.5 View/Edit dialog box).
  73.      Menu File:
  74.         Files...              Select files for a following operation
  75.                               (see II.6  Files dialog box).
  76.         Check...              Perform a diskcheck on the current device.
  77.  
  78.         These commands will also be preceded by a diskcheck, if Auto-
  79.         check is enabled in the Options menu.
  80.  
  81.      Don't use bootsector:
  82.         Menu Disk:
  83.         Change Disk...        Change the current device.
  84.         View/Edit Bootsector  View/Edit the bootsector of the current
  85.                               device.
  86.  
  87.         If the bootsector of the current device has been damaged, it
  88.         may be possible to fix it with the edit function.
  89.  
  90.      Non-disk commands:
  91.         Menu File:
  92.         Chain to ReOrg...     Terminate DL II and start ReOrg.PRG,
  93.                               please consult appendix A.
  94.         Quit                  Terminate DL II.
  95.  
  96.      II.5 The View/Edit dialog box
  97.  
  98.      This dialog box is used by:
  99.         Disk: View/Edit, View/Edit Bootsector
  100.         Files: View/Edit, Unerase
  101.      Depending on the actual function you are using, some or all of the
  102.      buttons will be disabled. The number in the top right hand corner
  103.      tells you which logical sector/cluster you are working on. The number
  104.      is always relative to sector zero of the current disk or the first
  105.      cluster of the file.
  106.  
  107.      To leave the View/Edit dialog press <Return> or select Exit. A point
  108.      to note is that in the ASCII display NUL and @ are mapped to space. If
  109.      you want to enter these to characters use the hexadecimal part of the
  110.      display.
  111.  
  112.      II.5.1 Horizontal slider
  113.  
  114.      The left and right arrows decrease/increase the current sector/cluster
  115.      number by one. A single click in the grey part of the slider bar will
  116.      decrease/increase the number by 10. The slider can also be dragged to
  117.      any position.
  118.  
  119.      To position the slider at an absolute position, double click the bar
  120.      and enter the sector/cluster number in the dialog box. All elements in
  121.      the horizontal slider autorepeat if the mouse-button is pressed for a
  122.      longer time.
  123.  
  124.      II.5.2  Vertical slider
  125.  
  126.      The vertical slider, bar and arrows work exactlly the same as in GEM
  127.      windows, with the execption that all elements autorepeat if the
  128.      mouse-button is pressed for a longer time.
  129.  
  130.      II.5.3 Search function
  131.  
  132.      A single click on the search button will call up a dialog box, where
  133.      you can enter the string you want to search for in normal ASCII form
  134.      (case sensitive!) or as a hexadecimal number. If a match is found, the
  135.      first character of the string is inverted for ten seconds, a keypress
  136.      or a mouse click returns you immediately. To continue from the current
  137.      postion double click the search button. If no match is found the last
  138.      partial match is displayed.
  139.  
  140.      II.5.4 Copy function
  141.  
  142.      To copy a sector/cluster to a different position in the disk/file
  143.      select Copy and enter the new position in the dialog box.
  144.  
  145.      II.5.5 Add function
  146.  
  147.      The Add button is only used by the file Unerase function. Please
  148.      consult the chapter on that.
  149.  
  150.      II.5.6 Editing
  151.  
  152.      To edit a sector/cluster: single click in the ASCII or hexadecimal
  153.      part of the dialog box. A cursor will appear which can be moved with
  154.      the cursor keys. Text or numbers entered will effect both parts of the
  155.      display immediatly. Press <Return> to exit from edit mode. If you
  156.      decide not to write to disk the contents of the internal buffer will
  157.      NOT be updated, so you can move to a different part of the
  158.      cluster/sector and carry on with editing. To reread the sector/cluster
  159.      from disk, double click in the ASCII or hexadecimal part of the
  160.      display.
  161.  
  162.      II.6 The File menu
  163.  
  164.      II.6.1 The Files dialog box
  165.  
  166.      This dialog form works much the same as the standard GEM fileselector.
  167.      Differences:  all parts of the vertical slider auto-repeat, only the
  168.      actual filename is selectable. To return from a subdirectory (folder)
  169.      to its parent directory, select the '..' entry.
  170.  
  171.      II.6.2 Chain to ReOrg
  172.  
  173.      If you are using DL II from the GEM-Desktop, this command will
  174.      immediately terminate DL II and start ReOrg.PRG (if ReOrg.PRG is in
  175.      the current desktop search path).
  176.  
  177.      II.6.3 Quit
  178.  
  179.      Terminate DL II immediately.
  180.  
  181.      II.7 The Disk menu
  182.  
  183.      II.7.1 Check
  184.  
  185.      Selecting the Check command will start a check of all the files and
  186.      directories on the current drive, things that are checked:
  187.         -lost clusters (clusters that are marked as used, but do not
  188.          belong to a file or directory)
  189.         -crosslinked clusters (clusters that are used by two different
  190.          files)
  191.         -bad directory entries (zero length files, first cluster out
  192.          of range)
  193.         -other catastropic errors in file allocation
  194.  
  195.      Once the check is finished a dialog form will show the results of the
  196.      operation. If DL II finds something wrong with the disk structure, it
  197.      will show that in this dialog. If DL II can fix the problem, the Fix
  198.      button will be enabled. To get a printout of the results, select the
  199.      Protocol button. You will notice that bad directory entries to not
  200.      cause the Fix button to be enabled, please use the Protocol option to
  201.      find out what is causing the trouble and delete the appropriate file
  202.      if necessary.
  203.      
  204.      The format of the Protocol file list is:
  205.         Filename Attribute Start-Cluster Filesize Error-Message
  206.  
  207.      The Fix command will truncate files to avoid crosslinked clusters and
  208.      generate files of the form 99999999.FIX (where 99999999 is a unique
  209.      number) in the root directory out of lost clusters. Since only unused
  210.      (and not deleted) entries are used, there is a limit to the number of
  211.      files that can be generated. If you have problems with this, you can
  212.      change deleted entries into unused entries by changing the first
  213.      letter of the filename from $E5 (σ) to $00, but be careful this also
  214.      marks the end of used entries in the directory!
  215.  
  216.      IMPORTANT:  DON'T USE THE FIX FUNCTION WITHOUT MAKING AN IMAGE BACKUP
  217.      OF THE DISK FIRST!
  218.  
  219.      II.8 The Options menu
  220.  
  221.      If Autocheck is enabled every time the current disk is changed or an
  222.      operation is performed which may change the disk, a diskcheck
  223.      operation is performed.
  224.  
  225.      Appendix A:  ReOrg, a disk reorganizer
  226.  
  227.      IMPORTANT:  REORG IS NOT A STANDALONE PROGRAM! YOU NEED AT LEAST
  228.      ANIMAGE BACKUP PROGRAM AND A DISKCHECK PROGRAM BEFORE YOU CAN USE IT!
  229.  
  230.      IMPORTANT:  ALWAYS, ALWAYS MAKE AN IMAGE BACKUP OF YOUR DISK BEFORE
  231.      RUNNING REORG ON IT!
  232.  
  233.      ReOrg improves disk performance on harddisk and floppys through better
  234.      placement of subdirectories and their files on disk and through
  235.      defragmentation of the files themselves. It will also remove deleted
  236.      and zero length entries.
  237.  
  238.      As the actual reorganizing is NOT an incremental process, during the
  239.      time from the start of the reorganization to the end of it your disk
  240.      is in an unusable condition (at least from the viewpoint of the
  241.      operating system). This means, that a power failure, computer
  242.      malfunction, disk error or program failure during the reorganization
  243.      will leave you with a corrupted disk!
  244.  
  245.      To run ReOrg, backup your disk, run the diskcheck program on it (DL II
  246.      will work ok) and ONLY run ReOrg after all crosslinked and lost
  247.      clusters have been disposed of! ReOrg has NO protection against
  248.      incorrect disks and will probably run into an infinite loop if you do
  249.      not take these precautions!
  250.  
  251.      After you have run ReOrg and reorganized your disk, the computer will
  252.      reboot. This is normal and serves the purpose of reinitilizing the TOS
  253.      internal directory tree.
  254.  
  255.      How ReOrg rebuilds your disk:
  256.         'Every (sub)directory is immediately followed by all the files
  257.         it owns, followed by all the subdirectories it is parent of.
  258.         Using the last sentence recursively, the place of every file on
  259.         the disk is determined now'
  260.         (from the Reformat manual by Jos Wennmacker)
  261.  
  262.      This also implies that after you have reorganized your disk, the
  263.      amount of clusters ReOrg reports it has to move after a bit of work on
  264.      the disk will be quite large. I would recommend not using ReOrg again
  265.      before the performance of your disk actually drops.
  266.