home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / develop / dmon / dmon.doc < prev    next >
Text File  |  1995-02-27  |  10KB  |  420 lines
  1.  
  2.  
  3. Donaldos 68030-82 Monitor version 1.86
  4. **************************************
  5.  
  6. Copyright
  7. *********
  8.  
  9.    DMon V1.86 is (C) Copyright 1991-93  Andreas Smigielski Wiedweg 5,
  10. 38120 Braunschweig, Germany. Internet: wk039318@rzcipa01.rz.tu-bs.de
  11.  
  12.    Permission is granted to distribute DMon for non-comercial usage
  13. only.  Any comercial distributition should by allowed by written
  14. permission by the author.  No waranty is made for anything DMon can or
  15. can not do. The use of DMon is on your own risk.
  16.  
  17. What is DMon
  18. ************
  19.  
  20.    DMon is a multi-purpouse utility written for my personal usage only.
  21. It is a Monitor, Dissassembler, Debuger and development system for my
  22. own programs. You may find similarities to Amiga Monitor by Timo Rossi.
  23. But DMon is different, it can dissassemble and debug 68xxx software in
  24. User and Supervisor Mode. If you do not know what that mean, than do
  25. not use DMon! 68000 users should know that DMon may run on these
  26. machines, but no waranty is made that every function should work as on
  27. other systems.  Kick V1.3 users may find that since version 1.70 DMon
  28. needs Kick V2.0 to work.  There is no need to support Kick V1.3 Amigas
  29. either.
  30.  
  31. Commands in DMon
  32. ****************
  33.  
  34.    Everything in [..] is optional.  All memory locations, addresses and
  35. other input should be inputed in HEX if not otherwise stated.
  36.  
  37. Disassemble Memory
  38. ==================
  39.  
  40.        COMMAND     FLAGS
  41.  
  42.        D        [MemAddr] [EndAddr]
  43.  
  44.    Disassemble memory at MemAddr. If no EndAddr is specified 16 lines
  45. will be written to standard output.
  46.  
  47. Show Memory HEX/ASCII
  48. =====================
  49.  
  50.        COMMAND     FLAGS
  51.  
  52.        M        [MemAddr] [EndAddr]
  53.  
  54.    Display memory as HEX/ASCII at MemAddr. If no EndAddr is specified
  55. 16 lines will be written to standard output.
  56.  
  57. Show Memory Visual
  58. ==================
  59.  
  60.        COMMAND     FLAGS
  61.  
  62.        SHOW        [MemAddr]
  63.  
  64.    Display memory as a picture at the memory location specified by
  65. MemAddr.  For memory hunting. MemAddr will be set by other commands.
  66. You can use arrow keys or Mouse to scroll through bitmap Keypad +
  67. advance modulo, Keypad - disadvance modulo Del to reset modulos,
  68. Enter/Return switch between High and Low resolution display, Space to
  69. exit Show Memory.
  70.  
  71. Read Raw Tracks
  72. ===============
  73.  
  74.        COMMAND     FLAGS
  75.  
  76.        READ        MemAddr Start Number
  77.  
  78.    Read RAW Tracks from disk. MemAddr is the address where the tracks
  79. will be    MFM decoded. Start is the start    track to read from. Number is the
  80. number of tracks to read.
  81.  
  82. Write Raw Tracks
  83. ================
  84.  
  85.        COMMAND     FLAGS
  86.  
  87.        WRITE        MemAddr Start Number
  88.  
  89.    Write RAW Tracks to disk. Not in the public version!
  90.  
  91. Get Help
  92. ========
  93.  
  94.        COMMAND     FLAGS
  95.  
  96.        HELP
  97.  
  98.    This will display short discription of commands available.
  99.  
  100. Open Output Channel
  101. ===================
  102.  
  103.        COMMAND     FLAGS
  104.  
  105.        OPEN        [Output Channel]
  106.  
  107.    This will open another output channel, default is console output
  108. window.  Valid output is anything Amiga DOS will understand.  Example
  109. "Open CON://640/200/Donaldos", "Open SER:", "Open PAR:" or "Open File".
  110.  
  111. Close Output Channel
  112. ====================
  113.  
  114.        COMMAND     FLAGS
  115.  
  116.        CLOSE
  117.  
  118.    Close a before opend output channel.
  119.  
  120. Swap Output Channel
  121. ===================
  122.  
  123.        COMMAND     FLAGS
  124.  
  125.        SWAP
  126.  
  127.    Swap between two output channels.
  128.  
  129. Fill Memory
  130. ===========
  131.  
  132.        COMMAND     FLAGS
  133.  
  134.        FILL        Start End Bytes
  135.  
  136.    Fill memory with something. To fill with ASCII strings Enter: "Fill
  137. 0 2000 Hello!". To fill with a HEX value  Enter: "Fill 0 2000 $12345"
  138. HEX fill is only Byte, Word or Long. It depends on the value you enter.
  139.  
  140. Find String/HEX
  141. ===============
  142.  
  143.        COMMAND     FLAGS
  144.  
  145.        FIND        Start End String
  146.  
  147.    Find a string in memory. To find a ASCII string Enter: "Find 0 2000
  148. Me!" To find a HEX value Enter: "Find 0 2000 $1234"
  149.  
  150. Loading Files
  151. =============
  152.  
  153.        COMMAND     FLAGS
  154.  
  155.        [        MemAddr [File]
  156.  
  157.    Load a File into memory. If no filename is specified a file requester
  158. should apear where the file can be selected.
  159.  
  160. Partial Loading from Files
  161. ==========================
  162.  
  163.        COMMAND     FLAGS
  164.  
  165.        [ #        MemLoc Offset Size [File]
  166.  
  167.    Load a partial block from a file. If no filename is specified a file
  168. requester should apear where the file can be selected.
  169.  
  170. Writing Memory to Files
  171. =======================
  172.  
  173.        COMMAND     FLAGS
  174.  
  175.        ]        MemAddr Size File
  176.  
  177.    Write memory at MemAddr to a file. Size is the amount of bytes to
  178. write to the file. If no filename is specified a file requester should
  179. apear where the file can be selected.
  180.  
  181. Transfer Memory
  182. ===============
  183.  
  184.        COMMAND     FLAGS
  185.  
  186.        T        Start End Destination
  187.  
  188.    Transfer Memory to a memory location specified by Destination.
  189.  
  190. Read from Device
  191. ================
  192.  
  193.        COMMAND     FLAGS
  194.  
  195.        <        MemAddr Unit Block Num
  196.  
  197.    Read a DOS block from disk or other device. Example: < 60000 0 0 2
  198. This will read the Boot Block from disk in drive 0 (DF0:).  The device
  199. can be set with the 'DEV' command.
  200.  
  201. Write to Device
  202. ===============
  203.  
  204.        COMMAND     FLAGS
  205.  
  206.        >        MemAddr Unit Block Num
  207.  
  208.    Write a DOS block to disk or other device. Example: > 60000 0 0 2
  209. This will write the Boot Block to disk in drive 0 (DF0:).  The device
  210. can be set with the 'DEV' command.
  211.  
  212. Show Registers
  213. ==============
  214.  
  215.        COMMAND     FLAGS
  216.  
  217.        R
  218.  
  219.    This will show all CPU, FPU and MMU registers and condition codes,
  220. not only for debuging.
  221.  
  222. Change Directory
  223. ================
  224.  
  225.        COMMAND     FLAGS
  226.  
  227.        CD        Directory
  228.  
  229.    To change to a new directory the 'CD' command must be used.
  230.  
  231. Jump into Memory
  232. ================
  233.  
  234.        COMMAND     FLAGS
  235.  
  236.        JMP        MemAddress
  237.  
  238.    Jump to a memory location specified by MemAddress. The results may
  239. be shown with the 'R' command.
  240.  
  241. Jump into Subroutine
  242. ====================
  243.  
  244.        COMMAND     FLAGS
  245.  
  246.        JSR        MemAddress
  247.  
  248.    Jump to a subroutine in memory specified by MemAddress. The results
  249. may be shown with the 'R' command.
  250.  
  251. Go into Memory
  252. ==============
  253.  
  254.        COMMAND     FLAGS
  255.  
  256.        GO        StartAddr EndAddr
  257.  
  258.    This will execute code in memory from StartAddr until EndAddr.  Any
  259. RTS found before EndAddr will terminate the 'GO' command.  The results
  260. may be shown with the 'R' command.
  261.  
  262. Disk Block CkeckSum
  263. ===================
  264.  
  265.        COMMAND     FLAGS
  266.  
  267.        =        MemAddress
  268.  
  269.    To calculate the Disk Block CkeckSum.
  270.  
  271. Boot Block CheckSum
  272. ===================
  273.  
  274.        COMMAND     FLAGS
  275.  
  276.        #        MemAddress
  277.  
  278.    To calculate the Boot Block CheckSum.
  279.  
  280. Change Device
  281. =============
  282.  
  283.        COMMAND     FLAGS
  284.  
  285.        Dev        [devicename]
  286.  
  287.    To change the device this command should be used. Default is
  288. trackdisk.device.  Example: "dev scsi.device"
  289.  
  290. Format Disk
  291. ===========
  292.  
  293.        COMMAND     FLAGS
  294.  
  295.        Format        [-qv] Device [Unit]
  296.  
  297.    Like standard DOS format command, but better. Deep format will show
  298. any error occured and tries four times to format a track if format
  299. failed for any reason. Sometimes a dammaged disk can be repaired this
  300. way.  Modes are : -q for Quick format, -v for Deep format. To break
  301. format hit CTRL-C inside Output Window. Example: "Format df0:" This
  302. will format a FFS disk in drive df0:
  303.  
  304. Install Disk
  305. ============
  306.  
  307.        COMMAND     FLAGS
  308.  
  309.        Install        Device [Unit]
  310.  
  311.    Install South of Heaven a nice utility. The install command will
  312. install the Boot Block on any DOS disk (OFS/FFS) automaticly. South of
  313. Heaven can be replaced with standard OS 2.0 boot code by menu selection.
  314.  
  315. Check Summ Disk
  316. ===============
  317.  
  318.        COMMAND     FLAGS
  319.  
  320.        SumDisk        Device [Unit]
  321.  
  322.    To fix Block CheckSumms on Disk or other device.
  323.  
  324. Menus in DMon
  325. *************
  326.  
  327. Open
  328. ====
  329.  
  330.    This will open an output channel.
  331.  
  332. Close
  333. =====
  334.  
  335.    This will Close an output channel.
  336.  
  337. Save
  338. ====
  339.  
  340.    This will close an output channel.
  341.  
  342. Exchange
  343. ========
  344.  
  345.    This will exchange between two output channels.
  346.  
  347. Help
  348. ====
  349.  
  350.    This will give quick description on commands available.
  351.  
  352. About
  353. =====
  354.  
  355.    This will display author info and online time.
  356.  
  357. Quit
  358. ====
  359.  
  360.    This will terminate DMon.
  361.  
  362. Instruction Bytes
  363. =================
  364.  
  365.    This will turn on or off instrcution bytes for the dissassembler.
  366.  
  367. DC.W Statements
  368. ===============
  369.  
  370.    This will turn on or off DC.W Statements for the dissassembler.
  371.  
  372. South of Heaven
  373. ===============
  374.  
  375.    With this the 'install' command can be forced to use standard OS2.0
  376. boot code rather than Sout of Heaven boot code. That is: turn all
  377. caches and burst mode on, switch from PAL to NTCS and vice versa with
  378. left or right mouse button, remove unwanted resident utilities, boot
  379. with a different color on diffrent machines for quick identification
  380. and turn off CLI window for OS2.0.
  381.  
  382. Arexx support
  383. *************
  384.  
  385.    DMon has a simple arexx port with which one can run arexx scripts
  386. and call direct arexx functions. To launch a Arexx program or statement
  387. simply enter "Say Here am I", "rx script" or simple "script". Both '
  388. and " should work.  the terminating ' or " is not needed but only
  389. conventional. Arexx scripts are not included for DMon.
  390.  
  391. Command Line
  392. ************
  393.  
  394.    DMon has a simple Command Line Interface. That is: one can enter any
  395. command and if DMon do not understand this command it will call
  396. dos.library to execute it. Results will be written to default output
  397. channel, normaly console window. Note that DMon will try to execute all
  398. commands in Supervisor Mode if posible.
  399.  
  400. Other Functions
  401. ***************
  402.  
  403.    DMon will always open its window in the left lower part of the
  404. display.  DMon will report on Guru Meditations if any occured. It will
  405. show full description with code, task address, task name and registers
  406. if available.
  407.  
  408. Author Info
  409. ***********
  410.  
  411.    Please send any bug report or enhancement request to
  412.  
  413.          Andreas Smigielski
  414.          Wiedweg 5
  415.          38120 Braunschweig
  416.          Germany
  417.      
  418.          INTERNET: wk039318@rzcipa01.rz.tu-bs.de
  419.  
  420.