home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug056.arc / DUMPX.DOC < prev    next >
Text File  |  1979-12-31  |  4KB  |  108 lines
  1.             --- DUMP ---
  2.  
  3.                     BY: S. J. SINGER
  4.  
  5.     THIS PROGRAM IS AN IMPROVED DUMP UTILITY FOR CP/M. ANY CPM FILE
  6. MAY BE DUMPED TO THE CONSOLE IN A FORMAT SIMILAR TO THAT USED BY THE
  7. DDT DUMP COMMAND. IN ADDITION, ANY SECTOR OR GROUP OF SECTORS MAY
  8. BE DUMPED IN THE SAME FORMAT.
  9.  
  10.             -- OPERATION --
  11.  
  12.     THE PROGRAM MAY BE RUN EITHER BY TYPING DUMP, OR DUMP FOLLOWED
  13. BY THE FILE NAME OR TRACK AND SECTOR. IF DUMP  IS TYPED THE PROGRAM
  14. RESPONDS WITH A HEADING FOLLOWED BY A '*' AND WAITS FOR MORE INPUT. 
  15. OPERATION IN THIS MODE IS SIMILAR TO OTHER UTILITIES LIKE PIP OR DDT.
  16.     THE OPERATION DESIRED MAY THEN BE TYPED IN AS FOLLOWS:
  17.  
  18.         DUMP FILE.NAM
  19.         DUMP A:FILE.NAM
  20.         DUMP B:FILE.NAM
  21.  
  22.     OR DUMP MAY BE TYPED SEPARATELY AS:
  23.  
  24.         DUMP
  25.  
  26.         *FILE.NAM
  27.         *B:FILE.NAM    (THE * IS A PROGRAM PROMPT)
  28.  
  29.     THE PROGRAM MAY ALSO BE USED TO DUMP DISK SECTORS DIRECTLY,
  30. DUMP ANY CP/M EIGHT SECTOR GROUP, A MAP OF THE GROUP ALLOCATIONS FOR THE
  31. ENTIRE DISK OR THE DIRECTORY SORTED ALPHABETICALLY.
  32.  
  33.         DUMP TRACK 3 SECTOR 7
  34.         DUMP TRACK 5   SECTOR  3 - 9
  35.         DUMP TRACK   6   (DUMPS ALL 26 SECTORS)
  36.         DUMP GROUP  19
  37.         DUMP MAP
  38.         DUMP DIR    (DUMPS DIRECTORY)
  39.  
  40.     THE WORDS TRACK, SECTOR AND GROUP MAY BE ABREVIATED AS FOLLOWS
  41.  
  42.         DUMP G 4
  43.         DUMP T 7 S 3-4
  44.         *TRACK 5 S 6
  45.         *SECTOR 2- 9  T 14
  46.  
  47.  
  48.         DUMP B:  TRACK 3
  49.         DUMP A: T 9   S 4-6
  50.         DUMP B:   G  5
  51.         DUMP B:MAP
  52.  
  53.     NOTE THAT THE FORMAT IS QUITE FREE. SPACES ARE USUALLY IGNORED
  54. THEY ARE ONLY REQUIRED AFTER THE WORDS TRACK AND SECTOR OR T AND S,
  55. AND AFTER THE WORD DUMP.
  56.     A LIMITED EDITING FEATURE IS INCLUDED IN THE DUMP UTILITY TO
  57. ALLOW CHANGING DATA ON THE DISK. THE EDIT FEATURE WORKS AS FOLLOWS.
  58. ANY SINGLE SECTOR ON EITHER DRIVE MAY BE EDITED BY REQUESTING DISPLAY
  59. OF THE SECTOR FOLLOWED BY THE WORD EDIT.
  60.  
  61.         DUMP B:TRACK 4 SECTOR 2  EDIT
  62.  
  63.     THE REQUESTED SECTOR WILL BE DISPLAYED FOLLOWED BY AN EDIT PROMPT
  64.  
  65.     EDIT -
  66.  
  67.     ENTER THE ADDRESS OF THE FIRST BYTE TO BE CHANGED. THE PROGRAM WILL
  68. RESPOND BY TYPING BACK THE ADDR ENTERED AND THE PRESENT CONTENTS OF THAT
  69. ADDRESS. TO CHANGE THE CONTENTS OF THE ADDRESS ENTER THE NEW BYTE FOLLOWED
  70. BY A CARRIAGE RETURN. THE PROGRAM WILL DISPLAY THE NEXT ADDRESS AND ITS
  71. CONTENTS. TO STOP ENTERING DATA TYPE A PERIOD. THE PROGRAM WILL REDISPLAY
  72. THE SECTOR SHOWING THE CHANGES MADE. THE EDIT FEATURE WORKS ALMOST EXACTLY
  73. LIKE THE S ENTRY FEATURE IN DDT. TYPING ONLY A CARRIAGE RETURN OMITS ENTRY.
  74.     TYPING A PERIOD MERELY REDISPLAYS THE SECTOR FROM MEMORY, IT DOES
  75. NOT CAUSE IT TO BE WRITTEN BACK ON THE DISK. WHEN EDITING IS COMPLETE,
  76. REDISPLAY THE SECTOR BY TYPING A PERIOD AND TYPE EITHER
  77.  
  78.         WRITE        (WRITE SECTOR BACK ON DISK)
  79.         STOP        (STOP EDITING WITHOUT WRITING ON DISK)
  80.  
  81.     ALL EDIT ENTRIES MUST BE MADE IN HEX. ENTERING NON HEX CHARACTERS
  82. RESULTS IN AN ERROR MESSAGE. THE PERMISSABLE ADDRESS RANGE IS 0000 TO 007F.
  83. LARGER ADDRESSES GIVE AN ERROR MESSAGE. WHEN ENTERING A GROUP OF BYTES THE
  84. ADDRESSES ARE COMPUTED MODULO 128, THE NEXT ADDRESS AFTER 007F IS 0000.
  85.     THE EDIT FEATURE SHOULD BE USED WITH CAUTION SINCE IT IS POSSIBLE
  86. TO EDIT CP/M TO "DEATH" BY CHANGING A SINGLE BYTE. ONE OCCASIONAL VALUABLE
  87. USE IS TO RESTORE FILES THAT HAVE BEEN ACCIDENTALLY ERASED. ERASING A FILE
  88. USING THE ERA COMMAND DOES NOT ERASE THE DATA FROM THE DISK, BUT ONLY ENTERS
  89. AN E5 INTO THE FIRST BYTE OF THE DIRECTORY. TO RESTORE A FILE, DISPLAY
  90. THE DIRECTORY BY DISPLAYING GROUPS 0 AND 1. FIND THE SECTOR CONTAINING THE
  91. NAME OF THE FILE TO BE RESTORED AND DISPLAY IT USING THE EDIT FEATURE
  92. CHANGE THE BYTE PRECEEDING THE FILE NAME FROM E5 TO 00 AND WRITE THE SECTOR
  93. BACK ON THE DISK. THIS WILL RESTORE THE FILE PROVIDED NONE OF THE SECTORS
  94. IN THE FILE WERE CHANGED AFTER THE FILE WAS "ERASED".
  95.  
  96.     AN ADDITIONAL FEATURE OF DUMP IS THE ABILITY TO VALIDATE A DISK.
  97.  
  98.         DUMP VALIDATE
  99.         DUMP A:VALIDATE
  100.         DUMP B:VALIDATE
  101.  
  102.     THIS CAUSES THE ENTIRE DISK SELECTED TO BE READ ONE SECTOR AT A
  103. TIME. THE SECTOR NUMBER OF ANY SECTOR CAUSING A READ ERROR WILL BE DISPLAYED.
  104. WHEN VALIDATING THE PROGRAM READS EVERY SECOND SECTOR FOR SPEED.
  105.  
  106.     AS WITH OTHER CP/M UTILITIES ^S "FREEZES" THE DISPLAY, AND ^C
  107. RETURNS TO THE MONITOR. DUMP CONTAINS MANY ERROR AND CONSISTANCY
  108. CHECKS. THE RESULTING MESSAGES SHOULD BE SELF EXPLANATORY.