home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / doc / ems / demos / emmtools / dumpem.doc next >
Encoding:
Text File  |  1988-04-22  |  11.1 KB  |  244 lines
  1.  
  2.  
  3.  
  4.                                         DUMPEM
  5.                              DUMP Expanded/Extended Memory
  6.                                            
  7.                                      User's Guide
  8.                                            
  9.                                            
  10.                                            
  11.                INTRODUCTION
  12.                
  13.                DUMPEM is a utility which allows you to display and edit
  14.                conventional, expanded and extended memory.  For example, you
  15.                can display the contents of an extended memory RAM disk, or
  16.                edit a page of expanded memory, or display the contents of the
  17.                system BIOS ROM.
  18.                
  19.                The memory can be displayed in hexadecimal, unsigned decimal,
  20.                or decimal types, and in sizes of bytes, words, dwords, or
  21.                pointers.
  22.                
  23.                DUMPEM also has built-in memory diagnostics tests which will
  24.                write patterns into the currently displayed block of memory,
  25.                and will highlight data which fails the test's verify logic.
  26.                
  27.                The program was written primarily in P/LM-86, with a few
  28.                support routines written in ASM-86.
  29.                
  30.                
  31.                
  32.                SYSTEM REQUIREMENTS
  33.                
  34.                DUMPEM uses the BIOS INT 15h, functions 87h (block move) and
  35.                88h (return extended memory size) to manipulate extended
  36.                memory.  In addition, for ease of block transfer and editing,
  37.                the block move function is also used to display and edit
  38.                conventional and expanded memory.  Therefore, your system must
  39.                contain a BIOS (or device driver) which implements INT 15h,
  40.                functions 87h and 88h.
  41.                
  42.                Machines which meet the above restriction are the IBM AT and
  43.                compatibles, IBM PS/2 Models 50, 60, 80 and compatibles, the
  44.                Inboard 386/AT, and the Inboard 386/PC.
  45.                
  46.                The Inboard 386/PC is shipped with a device driver which, for
  47.                the first time, provides the INT 15h extended memory support
  48.                on a PC or XT machine, and makes use of the extended memory
  49.                hardware available on the Inboard 386/PC base board and
  50.                piggybacks..
  51.                
  52.                
  53.                
  54.                INSTALLING DUMPEM
  55.                
  56.                Simply copy the file DUMPEM.EXE from the diskette onto your
  57.                hard disk.
  58.  
  59.  
  60.  
  61.  
  62.                INVOKING DUMPEM
  63.                
  64.                DUMPEM is invoked by typing:
  65.                     DUMPEM
  66.                
  67.                
  68.                
  69.                THE DUMPEM SCREEN
  70.                
  71.                When invoked, DUMPEM will present you with a function key-
  72.                driven screen.
  73.                
  74.                The screen is divided into three major areas.  The top-most
  75.                area lists the function key commands and associated status
  76.                information.  The bottom, open area displays the memory region
  77.                being examined/edited.  A third area is "popped" into the 
  78.                screen center whenever additional status or error information
  79.                is displayed.
  80.                
  81.  
  82.                
  83.                AN EXPLANATION OF THE FUNCTION KEYS and OTHER OPTIONS
  84.                
  85.                ESC, X, x
  86.                DUMPEM can be exited by pressing ESC or 'X' or 'x'.
  87.                
  88.                ?
  89.                Pressing '?' displays a terse help screen which describes the
  90.                purpose of any keys which aren't listed on the main screen.
  91.                
  92.                Ctrl-PgUp, Ctrl-PgDn
  93.                Pressing Ctrl-PgUp will display the previous 256 byte block of
  94.                memory.  Pressing Ctrl-PgDn will display the next 256 byte
  95.                block of memory.  Edit the memory start address (F9) if you
  96.                wish to "jump" to a specific address rather than "page" to it.
  97.                
  98.                Left arrow, right arrow, up arrow, down arrow, PgUp, PgDn,
  99.                Home, End
  100.                Use these keys to move about the region you're currently
  101.                editing (either the memory data, page map array, or memory
  102.                start address).
  103.                
  104.                When editing the memory data, you can insert/replace any digit
  105.                by typing the ASCII digits 0 - 9, and letters A - F (A - F if
  106.                the data is being displayed in hexadecimal type).  When
  107.                editing the memory start address, you can insert/replace any
  108.                digit by typing the ASCII digits 0 -9 and letters A - F.  When
  109.                editing the page map array, you can insert/replace any digit
  110.                by typing the ASCII digits 0 - 9.
  111.                
  112.  
  113.  
  114.  
  115.                Ins
  116.                Ins toggles the edit mode from insert (small cursor) to
  117.                replace (large cursor).
  118.                
  119.                Rubout, Del, Space
  120.                Rubout deletes characters to the left of the cursor, and Del
  121.                deletes characters from the right of the cursor.  Space will
  122.                insert/replace digits with a space.  If an entire field is
  123.                overwritten with spaces, the field's value will be considered
  124.                0.
  125.                
  126.                Enter (Carriage Return)
  127.                Enter will cause DUMPEM to accept the edit changes you've made
  128.                to the currently selected editable screen area (either the
  129.                memory data area, the memory address area, or the page map
  130.                array area).
  131.                
  132.                <, >
  133.                < left-justifies all displayed data, and > right-justifies all
  134.                displayed data.
  135.                
  136.                F1
  137.                F1 toggles through the four display size options: BYTE, WORD,
  138.                DWORD, and POINTER.
  139.                
  140.                F2
  141.                F2 toggles through the three display type options:
  142.                HEXADECIMAL, UNSIGNED DECIMAL, and SIGNED DECIMAL.
  143.                
  144.                NOTE: when POINTER size is used, only the HEXADECIMAL type is
  145.                available.
  146.                
  147.                F3
  148.                F3 toggles through the twelve available diagnostics patterns:
  149.                FFFFFFFF, 00000000, 0F0F0F0F, F0F0F0F0, AAAAAAAA, 55555555,
  150.                A5A5A5A5, 5A5A5A5A, 01234567, 76543210, 89ABCDEF and FEDCBA98.
  151.                Once the pattern has been selected, you can subsequently press
  152.                F4 or F5 to automatically write the pattern to the selected
  153.                memory block and verify the results.
  154.                
  155.                F4
  156.                F4 writes the specified pattern into the currently selected
  157.                block of memory (256 bytes in length).  After writing the
  158.                pattern into memory, DUMPEM verifies the write and will
  159.                highlight the data which doesn't match the expected pattern.
  160.                You will be prompted with a confirmation message asking you
  161.                whether you really want to write/verify the pattern.
  162.                
  163.                NOTE: the verify logic is size-sensitive -- that is, if you
  164.                were displaying the data in WORD size, then the verify logic
  165.                will compare each WORD in the memory region with the low-order
  166.                WORD of the specified pattern.  If you were displaying the
  167.                data in DWORD size, then the verify logic will compare each
  168.                DWORD in the memory region with the entire DWORD of the
  169.                specified pattern.
  170.  
  171.  
  172.  
  173.  
  174.                F5
  175.                F5 writes the specified pattern from the currently selected
  176.                block of memory all the way up to the top of extended memory.
  177.                Each block of memory is written/verified with each of the
  178.                twelve diagnostics patterns.  You will be prompted with a
  179.                confirmation message asking you whether you really want to
  180.                write/verify the patterns.
  181.                
  182.                NOTE: take great care when using functions F4 and F5.  They
  183.                overwrite the currently selected block of memory with the
  184.                specified pattern.
  185.                
  186.                F6
  187.                F6 displays a summary of the system memory complement
  188.                (conventional, expanded, extended), displays the expanded
  189.                memory page frame address, and also tells you how many
  190.                expanded memory pages have been allocated to DUMPEM.
  191.                
  192.                F7
  193.                F7 toggles through the list of active expanded memory handles.
  194.                Resident TSR or device driver software (like expanded memory
  195.                RAMdisks or print buffers) will typically have at least one
  196.                active expanded memory handle.
  197.                
  198.                DUMPEM will allocate the rest of the available expanded memory
  199.                pages.  Use F6 to see how many expanded memory pages have been
  200.                allocated to DUMPEM.
  201.                
  202.                Once you've toggled to the appropriate expanded memory handle,
  203.                you can press F8 to begin editing the physical-to-logical page
  204.                map array so that any of the handle's logical pages can be
  205.                mapped into the expanded memory page frame.  The page frame
  206.                address can be obtained via F6.
  207.                
  208.                F8
  209.                F8 moves the cursor into the physical-to-logical page map
  210.                array.  Once there, you can begin editing the array, assigning
  211.                any logical page to any physical page for the selected
  212.                expanded memory handle.  Press Enter when you've finished
  213.                editing the array -- DUMPEM will then map in the pages.
  214.                
  215.                F9
  216.                F9 moves the cursor to the memory address field so that you
  217.                can begin editing the memory start address.  The start address
  218.                can be on any boundary.  Press Enter when you want DUMPEM to
  219.                accept the edit changes.
  220.                
  221.                F10
  222.                F10 moves the cursor to the memory data area of the screen so
  223.                that you can begin editing the memory data.  Press Enter when
  224.                you want DUMPEM to accept the edit changes.
  225.                
  226.  
  227.  
  228.  
  229.                LIMITATIONS AND DISCLAIMERS
  230.                
  231.                DUMPEM is not an "official" product.  It has only been tested
  232.                by its author.
  233.                
  234.                YOU are responsible for ensuring the memory data which you
  235.                edit directly, or overwrite with the test patterns, is
  236.                expendable.  The author is not liable for your actions.
  237.                
  238.                
  239.                
  240.                GUARANTEES
  241.                
  242.                There are none.
  243.  
  244.