home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / disk / Devs+Handler / MEM-Handler / MEM.Doc < prev    next >
Text File  |  1994-10-04  |  4KB  |  103 lines
  1.                              MEM-Handler 37.1
  2.  
  3.                 (c) 1994 Peter Corlett.  ALL RIGHTS RESERVED
  4.  
  5. ***************************************************************************
  6.  
  7. "FULLY LIMITED WARRANTY" ['Borrowed' from Citadel]
  8.  
  9. "I warrant this product against defect in material and workmanship for a
  10. period of 1/5 of a second or one (1) disk revolution, which ever occurs
  11. first.
  12.  
  13. "During the warranty period we will replace, repair or ignore (at our
  14. option) any defective item provided it has not been subjected to flagrant
  15. abuse such as:  inserting the disk in a disk drive; reading the instruction
  16. manual, etc; or used in accordance with the directions supplied.
  17.  
  18. "No other warranties are expressed including the warranties of
  19. merchantablity; fitness for a particular purpose; or delivery of product
  20. ordered.  Nothing in this statement shall be construed as a written
  21. statement of warranty or guarantee including, but not limited to, this
  22. sentence.
  23.  
  24. "This statement takes away specific legal rights and you may have other
  25. rights taken away which may vary from state to state."
  26.  
  27. i.e.  this is FREEWARE.  If you wish to supply it with one of your own
  28. programs (e.g.  the assembler example below) then please contact me (at
  29. least so I can give you the latest version.)
  30.  
  31. Public domain libraries and resellers may not sell this program, for more
  32. than 2 UK pounds, or its equivalent in any other currency.
  33.  
  34. ***************************************************************************
  35.  
  36. The original MEM-Handler (hereafter referred to as MEM:) was hacked
  37. together in one hour, after a suggestion by Simon Goodwin that he missed
  38. something similar from the QL.  Since writing it, I have updated into
  39. something that may even be useful to someone!
  40.  
  41. MEM:  is a handler to access memory directly from DOS.  Rather than RAM:,
  42. which is a true filesystem, with real files and directories, MEM:  just
  43. accessed memory directly.  It's a sort of raw mode for RAM:
  44.  
  45. MEM:  requires Kickstart 2.04 or higher.  Who uses 1.3 these days?  Using
  46. 2.04 means I can reduce the size of the executable somewhat, by using ROM
  47. routines.
  48.  
  49. To use MEM:  you just Mount it, and then access the file
  50. "MEM:<LENGTH>/<START>".
  51.  
  52. <LENGTH> is the (maximum) size of the memory area you want to access.  MEM:
  53. will not allow you to go outside the bounds of this length.  On reading,
  54. you will get an EOF when you have read <LENGTH> bytes.  On writing, the
  55. write will be truncated, and the program accessing MEM:  will be told how
  56. much was actually written (whether the program bothers to tell you is up to
  57. it; most don't bother.) This number may be decimal (42), octal (042), or
  58. hexadecimal (0x42).
  59.  
  60. <START> is the start address of the memory you want to access.  MEM:  does
  61. NOT attempt to allocate the memory you refer to.  Make sure that you know
  62. what you are doing, especially when writing.
  63.  
  64. If you omit <START> then MEM:  will allocate a clear bit of memory for you.
  65. On closing the file it will free it again for you, and you can consider the
  66. data lost.
  67.  
  68.  
  69. Here are a few examples:
  70.  
  71. To look at the Kickstart ROM:
  72.  
  73. Type MEM:0x80000/0xf80000 HEX
  74.  
  75.  
  76. To write a file to the middle of CHIP RAM (assuming 2Mb CHIP here):  This
  77. will only ever overwrite a maximum of 1000 bytes.
  78.  
  79. Copy <file> MEM:1000/0x100000
  80.  
  81.  
  82. Silly usage:
  83.  
  84. Copy MEM:1000 MEM:1000/0x100000 ; clear memory
  85.  
  86. Dir >MEM:1000/0x100000 ; write directory to memory
  87.  
  88. Type MEM:1000/0x100000 ; show directory
  89.  
  90.  
  91. What is the use?  Firstly, it can be used for debugging, and looking at
  92. memory.  Another use would be to present the memory of an editor to an
  93. assembler, without having to write out an intermediate file.  The errors
  94. from the assembler can be written direct to memory, and looked at with the
  95. editor.
  96.  
  97. If you need to contact me for any reason:
  98.  
  99. Snail Mail:  Peter Corlett, 382 Slade Rd, Erdington, Birmingham, B32 7LG,
  100. ENGLAND.
  101.  
  102. E-Mail:  corlepnd@aston.ac.uk (if you're lucky...)
  103.