home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / progpack / cprot.lbr / CPROT.DZC / CPROT.DOC
Encoding:
Text File  |  1992-05-13  |  2.1 KB  |  47 lines
  1. CPROT DOCUMENTATION
  2. ===================
  3.  
  4. CPROT is a useful utility for debugging CCP or a test DOS which must be 
  5. loaded into memory prior to loading and running a debugger.  If the 
  6. location of the program to be debugged is such that it is in danger of 
  7. being overlaid by the debugger or other code which normally loads into high 
  8. memory, then CPROT may be used to "protect" memory above a user specified 
  9. address from the debugger, or from any relocating code which uses the DOS 
  10. vector at 06h to determine the top of available memory.
  11.  
  12. CPROT generates a "double jump" to the start of CP/M DOS.  The DOS address 
  13. at 06h is replaced with the address 3 bytes below start of the requested 
  14. protected memory.  This address in turn contains a protection vector, ajump 
  15. to the true start of DOS.  
  16.  
  17. Since control is returned to the CCP after protected memory is defined, 
  18. CPROT can not and will not place a protection vector above the start of the 
  19. CCP and will return an error message if an attempt is made to do so. 
  20. Likewise, it will not set a protection vector within the body of it's own 
  21. code, nor above a protection vector previously set with CPROT or another 
  22. utility.  CPROT should, however, be used with care with ZCPR shells such as 
  23. EASE or LSH since the placement of the protection vector can interfere with 
  24. the normal operation of such shells.  It is best, when using protected 
  25. memory defined with CPROT, to terminate all ZCPR shells prior to running 
  26. CPROT.   If CPROT is being used to protect memory when debugging a shell 
  27. then the protection address, if one can be used, must be determined by 
  28. trial and error.
  29.  
  30. CPROT is self documenting and will return a short and simple explanation of 
  31. itself if invoked with no argument or with the "?" or "/" help arguments.
  32.  
  33. The syntax for CPROT is:
  34.  
  35. CPROT nnnn
  36.  
  37. where nnnn is the hex address for the beginning of user protected memory.  
  38.  
  39. Assembly and linkage of the source code for CPROT requires the syslib and 
  40. z3lib libraries.
  41.  
  42. Lindsay Haisley
  43. 14206 Spreading Oaks Drive
  44. Leander, TX   78641
  45. (512) 444-8691 (data)
  46. (512) 259-1190 (vox)
  47.