home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / dskutl / ddt150.arc / DDT.TXT < prev   
Text File  |  1988-08-08  |  33KB  |  864 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                DOS Drive Tool
  20.  
  21.                                 Users Guide
  22.  
  23.                                 Version 1.5
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.     Dan Heimsoth
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.    1       INTRODUCTION  ..............................................   1
  70.    2       REQUIREMENTS  ..............................................   1
  71.    3       COMMAND LINE PARAMETERS  ...................................   1
  72.    3.1       [Drive:][path][filename]  ................................   1
  73.    3.2       ASSUME /A  ...............................................   1
  74.    3.3       BIOS VIDEO /B  ...........................................   2
  75.    3.4       COLOR SET 2 /C  ..........................................   2
  76.    3.5       IGNORE ENHANCED KEYBOARD /K  .............................   2
  77.    3.6       QUIET /Q  ................................................   2
  78.    3.7       HELP /?  .................................................   2
  79.    4       EDIT MODES  ................................................   3
  80.    4.1       DIRECTORY EDIT  ..........................................   3
  81.    4.2       CLUSTER EDIT  ............................................   3
  82.    4.3       FAT EDIT  ................................................   3
  83.    5       MENU FUNCTIONS  ............................................   3
  84.    5.1       COMMON FUNCTIONS  ........................................   4
  85.    5.1.1       [ WRITE  ]  ............................................   4
  86.    5.1.2       [ CLEAR  ]  ............................................   4
  87.    5.1.3       [ Nw DRV ]  ............................................   4
  88.    5.1.4       [  EXIT  ]  ............................................   4
  89.    5.1.5       [  HELP  ]  ............................................   4
  90.    5.1.6       [ STATS  ]  ............................................   4
  91.    5.1.7       [ BootCl ]  ............................................   4
  92.    5.1.8       [ RootCl ]  ............................................   4
  93.    5.2       DIRECTORY EDIT FUNCTIONS  ................................   4
  94.    5.2.1       [ SEARCH ]  ............................................   4
  95.    5.2.2       [   FAT  ]  ............................................   5
  96.    5.2.3       [ CLUSTR ]  ............................................   5
  97.    5.2.4       [ SUBDIR ]  ............................................   5
  98.    5.2.5       [ PARENT ]  ............................................   5
  99.    5.2.6       [  ROOT  ]  ............................................   5
  100.    5.2.7       [  PREV  ]  ............................................   5
  101.    5.2.8       [  NEXT  ]  ............................................   5
  102.    5.2.9       [ S-TREE ]  ............................................   5
  103.    5.2.10      [ UNERAS ]  ............................................   5
  104.    5.2.11      [  SAVE  ]  ............................................   5
  105.    5.2.12      [   GET  ]  ............................................   6
  106.    5.2.13      [   PUT  ]  ............................................   6
  107.    5.3       CLUSTER EDIT FUNCTIONS  ..................................   6
  108.    5.3.1       [ SEARCH ]  ............................................   6
  109.    5.3.2       [   FAT  ]  ............................................   6
  110.    5.3.3       [ Hx/Chr ]  ............................................   6
  111.    5.3.4       [   DIR  ]  ............................................   6
  112.    5.3.5       [   -1   ]  ............................................   6
  113.    5.3.6       [   +1   ]  ............................................   6
  114.    5.3.7       [  PREV  ]  ............................................   6
  115.    5.3.8       [  NEXT  ]  ............................................   6
  116.    5.3.9       [  S-ALL ]  ............................................   6
  117.    5.3.10      [ 1st CL ]  ............................................   7
  118.    5.3.11      [ ASC/EB ]  ............................................   7
  119.    5.3.12      [  OWNER ]  ............................................   7
  120.  
  121.  
  122.  
  123.  
  124.                                        i
  125.  
  126.  
  127.  
  128.  
  129.  
  130.    5.4       FAT EDIT FUNCTIONS  ......................................   7
  131.    5.4.1       [ SEARCH ]  ............................................   7
  132.    5.4.2       [ CLUSTR ]  ............................................   7
  133.    5.4.3       [   DIR  ]  ............................................   7
  134.    5.4.4       [  PREV  ]  ............................................   7
  135.    5.4.5       [  NEXT  ]  ............................................   7
  136.    5.4.6       [  OWNER ]  ............................................   7
  137.    6       CUSTOMIZING DDT  ...........................................   7
  138.    6.1       DISPLAY ATTRIBUTES  ......................................   7
  139.    6.2       FUNCTION KEY ASSIGNMENTS  ................................   8
  140.    7       CHANGES  ...................................................   9
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.                                       ii
  187.  
  188.  
  189.    1.0     INTRODUCTION
  190.    DDT is a utility program for working with DOS-format drives.  It displays
  191.    the data found on the drive in the format in which DOS uses it.  It can
  192.    be used to view, search, and modify this data.
  193.  
  194.    The DDT program has been released in versions 0.2 through 1.43, with bugs
  195.    of varying severity found in each.  Although I would like to think that
  196.    version 1.5 is error free, I am certain that bugs will be found.  Even if
  197.    it were bug free, however, I would still be advising CAUTION in using it.
  198.    It is, by definition, a potentially dangerous program, since it gives the
  199.    user the power to change data that is usually better left unchanged.  For
  200.    example, by modifying the FAT, a file or even an entire disk can be made
  201.    unusable.  I strongly recommend the DOS Technical Reference Manual
  202.    chapter on DOS Disk Allocation as a prerequisite to using DDT.
  203.  
  204.  
  205.    2.0     REQUIREMENTS
  206.    This program requires PC-DOS 2.0 or higher.  It will support editing of
  207.    DOS standard format diskettes and disks.  It is not intended to support
  208.    non-DOS formats, or DOS file system extensions.  The program uses DOS
  209.    interrupts 25H and 26H, and will attempt to verify the INT.  25H
  210.    interface and the format of the target drive through DOS INT 21H.  Any
  211.    DOS file system extension or memory resident program which takes over INT
  212.    21H or INT 25H may interfere with this verification, causing an
  213.    "unsupported format" error message, and preventing editing of the target
  214.    drive.  This interference has been found in using DDT with DOS 3.1/3.2
  215.    when ASSIGN is installed.  DDT Version 1.3 requires approximately 94Kb of
  216.    free memory for the program, plus a data buffer which varies in size
  217.    depending on the drive being edited.  This buffer will not exceed 84Kb
  218.    for most hardfiles, or 20Kb for most diskettes.
  219.  
  220.  
  221.    3.0     COMMAND LINE PARAMETERS
  222.    All command line parameters are optional.  They can be entered in upper
  223.    or lower case.
  224.  
  225.    3.1     [Drive:][path][filename]
  226.    The DOS drive letter of the drive to be edited ( target drive ) can be
  227.    entered as a command line parameter.  This will bypass the first screen,
  228.    which prompts for drive letter.  A path and file name can also be entered
  229.    with the command line parameter, and if the file is found, the
  230.    subdirectory containing the file will be displayed in Directory Edit mode
  231.    as the first screen, with the cursor at the specified file.
  232.  
  233.    3.2     ASSUME /A
  234.    The /A parameter is used to ASSUME a set of format parameters for the
  235.    target drive.  This is useful in cases where the a Boot Record has been
  236.    damaged, causing the disk(ette) to appear to have an unusable format.
  237.    The /A parameter has two forms of use.
  238.  
  239.    For diskettes, predefined parameter sets are provided for most common
  240.    diskette formats.  To ASSUME one of these sets, use one of the /A forms
  241.    listed in the following table:
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.                                        1
  249.  
  250.  
  251.  
  252.         Predefined formats for the ASSUME parameter ( /A )
  253.  
  254.         /A160    single-sided, 8 sect./trk. ( 160 Kb 5.25" )
  255.         /A180    single-sided, 9 sect./trk. ( 180 Kb 5.25" )
  256.         /A320    double-sided, 8 sect./trk. ( 320 Kb 5.25" )
  257.         /A360    double-sided, 9 sect./trk. ( 360 Kb 5.25" )
  258.         /A720    double-sided, 9 sect./trk. ( 720 Kb 3.5" standard format )
  259.         /A720*   double-sided, 9 sect./trk. ( 720 Kb 3.5" alternate format )
  260.         /A1.2    double-sided, 15 sect./trk. ( 1.2 Mb 5.25" )
  261.         /A1.44   double-sided, 18 sect./trk. ( 1.44 Mb 3.5"  )
  262.  
  263.    For hardfiles and for diskette formats not listed in the table, the
  264.    second form of /A must be used.  This form requires 7 sub-parameters
  265.    separated by commas:
  266.  
  267.            /Ap1,p2,p3,p4,p5,p6,p7
  268.  
  269.            p1 =  Number of logical sectors
  270.            p2 =  Bytes per sector
  271.            p3 =  Number of reserved sectors
  272.            p4 =  Sectors per FAT
  273.            p5 =  Number of FATs
  274.            p6 =  Number of Root Directory entries
  275.            p7 =  Sectors per cluster
  276.  
  277.    For example, to start DDT with ASSUMED parameters for a 20 Mb hardfile,
  278.    as formatted by DOS 3.3, the command line would look like this:
  279.  
  280.        ...>DDT C: /A41735,512,1,41,2,512,4
  281.  
  282.    The values of the sub-parameters can vary with disk size/type, DOS
  283.    version, disk partitioning, and other factors.  For a given disk(ette),
  284.    these values can be obtained from the PARAMETERS display of DDT, but you
  285.    would have to get the values before they are actually needed, since you
  286.    can't start DDT without ASSUME values if the Boot Record is damaged.
  287.  
  288.    3.3     BIOS VIDEO /B
  289.    The /B parameter will cause video I/O to go through BIOS Int.  10, which
  290.    may be necessary for compatibility in some cases.  This will cause
  291.    performance to be much slower.
  292.  
  293.    3.4     COLOR SET 2 /C
  294.    The /C parameter will cause DDT to use an alternate display attribute
  295.    (color ) set.
  296.  
  297.    3.5     IGNORE ENHANCED KEYBOARD /K
  298.    The /K parameter will cause DDT to not use the Enhanced Keyboard, even if
  299.    the presence test passes.  This may be necessary if a TSR program causes
  300.    the presence test to pass when no enhanced keyboard is present.
  301.  
  302.    3.6     QUIET /Q
  303.    The /Q parameter will cause DDT to not use the speaker.  The speaker is
  304.    normally used to signal invalid keystrokes or errors.
  305.  
  306.    3.7     HELP /?
  307.    The /? parameter will cause DDT to display a screen of help information.
  308.  
  309.  
  310.                                        2
  311.  
  312.  
  313.    4.0     EDIT MODES
  314.    Three editing modes are available in DDT, Directory, Cluster, and FAT.
  315.    These modes allow editing of the respective areas of the disk, in a
  316.    format defined by DOS.  For more information on FATs, Clusters, and
  317.    Directories, see the DOS Technical Reference Manual.  Changes made while
  318.    editing are displayed in high intensity until they are written.  Cursor
  319.    movement is controlled by the [Home], [End], [PgUp], [PpDn], [TAB] and
  320.    [Ctrl] keys, and cursor pad arrows.
  321.  
  322.    4.1     DIRECTORY EDIT
  323.    Directory Edit mode allows editing of DOS directories and subdirectories.
  324.    The directory entry fields are displayed and edited in a decoded format
  325.    (i.e.  the time field is display in HRS:MIN:SEC format ).  The directory
  326.    entry field that is reserved for DOS is not displayed in Directory Edit
  327.    mode, but if necessary it can be accessed by editing the directory in
  328.    Cluster Edit mode.
  329.  
  330.    4.2     CLUSTER EDIT
  331.    Cluster Edit mode allows editing of Data Clusters.  The data can be
  332.    edited in Hex or Character form ( selected with [ Hx/Chr ]  ), and the
  333.    characters can be ASCII or EBCDIC ( selected with [ Asc/EB ] ).  The BOOT
  334.    Record and the ROOT Directory can also be edited in Cluster Edit mode, by
  335.    selecting [ BootCl ] or [ RootCl ].
  336.  
  337.    4.3     FAT EDIT
  338.    FAT ( File Allocation Table ) Edit mode allows editing of the FAT.  The
  339.    data is displayed in Hex, grouped by FAT pointer, which is either 12 or
  340.    16 bits, depending on the format of the drive.   Only one FAT is
  341.    displayed.   If multiple copies of the FAT exist ( 2 FAT copies are kept
  342.    on most DOS drives ), the [ FAT # ] function can be used to select which
  343.    copy of the FAT is to be edited, or to select "All FATs" for edit.  FAT
  344.    Edit mode will always start in the "All FATs" state.  In this state, all
  345.    FAT copies are written with the same data when the [ WRITE ] function is
  346.    used.  When a single FAT number is selected for edit, only the selected
  347.    copy of the FAT will be written when the [ WRITE ] function is used.
  348.  
  349.    If differences are found between the first and second FAT copies when DDT
  350.    is started or when "All FATs" editing is selected, a warning message is
  351.    displayed.  The differences of the second FAT will be displayed as
  352.    highlighted changes, over the first FAT data.  Executing a [ WRITE ] at
  353.    this point will write the second FAT data to all copies of the FAT.
  354.    Alternately, executing a [ CLEAR ] follwed by a [ WRITE ] will write the
  355.    first FAT data to all copies of the FAT.
  356.  
  357.  
  358.    5.0     MENU FUNCTIONS
  359.    Menus are displayed across the bottom of the screen, and offer up to 20
  360.    choices, corresponding to [F1] through [F10], and [Shift]+[F1] ( [SF1] )
  361.    through [SF10].  The [F11] and [F12] keys ( or [Ctrl] [<-] and [Ctrl]
  362.    [->] keys ) can be used to move the menu-cursor, and the last line on the
  363.    screen will display a message explaining the function of the item
  364.    selected.  Menu items can be executed by selecting with the menu-cursor
  365.    and then pressing [ENTER], or directly by pressing the "F" key
  366.    corresponding to the menu item.  The [Esc] key is used to exit to the
  367.    drive selection screen.
  368.  
  369.    The functions assigned to the keys can be customized for each of the
  370.    three edit modes, to suit personal taste.  The procedure for changing the
  371.  
  372.                                        3
  373.  
  374.  
  375.    function key assignments is described in the CUSTOMIZING section of this
  376.    Users Guide.
  377.  
  378.    5.1     COMMON FUNCTIONS
  379.    The functions listed in this section are available in all edit modes.
  380.    Other function key labels ( such as [ SEARCH ] ) will be the same in all
  381.    three modes, but will function differently in each mode, and therefore
  382.    will be listed under each edit mode section.
  383.  
  384.    5.1.1   [ WRITE  ]
  385.    This function writes the NEW data ( highlighted on the display ) to the
  386.    disk.  In FAT edit mode, the new data will be written to all copies of
  387.    the FAT.
  388.  
  389.    5.1.2   [ CLEAR  ]
  390.    This function clears all the NEW ( highlighted ) data from the display.
  391.    The display will then show the original data read from the disk.
  392.  
  393.    5.1.3   [ Nw DRV ]
  394.    This function will end the editing of the current drive, and return to
  395.    the drive-selection screen.  The [Esc] key will also perform this
  396.    function.
  397.  
  398.    5.1.4   [  EXIT  ]
  399.    This function will end DDT and return to DOS.
  400.  
  401.    5.1.5   [  HELP  ]
  402.    This function will display a short message explaining how to use DDT
  403.    menus and editing functions.
  404.  
  405.    5.1.6   [ STATS  ]
  406.    This function will display a set of statistics or parameters describing
  407.    the target drive.
  408.  
  409.    5.1.7   [ BootCl ]
  410.    This function will allow editing the BOOT record of the target drive.
  411.    The data will be displayed in Cluster Edit mode, but only the
  412.    single-sector Boot Record will be displayed.  This function is not
  413.    available in Directory Edit mode in the default version of DDT, but it
  414.    can be added to the function menu if desired ( see CUSTOMIZING DDT ).
  415.  
  416.    5.1.8   [ RootCl ]
  417.    This function will allow editing the ROOT Directory of the target drive
  418.    in Cluster Edit mode.  This may be needed to edit the Reserved field of
  419.    directory entries, which is not shown in Directory Edit mode.
  420.    Subdirectories can edited in Cluster Edit mode by selecting a
  421.    subdirectory entry in Directory Edit mode, and the switching to Cluster
  422.    Edit mode ( [ CLUSTR ] ).  This function is not available in Directory
  423.    Edit mode in the default version of DDT, but it can be added to the
  424.    function menu if desired ( see CUSTOMIZING DDT ).
  425.  
  426.  
  427.    5.2     DIRECTORY EDIT FUNCTIONS
  428.  
  429.    5.2.1   [ SEARCH ]
  430.    In Directory mode, the search covers only the FILENAME (.EXT) field.  The
  431.    search is case sensitive, even though lower-case file name are not legal
  432.    in DOS.  Partial names can be entered.  For example:  "DDT" will find any
  433.  
  434.                                        4
  435.  
  436.  
  437.    directory entry containing that 3 character string; ".BAT" will find any
  438.    directory entry with a ".BAT" extension.  The search will be forward
  439.    only, from the current entry.  If the current directory is a
  440.    subdirectory, the search will include all clusters forward in the chain.
  441.  
  442.    5.2.2   [   FAT  ]
  443.    This function will select FAT Edit mode.  The cursor will be positioned
  444.    at the FAT entry for the Start Cluster of the current directory entry.
  445.    If the current directory entry is unused, the cursor will be positioned
  446.    at the FAT entry for the first unused cluster on the disk.
  447.  
  448.    5.2.3   [ CLUSTR ]
  449.    This function will select Cluster Edit mode for the Start Cluster of the
  450.    current directory entry.  If the current directory entry is unused, the
  451.    first unused cluster on the disk will be displayed.
  452.  
  453.    5.2.4   [ SUBDIR ]
  454.    If the cursor is selecting a subdirectory entry, the first cluster of
  455.    that subdirectory will be displayed in Directory Edit mode.
  456.  
  457.    5.2.5   [ PARENT ]
  458.    If the current directory is not the Root Directory, the PARENT of the
  459.    current directory will be displayed in Directory Edit mode.
  460.  
  461.    5.2.6   [  ROOT  ]
  462.    This function will display the ROOT Directory in Directory Edit mode.
  463.  
  464.    5.2.7   [  PREV  ]
  465.    This function will display the previous cluster ( in the FAT chain ) of
  466.    the current subdirectory in Directory Edit mode.
  467.  
  468.    5.2.8   [  NEXT  ]
  469.    This function will display the next cluster ( in the FAT chain ) of the
  470.    current subdirectory in Directory Edit mode.
  471.  
  472.    5.2.9   [ S-TREE ]
  473.    This function will search the directory tree for a file name, starting
  474.    with the current entry of the current directory.  To search the complete
  475.    directory tree, use [  ROOT  ] to select the ROOT Directory, and then
  476.    start the tree search.  When a match is found, the matching file name is
  477.    displayed.  The tree search can then be repeated at that point to search
  478.    the rest of the tree for more matches.
  479.  
  480.    5.2.10  [ UNERAS ]
  481.    When a directory is displayed, erased files will have "+" as the first
  482.    character of the file name.  To try to un-erase a file, move the cursor
  483.    to the erased file name, and execute the [ UNERASe] function.  DDT will
  484.    then change the "+" character to a "?", and try to rebuild the FAT chain
  485.    for the file by using a "best guess" approach.  This consists of
  486.    beginning with the start cluster, and searching forward in the FAT to
  487.    find enough unused clusters to match the file size.  To complete the
  488.    unerase attempt, the new directory AND the new FAT must then be written
  489.    to disk by using the "WRITE" menu function in both DIR and FAT edit
  490.    modes.
  491.  
  492.    5.2.11  [  SAVE  ]
  493.    The save function will write the specified file to a drive other than the
  494.    one being edited.  The destination drive entered for the save file must
  495.  
  496.                                        5
  497.  
  498.  
  499.    not be the drive being edited.  A new file name can be entered, or the
  500.    current name will be used.  After executing the UNERASE function, this
  501.    function can be used instead of writing the modified Directory and FAT.
  502.    This lets you recover a file without writing to the drive being edited.
  503.  
  504.    5.2.12  [   GET  ]
  505.    This function will get the current entry of the current directory, and
  506.    place it in a save area.  This entry can then be written to a different
  507.    location by using the  [ PUT ] function.  The saved entry will be
  508.    displayed at the bottom of the Directory Edit window.  If a completely
  509.    blank, unused entry is saved ( GETed ? ), the saved entry will not be
  510.    displayed.
  511.  
  512.    5.2.13  [   PUT  ]
  513.    This function will PUT the saved entry at the current entry of the
  514.    current directory.  The [ WRITE ] function must then be used to write the
  515.    entry to the disk(ette).  If no entry is saved, a blank, unused entry
  516.    will be written.
  517.  
  518.    5.3     CLUSTER EDIT FUNCTIONS
  519.  
  520.    5.3.1   [ SEARCH ]
  521.    In Cluster mode, the search pattern can be entered in HEX or in
  522.    Characters, depending on which edit format is active when the search is
  523.    started.  The search is a forward search from the current cursor
  524.    position.  If an Entry NAME is shown on the top line of the Cluster Edit
  525.    display, then the search will include all the clusters in the FAT chain
  526.    for that entry.  Otherwise, only the current cluster is searched.  If
  527.    multiple clusters are searched, the search can be interrupted at any time
  528.    by pressing the [Esc] key.
  529.  
  530.    5.3.2   [   FAT  ]
  531.    This function will select FAT Edit mode.  The cursor will be positioned
  532.    at the FAT entry for the current cluster.
  533.  
  534.    5.3.3   [ Hx/Chr ]
  535.    This function will toggle the Edit Format between Hex and Character.
  536.  
  537.    5.3.4   [   DIR  ]
  538.    This function will select Directory Edit mode.
  539.  
  540.    5.3.5   [   -1   ]
  541.    This function will select the previous cluster ( cluster number - 1 ).
  542.  
  543.    5.3.6   [   +1   ]
  544.    This function will select the next cluster ( cluster number + 1 ).
  545.  
  546.    5.3.7   [  PREV  ]
  547.    This function will select the previous cluster in the FAT chain.  If the
  548.    current cluster is unused, the previous unused cluster is selected.
  549.  
  550.    5.3.8   [  NEXT  ]
  551.    This function will select the next cluster in the FAT chain.  If the
  552.    current cluster is unused, the next unused cluster is selected.
  553.  
  554.    5.3.9   [  S-ALL ]
  555.    This function will search all data clusters starting with the current
  556.    cluster.  To search all data clusters, use the [ 1st CL ] function to
  557.  
  558.                                        6
  559.  
  560.  
  561.    display the first data cluster, then start the global search.
  562.  
  563.    5.3.10  [ 1st CL ]
  564.    This function selects the first data cluster on the drive ( data cluster
  565.    number 2 ).
  566.  
  567.    5.3.11  [ ASC/EB ]
  568.    This function toggles the text window of the Cluster Edit display between
  569.    ASCII and EBCDIC characters.
  570.  
  571.    5.3.12  [  OWNER ]
  572.    This function is available in both FAT and Cluster Edit mode.  It will
  573.    search the directory tree for the owner of the FAT chain which contains
  574.    the current cluster.  If an owner is found, the mode is switched to
  575.    Directory Edit mode, with the cursor at the Owning file name.  If the
  576.    first owner found is an erased entry, the search is continued until a
  577.    non-erased owner is found, or until the entire tree is searched. If the
  578.    entire tree is searched and only an erased owner is found, the erased
  579.    entry will be displayed.
  580.  
  581.    5.4     FAT EDIT FUNCTIONS
  582.  
  583.    5.4.1   [ SEARCH ]
  584.    In FAT mode, the search pattern is a FAT pointer value, entered in hex.
  585.    The search is a forward search from the current cursor position.
  586.  
  587.    5.4.2   [ CLUSTR ]
  588.    This function will select Cluster Edit mode for the cluster of the
  589.    current FAT entry ( selected by the cursor ).
  590.  
  591.    5.4.3   [   DIR  ]
  592.    This function will select Directory Edit mode.
  593.  
  594.    5.4.4   [  PREV  ]
  595.    This function will move the cursor to the previous cluster in the FAT
  596.    chain.  If the current cluster is unused, the cursor is moved to the
  597.    previous unused cluster.
  598.  
  599.    5.4.5   [  NEXT  ]
  600.    This function will move the cursor to the next cluster in the FAT chain.
  601.    If the current cluster is unused, the cursor is moved to the next unused
  602.    cluster.
  603.  
  604.    5.4.6   [  OWNER ]
  605.    This function is available in both FAT and Cluster Edit mode.  It will
  606.    search the directory tree for the owner of the FAT chain which contains
  607.    the current cluster.  If an owner is found, the mode is switched to
  608.    Directory Edit mode, with the cursor at the Owning file name.  If the
  609.    first owner found is an erased entry, the search is continued until a
  610.    non-erased owner is found, or until the entire tree is searched. If the
  611.    entire tree is searched and only an erased owner is found, the erased
  612.    entry will be displayed.
  613.  
  614.  
  615.    6.0     CUSTOMIZING DDT
  616.  
  617.    6.1     DISPLAY ATTRIBUTES
  618.    DDT has two sets of colors or display attributes.  The first set is used
  619.  
  620.                                        7
  621.  
  622.  
  623.    for monochrome displays, and for CGA-type displays which are in BW80
  624.    mode.  The second set is used for EGA-type displays and CGA-type displays
  625.    in CO80 mode, or when specified by the /C command line parameter.  Both
  626.    sets contain 10 colors, and are present in the DDT.EXE file in a data
  627.    structure as shown:
  628.  
  629.      DDT COLOR SET 1>...........<DDT COLOR SET 2>...........<END OF COLORS
  630.  
  631.    Each period represents a one-byte color or attribute value.  The uses for
  632.    each of the eleven colors are described below, in the order that the
  633.    colors appear in the data structure.
  634.  
  635.          COLOR     USES
  636.  
  637.            1       Unchanged edit-able data and status field labels
  638.            2       Changed edit-able data
  639.            3       Prompts and warnings
  640.            4       Status fields
  641.            5       Menu labels for function key menus ( line 24 )
  642.            6       Menu cursor for function key menus ( line 24 )
  643.            7       Boxes
  644.            8       Line markers: '>' and '<'
  645.            9       Function key labels ( line 23 )
  646.           10       Function descriptions ( line 25 )
  647.           11       Menu cursor while the function is in progress
  648.  
  649.    The color sets can be customized with DDT by finding the DDT.EXE file in
  650.    the Directory Mode, then selecting Cluster Mode.  This will display the
  651.    first cluster of DDT.EXE.  Next, execute an ASCII search for 'DDT COLOR
  652.    SET' to find the color data in the file.  Hex mode Cluster editing can be
  653.    used to customize the color sets, and the new colors can then be written
  654.    into the DDT.EXE file.
  655.  
  656.    6.2     FUNCTION KEY ASSIGNMENTS
  657.    Each of the three edit modes in DDT has a menu with up to 20 available
  658.    functions assigned to the function keys [F1] through [F10], and
  659.    [Shift]+[F1] through [Shift]+[F10].  The order in which functions are
  660.    assigned to specific function keys is determined by three data structures
  661.    in the DDT.EXE file.  The data structures will appear as shown:
  662.  
  663.  
  664.        CLUSTER MODE >IGCQKJMNABDHRTSLOPEF< END
  665.  
  666.      DIRECTORY MODE >IGCQKJMNABDHR SLOPTU< END
  667.  
  668.            FAT MODE >IGCOKJMNABDH   L  EF< END
  669.  
  670.  
  671.    Each data structure controls the menu definition for one of the three
  672.    edit modes.  The 20 characters between the ">" and "<" in each data
  673.    structure map the available menu functions into function keys [F1]
  674.    through [F10], and [Shift]+[F1] through [Shift]+[F10], in that order.
  675.    The available functions are identified by capital letters as defined by
  676.    the following table:
  677.  
  678.  
  679.  
  680.  
  681.  
  682.                                        8
  683.  
  684.  
  685.                 CLUSTER         DIRECTORY       FAT
  686.                 MODE            MODE            MODE
  687.  
  688.         A       [  WRITE ]      [  WRITE ]      [  WRITE ]
  689.         B       [  CLEAR ]      [  CLEAR ]      [  CLEAR ]
  690.         C       [ SEARCH ]      [ SEARCH ]      [ SEARCH ]
  691.         D       [  STATS ]      [  STATS ]      [  STATS ]
  692.         E       [ BootCl ]      [ BootCl ]      [ BootCl ]
  693.         F       [ RootCl ]      [ RootCl ]      [ RootCl ]
  694.         G       [ Nw-DRV ]      [ Nw-DRV ]      [ Nw-DRV ]
  695.         H       [  EXIT  ]      [  EXIT  ]      [  EXIT  ]
  696.         I       [  HELP  ]      [  HELP  ]      [  HELP  ]
  697.         J       [   DIR  ]      [ SUBDIR ]      [   DIR  ]
  698.         K       [ Hx/Chr ]      [ CLUSTR ]      [ CLUSTR ]
  699.         L       [  OWNER ]      [ UNERAS ]      [  OWNER ]
  700.         M       [  PREV  ]      [  PREV  ]      [  PREV  ]
  701.         N       [  NEXT  ]      [  NEXT  ]      [  NEXT  ]
  702.         O       [   -1   ]      [ PARENT ]      [  FAT # ]
  703.         P       [   +1   ]      [  ROOT  ]      [        ]
  704.         Q       [   FAT  ]      [   FAT  ]      [        ]
  705.         R       [  S-ALL ]      [ S-TREE ]      [        ]
  706.         S       [ Asc/EB ]      [  SAVE  ]      [        ]
  707.         T       [ 1st CL ]      [   GET  ]      [        ]
  708.         U       [        ]      [   PUT  ]      [        ]
  709.  
  710.    The menus can be customized with DDT by finding the DDT.EXE file in the
  711.    Directory Mode, then selecting Cluster Mode.  This will display the first
  712.    cluster of DDT.EXE.  Next, execute an ASCII search for the  data
  713.    structure header for the selected menu ( for example 'CLUSTER MODE' ) to
  714.    find the menu definition data structure in the file.  Character mode
  715.    Cluster editing can be used to customize the menu, and the new data
  716.    structure can then be written into the DDT.EXE file.  A "space", instead
  717.    of a capital letter, in the function key data area will cause no function
  718.    to be assigned to the corresponding function key.  Functions can be used
  719.    more than once, or not used at all, but a valid function MUST be assigned
  720.    to AT LEAST ONE of the keys [F1] through [F10].
  721.  
  722.  
  723.    7.0     CHANGES
  724.  
  725.    Version 1.2 includes the following changes from version 1.1:
  726.  
  727.      - Fixed a bug in the FAT WRITE function which caused only the first
  728.        copy of the FAT to be written, or caused the FAT WRITE function to
  729.        hang if only 1 FAT copy existed ( on VDISKS ).
  730.  
  731.      - Fixed a bug in the presence test for the enhanced keyboard which
  732.        caused the test to pass when no enhanced keyboard was present,
  733.        resulting in a lock-up on the first enhanced keyboard Wait call.
  734.  
  735.      - Fixed a bug in the Cluster SEARCH function which cause the search to
  736.        hang if a single-character target was used in a multi-cluster search.
  737.  
  738.      - Changed cursor type selection to try to avoid "disappearing" cursors.
  739.  
  740.      - Moved the UNERASE function to a function key ( [SF6] ), instead of
  741.        acting on the type-over of the "Erased character".
  742.  
  743.  
  744.                                        9
  745.  
  746.  
  747.      - Added the SAVE function ( [SF7] ) to Directory Edit mode, which
  748.        allows writing a file to a drive other than the target drive.
  749.  
  750.      - Added the /A ( ASSUME ) command line parameter, which allows the user
  751.        to tell DDT to assume a format for a disk(ette) that does not have a
  752.        valid format defined in the Boot Record.
  753.  
  754.      - Added the /K command line parameter, which will cause DDT to not use
  755.        any Enhanced Keyboard BIOS functions.
  756.  
  757.      - Added a color to the DDT Color sets.
  758.  
  759.    Version 1.21 includes the following changes from version 1.2:
  760.  
  761.      - Fixed a bug in Enhanced Keyboard presence test which cause the test
  762.        to sometimes indicate "present" in error.
  763.  
  764.    Version 1.22 includes the following changes from version 1.21:
  765.  
  766.      - Fixed a bug in the SAVE function which caused an error message for
  767.        files which ended exactly on a cluster boundary.  The fix will allow
  768.        files to be saved even when the file size in the directory entry does
  769.        not agree with the size of the FAT chain.  The FAT chain size will be
  770.        used for the SAVE.
  771.  
  772.    Version 1.4 includes the following changes from version 1.22:
  773.  
  774.      - Added support for DOS 4.0, including support for volumes > 32 Meg.
  775.  
  776.      - Added support for display modes with > 25 lines.  DDT will check the
  777.        number of lines displayed when the program is started, and use all
  778.        available lines.
  779.  
  780.      - Added customizing capability to function key assignments.
  781.  
  782.      - Added [ Nw DRV ], [  EXIT  ], and [  HELP ] menu functions.
  783.  
  784.  
  785.    Version 1.41 includes the following changes from version 1.4:
  786.  
  787.      - Changed DOS version check to also look for OS/2 compatabilty box.
  788.  
  789.      - Added /Q command line parameter to turn off the speaker.
  790.  
  791.      - Changed exit path to RESET the edited drive before exiting.
  792.  
  793.  
  794.    Version 1.42 includes the following changes from version 1.41:
  795.  
  796.      - Fixed a bug in the cursor type selection for EGA.
  797.  
  798.      - Fixed a bug in the subdirectory read/write function for large
  799.        DOS 4 hardfiles.
  800.  
  801.  
  802.    Version 1.43 includes the following changes from version 1.42:
  803.  
  804.      - Fixed a bug in the calculations to determine FAT format.
  805.  
  806.                                       10
  807.  
  808.  
  809.    Version 1.5 includes the following changes from version 1.43:
  810.  
  811.      - Added [  FAT # ] function to allow all copies of the FAT to be
  812.        accessed individually.
  813.  
  814.      - Add [ GET ] and [ PUT ] functions to Directory Edit mode, to allow
  815.        saving a directory entry and writing it to another directory
  816.        location.
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.                                       11
  864.