home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / utils2 / rmem101.arj / READMEM.DOC < prev    next >
Text File  |  1994-03-08  |  5KB  |  94 lines
  1. ------------------------------------------------------------------------
  2.    THIS PROGRAM IS NOT PUBLIC DOMAIN! IT IS COPYRIGHTED SOFTWARE.
  3. ------------------------------------------------------------------------
  4.   Now that we have that out of the way, I can tell you what it is.  This
  5. program is giftware.  If you like it, and you use it I would like you to
  6. send me a gift! I would like 1 3.5"HD floppy disk.  No, I am not going to
  7. send it back with the newest version; partly because I have no idea when
  8. that will be and partly because I will always upload the most recent
  9. fully working (ie, not crippled in any way) version whenever I have
  10. finished it.  I would like a disk because I hate buying them and I go
  11. though hundreds of them.  So if you think in monitary terms the registration
  12. fee is about 80 cents.  (Floppies out here go for around $0.50 each).
  13. Here is where to send the disk:
  14.   Sean Kennedy
  15.   12082 Ellen St.
  16.   Garden Grove, CA
  17.   USA   92640-3227
  18.  
  19. ------------------
  20. WHY READMEM
  21. ------------------
  22.     This program is just a simple memory dump program. It has its roots in
  23.   the debug D (dump) command.  I originally wrote this to help me give IBM
  24.   memory dump information when I was using their beta S3 drivers.  I was
  25.   sick of using debug's ugly interface.  I also wanted to write a program
  26.   in 100% assembly, and thus READMEM was born.
  27.  
  28. -----------------
  29. HOW DOES IT WORK
  30. -----------------
  31.     At its simplist, you can just use the page up and page down keys to
  32.   cycle through memory a screen full at a time.  You can also use the
  33.   cursor up and cursor down keys to move up or down a line at a time.
  34.   In addition to these commands I have added several more that can make
  35.   scanning though a memory dump more interesting.  By default READMEM
  36.   starts off at the bios data area (0040:0000).  You can return to this
  37.   area at any time by pressing 'B'.  You can move to the top of memory
  38.   (0000:0000) by pressing the HOME key and to the bottom of memory
  39.   (FFFF:FFFF) by pressing the END key.  The 'G' key will allow you to
  40.   enter any segment and offset pair and the program will begin is new
  41.   display there.  The left arrow key will move a line up though memory
  42.   continuosly without having to keep pressing it.  This allows you to sit
  43.   back and just watch the dump.  The right arrow key works the same
  44.   going down through memory.  The 'H' key will bring up a small help
  45.   screen to remind you of all of these commands.  My favorite command
  46.   is the 'D'ynamic Display command.  When you press 'D' the program will
  47.   keep re-scanning memory while it waits for your next command.  This will
  48.   allow you to view any changes to the ram in real time.  To demonstrate
  49.   this, when the program first starts up, use the 'D' command.  In the
  50.   bios data are where the program starts, you should see several addresses
  51.   continually changing.  One of these is the system clock.  Do remember
  52.   that the Intel family processors uses a reversed byte format, where the
  53.   low byte is displayed first and then high byte.  So the seconds (in hex)
  54.   will be the first byte rapidly changing and the minutes will be the
  55.   second byte.  The 'P' command will just do a printscreen (INT 5) and
  56.   dump the contents of the screen to your printer.  The 'Q' key or the
  57.   ESC key will exit you from the program.
  58.  
  59. -----------------
  60. FEATURES
  61. -----------------
  62.     Let's face it: this is the known bug list!  One thing big on my list
  63.   of 'things to fix' is memory wraparound.  I would like the program to
  64.   wrap from FFFF:FFFF to 0000:0000 and inversely.  As it is now, 01000h is
  65.   just subtracted from the segment so from FFFF:FFFF you would start at
  66.   0FFF:0000.  Minor but it bugs me.  I do not know of any more bugs, but
  67.   if you should find one please let me know.  You can contact me at the
  68.   above address or through the internet at sean.kennedy@kandy.com.
  69.  
  70. -----------------
  71. UPGRADE LIST
  72. -----------------
  73.     As I mentioned before, I will fix the wrap around problem, but before
  74.   to much longer I am going to add an editing feature so you can change
  75.   the contents of the ram.  I plan to upgrade the display routines, as
  76.   right now I am using the bios routines, but I would like to use some
  77.   direct video access, which should improve the speed of the display. I
  78.   would also like to be able to display all of ram, not just the first
  79.   megabyte, but I have to learn some protected mode assembly before I can
  80.   do that! (At least better than I currently know it!)  I plan on allowing
  81.   for a full or close to full screen display and if I get real exited I
  82.   may add a dissasemble mode!
  83.  
  84. -----------------
  85. HISTORY
  86. -----------------
  87.     Not much yet!  this is only the second version, and the first to be
  88.     released.
  89.  
  90.   v 1.00 - First version.  Never released.
  91.  
  92.   v 1.01 - First released version.  Optimized a lot of the code. Updated
  93.            display routines to be compatible with ANSI.SYS.
  94.