home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / SXI-TK-D.LHA / tk / TK_DOCUMENTATION.TXT < prev    next >
Encoding:
Text File  |  1996-12-14  |  110.4 KB  |  3,315 lines
  1. Title: Thrill Kill - The documentation
  2.  
  3.  
  4. -----------------------------------------------------------------------------
  5. Thrill Kill - Documentation
  6. -----------------------------------------------------------------------------
  7.  
  8.    o Disclaimer
  9.    o Read first/Introduction
  10.    o Requirements
  11.    o General usage
  12.    o The preferences
  13.    o The editor
  14.    o Command description - alphabetically
  15.    o Command description - sorted by groups
  16.    o Argument description
  17.    o How to make a NMI-button
  18.    o Registration/Demo limits/How to order
  19.    o Yet known bugs
  20.    o History
  21.    o Contact
  22.    o Future
  23.  
  25. -----------------------------------------------------------------------------
  26.  
  27. Disclaimer
  28. -----------------------------------------------------------------------------
  29.  
  30. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  31. LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR
  32. OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND,
  33. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  34. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
  35. ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
  36. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  37. SERVICING, REPAIR OR CORRECTION.
  38.  
  39. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  40. ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM AS
  41. PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
  42. SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  43. INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
  44. DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR
  45. A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH
  46. HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  47.  
  48. -----------------------------------------------------------------------------
  49. Thrill Kill - Read first/Introduction
  50. -----------------------------------------------------------------------------
  51.  
  52. If you do not know what a debugger, freezer is or if you have never
  53. programmed in assembler - forget it - i do not think that TK is something for
  54. you -(except if you just want to train some games..)
  55.  
  56. You probaly know the famous action replay. It was cool! However it was slow,
  57. partly bugged and missed major commands. When aga came out there was no toy
  58. for those machines. No real update came out - the software version of the
  59. action replay was buggy like... . TK is a freezer like the action replay, a
  60. lot commands have the same syntax. If you were used to ar then you will find
  61. usage very easy. TK supports a maximum of freezer possibility, if you take
  62. the time to check out all available functions/settings. This means you have
  63. to have major knowledge of your amiga-hardware. If you do not have it then i
  64. doubt that you can use the real power of this toy! Of course, TK can not
  65. offer such kind of invisibility like the ar as it does not need a 'special'
  66. hardware (beside a NMI-button). If you enjoy the demo version, think its
  67. useful and do not want to register do not wait for a cracked version. Every
  68. registrated version of TK has its own personal id. Any misuse of a registered
  69. version will be punished (!!!).
  70.  
  71. Just a last note! TK patches nearly the whole system! It can not be
  72. compatible with any hardware configuration available (eg gfxcards..). I give
  73. no warranty for any damage caused by TK! You use it on your own risk!
  74.  
  75. BTW: The html-documentation is best viewed with NETSCAPE3.0, else read the
  76. text version!
  77.  
  78. Enough said...check out the demo..
  79.  
  80. -----------------------------------------------------------------------------
  81.  
  82. Thrill Kill - Requirements
  83. -----------------------------------------------------------------------------
  84.  
  85. TK was designed to run on a system with a mmu, but it also works on non-mmu
  86. system. I use tk on a A4000 with 68030/25/68882 (with mmu) and 2 meg chip and
  87. 8 meg fast memory. I personally think it works very stable. However even some
  88. A4000 have strange behaviour when acessing non existing memory. (eg Goldmans'
  89. machine: accessing memory higher $0fffffff will cause not a bus-error (set to
  90. dsack) but it kicks around with the custom-regs - they are defintly lost.) As
  91. you are a talented user you can change the settings to suit for your
  92. configuration (eg disable the memory detection for the $1dc00000++ memory)
  93. and load them before TK is initialized!
  94.  
  95. TK was tested on:
  96.  
  97.    o A4000/30.25.mmu/68882/2mb-chip/8mb-fast at $7800000++
  98.    o A4000/30.25.mmu/2mb-chip/16mb-fast at $7000000++
  99.    o A1200/30.50.mmu/2mb-chip/8mb-fast at $1dc00000++ (blizzard3, however
  100.      Icarus reported trouble with the blizzard2..i will check this )
  101.    o A1200/30.50.mmu/2mb-chip/4mb-fast at $200000++ (mtec)
  102.    o A500/00.7.nommu/1mb-chip/1.5mb-'fast' at $c00000
  103.    o A4000/40.25.mmu/2mb-chip/8mb-fast at $7800000++ (thanx to apollo for
  104.      lending me his card, i hope it stills runs on 040 as i patched a lot of
  105.      stuff since then)
  106.  
  107. I can not promise that TK will run immediatly on your system. However if you
  108. have problems contact me, i will try to fix any incompatibility! So if the
  109. demo-version runs on your computer then the registered version will also work
  110. fine.
  111.  
  112. Before i forget it you need kickstart 3.0++ to use all functions (especially
  113. the ones to privatize memory). It works also fine with kick 2.04 (some
  114. functions will not work), but i do not think it will run suitable on
  115. kickstarts less 2.04! TK does not like programms that use the mmu (like vmm
  116. programms) TK does not support gfx-cards!
  117.  
  118. I hope it will also run on a 68060...not checked yet (also i think it should
  119. if it works on 68040..)
  120.  
  121. -----------------------------------------------------------------------------
  122. Thrill Kill - General usage
  123. -----------------------------------------------------------------------------
  124.  
  125. Here is a list of some (maybe) interesting topics:
  126.  
  127.    o Breakpoints(=brp) can be manipulated by B, BS, BD, BDA. Breakpoints can
  128.      be marked with illegal or trap codes (see preferences). Whenever you
  129.      enter TK all breakpoints are removed, when you leave TK they are set
  130.      again. Do not forget that the breakpoints run via the +$10/$80..$bc
  131.      vectors.
  132.    o MemoryAccessRanges(=mar) can be used to get out which command did a
  133.      read/write access to the selected memory. The programm will be trace
  134.      step-by-step and the commands will be analyzed.It will return to TK
  135.      before the specified memory is accessed. MARs are very slow and will not
  136.      catch interrups. (If you want to catch interrupts than eg set a
  137.      breakpoint to the first command of the interrupt code..) Check
  138.      MAV,MAS,MAD,MADA.
  139.    o MemoryWatchPoints(=mwp) can be used to get out which command modified
  140.      the selected memory. The programm will be traced step-by-step to
  141.      determinate all manipulations. It will return to TK after the specified
  142.      memory has benn modfied. (so check the previous command) MWPs are slow
  143.      and will not catch interrupt routines. (If you want to catch interrupts
  144.      than eg set a breakpoint to the first command of the interrupt code..)
  145.      Check MV, MS, MD, MDA.
  146.    o The VBR-Faker installs a own vbr who simulates the origional. This will
  147.      allow you to enter programms who manipulate the vectors at $0 and do not
  148.      change the vbr. If the programm should change the vbr, loacte the
  149.      command, set a breakpoint and adjust the vbr manually, skip the command
  150.      and leave - all should be fine. (In AR4,HRTMON this is default, but not
  151.      in TK!) Do this also if the programm move the vbr anywhere else. (see
  152.      ;4mpreferences)
  153.    o MMU-Catchlists can be changed by MMUV, MMUS, MMUSW, MMUD, MMUDA and
  154.      check the preferences. The function allows you a quick and reliable way
  155.      to get out all commands which access a certain memory range. This slows
  156.      the system just a bit down. Interrupt code is also checked. Make sure
  157.      that the +$8 (bus-error) vector is not destroyed by the programm. The
  158.      functions are only available in to professional version and require a
  159.      MMU!
  160.    o The ByteValueTrainer(=bvt) allows to search single byte values. The
  161.      trainer is started with the TS command. Whenever the watched value
  162.      changes run the Tcommand.(also if you think this would eliminate some
  163.      address) This will eleminate all invalid address and scan yet not
  164.      checked address. You must increase the size of the trainer-buffer if you
  165.      would like to scan the whole memory in one pass. Check TS, T, TX, TV,
  166.      TB,TBD, TBV. Each stored address needs about 2 bytes.
  167.    o The DeepTrainer(=dt) allows you to search staying/changing byte values.
  168.      The trainer is started with the TDS command. Whenever the watched value
  169.      changes run the TDC command to eliminate all address which have not
  170.      changed. Use the TDS command to elimnate all address which have changed.
  171.      After TDS/TDS the yet unchecked memory is checked. Each stored address
  172.      needs about 3 bytes. This trainer mode needs a lot of memory. In general
  173.      its advised to use an external trainer buffer (TB, TBV, TBD) Check also
  174.      ;4mTDS, TDC, TDX, TDV
  175.    o The usage of a external TrainerBuffer is recommended whenever you want
  176.      to scan a memory range in a few passes, especially for the deep-trainer.
  177.      Its not unusual to have buffers with a size of 4MB or more..
  178.    o Privatizing is a preference option which allows you to remove memory
  179.      from the system. This memory can be used for trainer-buffer, to freeze
  180.      the programm or for other purpose. Check also INFO.
  181.    o MMU-CustomBackup is a option which simulates a mirror ram for
  182.      $dff000-$dff200. By this way we do not need an external hardware which
  183.      does exactly this. The only disadvantage is that the system is slowed
  184.      down and the +$8(bus-error) vector is used.
  185.    o Labels are just a little short-cut for often used address, etc. They can
  186.      be easily in any expression. Check LAB, DLAB ,DLABA.
  187.    o FileSystemManagement is supported for DD/HD-disks and also
  188.      IDE-harddisk-partitions. Only DOS\0, DOS\1, DOS\2, DOS\3 are supported.
  189.      However also DOS\4, DOS\5 can be read. Soft-/Hardlinks are not
  190.      supported. Check CD, DIR, DELETE, MAKEDIR, TYPE, LM, SM.
  191.    o The programm 'TK.REV' allows you to load TK to the end of the available
  192.      memory. This needs kickstart 3.0++. The effect is that TK will not lay
  193.      somewhere in the middle of a memory page (especiilly if you privatize
  194.      memory). Make sure 'TK.EXE' is in the same path.
  195.    o 'TK.EXE' will not do dynamic allocation of memory. This means you can
  196.      relocate the code eg to $7f00000 and load its binary image to this
  197.      address.
  198.  
  199. -----------------------------------------------------------------------------
  200. Thrill Kill - The preferences
  201.  
  202. -----------------------------------------------------------------------------
  203.  
  204. The preferences can be loaded and saved by the LE and SE commands
  205. In the TK-surface you have to press <F3> to enter the preference menu
  206. If you launch TK from shell and use as argument '-<your-prefs-file-any-path>'
  207. the selected prefs will be loaded before TK is started. This allows you to
  208. disable/enable functions which may cause conflicts.
  209. In the prefs-menu you can manipulate the following commands:
  210.  
  211.    o Freezer preferences:
  212.  
  213.       o Custom-backup:
  214.          o Minimum: Only custom-register that are destroyed by TK are
  215.            backuped and restored. This will work with games like soccer-kid.
  216.            (check out the copper faker)
  217.          o Maximum: Most custom-register are backuped and restored, including
  218.            register that are not destroyed by TK. This is necessary for
  219.            saving a complete programm. If you do not have a mmu/hadrware you
  220.            must adjust the register manually by the E command. If you want to
  221.            save a freezed programm the option should be enabled. Make sure
  222.            that you have enabled mmu-custom-backup or something equal.
  223.       o CIA-backup:
  224.          o Fast: The CIA-register are backuped in a fast way (eg the disksync
  225.            interrupt bit in the ICR will not be backuped)
  226.          o Most: This will try to backup most register. However, not all
  227.            register can be backuped without an immense time consumption (like
  228.            the ALARM regs). You can manully manipulate the CIA-register with
  229.            the W command.
  230.       o DrivesOn:
  231.          o Selected: When you enter TK and some disk-drives where on, only
  232.            drives selected in PRB/CIA-B will be enabled again.
  233.          o All: All drives will be turned on. (but not selected)
  234.       o Brp-Entrance:
  235.          o Illegal: Sets the breakpoint-code to illegal (dc.w $4afc) and
  236.            vector +$10. This may conflict with other running debuggers (eg
  237.            monam)
  238.          o Trap #x: Sets the breakpoint-code to trap#x (dc.w $4e4x) and
  239.            vector +$80+4*x. Make sure that the traps are not used be the
  240.            programm you debug.
  241.       o ExecValid:
  242.          o Yes: Make the asumption that system is running and exec,etc.. is
  243.            available. If system is not available this may cause major errors
  244.            (loops...etc). Set only if you want to use a system-command,you
  245.            know system is alive and TK thinks its not available.
  246.          o no: Make the asumption that system is not running. All
  247.            ;4msystem-command are not available.
  248.          o check: This will try to determinate if system is running or not.
  249.       o MemAccess:
  250.          o RAM: Your can read/write/access only the memory that was detected
  251.            by TK, check the INFO command.
  252.          o RAM+ROM: Your can read/write/access only memory that was detected
  253.            by TK plus the ROM-area.
  254.          o ALL: You can read/write/access the whole memory.Make sure you
  255.            access only memory that will not let your machine crash.
  256.       o VBRFaker:
  257.          o YES: This will exchange the freezed-programm-vbr with an own
  258.            vbr-simulator. This will allow you to enter programms which modify
  259.            the NMI-vector. However if you programm changes the vbr itself you
  260.            will not be able to enter TK again (in general). If you find such
  261.            a command set a breakpoint there, then adjust the vbr manually and
  262.            skip the command - works fine.
  263.          o NO: If the vbr-simulator was active it will be removed, else
  264.            nothing happens. (default)
  265.       o ROM-Avoid(NMI):
  266.          o YES: This disables entries via NMI if the freezed programm is
  267.            currently in a ROM memory.
  268.          o NO: You can enter TK via NMI at any time.
  269.       o TK-Memaccess:
  270.          o YES: This allows you to read/write/access the TK memory.
  271.          o NO: You can not read/write/acess the TK memory.
  272.  
  273.    o Editor preferences:
  274.       o Scrolling:
  275.          o BLITTER: The blitter will be used to scroll. If you want real-time
  276.            scrolling on 68000 then enable this option. The disadvantage is
  277.            that the blitter register will be destroyed! The blitter register
  278.            can be modified manually by the E command.
  279.          o CPU: The cpu will be used to scroll. This is faster than blitter
  280.            on 68020++. Also if you want to scroll in real-time on bigger
  281.            screen this option must be enabled.
  282.       o Insert-Mode:
  283.          o YES: If you hit a key the chars left from the current cursor
  284.            location will be shifted left before the new char is inserted. The
  285.            last char in the row is lost.
  286.          o NO: If you hit a key the char at the current cursor loaction is
  287.            replaced with the hit key. Use <TAB> to force a insert.
  288.       o Show-Page:
  289.          o If enabled and you jump to a new page, the page number will be
  290.            written to the right-top corner of the screen.
  291.       o Cursor-Type:
  292.          o LINE: The cursor will have the form of a line
  293.          o DOUBLE: The cursor will have the form of a thick line
  294.          o BLOCK: The cursor will have the form of a block
  295.       o Keyboard:
  296.          o GERMAN: The german keymap will be active.
  297.          o US: The us keymap will be active.
  298.       o BackGroundColor:
  299.          o The default background color of the TK-surface can be set in
  300.            12-bit-RGB format
  301.       o CharColor:
  302.          o The default char color of the TK-surface can be set in 12-bit-RGB
  303.            format
  304.       o CharColor2:
  305.          o The default char color for the MP command.
  306.       o WaitingColor:
  307.          o The default background color in hold-mode for the TK-surface can
  308.            be set in 12-bit-RGB format
  309.       o BlinkColor1:
  310.          o The first cursor color (alternating) of the TK-surface can be set
  311.            in 12-bit-RGB format
  312.       o BlinkColor2:
  313.          o The second cursor color (alternating) of the TK-surface can be set
  314.            in 12-bit-RGB format.
  315.       o BlinkTime:
  316.          o Amount of frames between alternating the cursor color (swap
  317.            between BlinkColor1 and BlinkColor2)
  318.       o KeyRepeatDelay:
  319.          o Amount of frames before a key is repeated
  320.       o KeyRepeatSpeed:
  321.          o Amount of frames between each key repeat
  322.  
  323.    o Screenmode preferences:
  324.       o Screenmode:
  325.          o NTSC: A NTSC screen (640x200,60Hz) will be used
  326.          o PAL: A PAL screen (640x256,50Hz) will be used
  327.          o CUSTOM: The register in the CUSTOM area will be used to set up
  328.            screen
  329.          o EURO72: A EURO72 screen (640x400,70Hz) will be used
  330.          o DBLPAL: A DBLPAL screen (640x512,50Hz) will be used
  331.          o CUSTOM2: The register in the CUSTOM2 area will be used to set up
  332.            screen
  333.       o ScreenBlank:
  334.          o If enabled and you use a aga-screen mode then the border-color
  335.            will be black, else the border has the same color as the
  336.            background
  337.       o If you know how to setup a screen by hardware then you can optimize
  338.         your screen. This is not described here, check out ecs/aga
  339.         documentation. NO WARRANTY FOR ANY DAMAGE!
  340.    o Reset preferences:
  341.       o Screenmode:
  342.          o PAL: The boot-picture will be shown on a PAL-screen
  343.          o NTSC: The boot -picture will be shown on a NTSC-screen
  344.       o MemorySequence:
  345.          o SKIP: No special operation is done.
  346.          o TEST: The detected memory is checked for any ram-failure.
  347.          o CLEAR: The detected memory is filled with the clear-pattern.
  348.          o TEST&CLEAR: The detected memory is checked and filled with the
  349.            clear-pattern.
  350.       o ClearPattern:
  351.          o The pattern used to fill memory. Usefull to find a suitable place
  352.            for patch-routines.
  353.       o External-BusTimeoutMode:
  354.          o IGNORE: If you have not a A4000 then this option should be
  355.            enabled.
  356.          o DSACK: If you access not-available memory on a A4000 usually a
  357.            bus-error is generated (and a long delay). With this option you
  358.            can set it to DSACK which results in no bus-errors and short
  359.            delays.
  360.          o BUSERR: This is the system-default TimeoutMode for the A4000
  361.       o KickStartPatch:
  362.          o This will enable all patches done when the kickstart is launched.
  363.            If this option is disabled all private-functions are disabled.
  364.       o ChipMemStart:
  365.          o Defines the location where the chip-memory starts (eg at
  366.            $100000-). Unused memory will be privatized.
  367.       o ChipMemEnd:
  368.          o Defines the location where the chip-memory ends. Unused memory
  369.            will be privatized.
  370.       o ExpansionMemoryX-Private:
  371.          o This option allows you to deactivate memory used by the system.
  372.            Unused memory will be privatized.
  373.       o ClearBreakpoints:
  374.          o All breakpoints will be cleared on reset.
  375.       o ClearMemoryWatchpoints:
  376.          o All memory-watchpoints will be cleared on reset.
  377.       o ClearMemoryAccessranges:
  378.          o All memory-accessranges will be clear on reset.
  379.       o DetectChipmem:
  380.          o Specifies the memory-range TK searches for chip-memory.
  381.       o DetectExpansionMemoryX:
  382.          o Specifies the memory-range TK searches for fast-memory. If your
  383.            memory is not detected by default then you can add your memory
  384.            manually. Also usefull if you get conflicts raised by illegal
  385.            memory accesses.
  386.  
  387.    o Misc preferences:
  388.       o AutoVerify:
  389.          o If enabled all disk-write operations will be verified.
  390.       o Support HD-disks:
  391.          o If enabled you can read/write high-density disks. This needs more
  392.            internal memory. Disable if you want eg a larger internal
  393.            trainer-buffer.
  394.       o Internal-TimeoutBusMode:
  395.          o IGNORE: If you have not a A4000 then this option should be
  396.            enabled.
  397.          o DSACK: This option should be enabled if you have a A4000, else the
  398.            memory detection will hang up your system.
  399.          o BUSERR: This is the system-default TimeoutMode for the A4000
  400.       o HighestTrack:
  401.          o Here you can overwrite the upper tracklimit, so that you can also
  402.            read/write tracks 80-85.
  403.            NO WARRARNTY FOR ANY DAMAGE CAUSED BY TK!!
  404.       o Add EjectTask:
  405.          o Add a Eject-Task to system which will do a automatic 'diskchange'
  406.            to any media modified in TK.
  407.       o CustomFrom:
  408.          o USER: The user has to adjust the custom-register before he leaves
  409.            TK.
  410.          o SYSTEM: Some destroyed custom-register are read from system. Only
  411.            possible if system is intact.
  412.          o HARDWARE: If you have hardware installed it will be used to
  413.            restore the custom-register.
  414.          o MMU: The MMU will be used to restore the custom-register. Make
  415.            sure the PrivateMMU option is enabled
  416.       o CustomMMU-Flicker:
  417.          o If enabled, the freezed programm will do a little flicker whenever
  418.            a write operation to a custom register is done.
  419.       o Default Valuemode:
  420.          o HEX: The default value base is 16. Like in the action-replay
  421.          o DEC: The default value base is 10. Like in asm-one.
  422.       o ParseCpuReg:
  423.          o TRY: The parser tries to match a valid cpu-register in every
  424.            expression. (eg 'd d0' will not disassemble at $d0)
  425.          o SLASH: If you want to use cpu-register in expressions just by a
  426.            leading '\' you have to enable this.
  427.       o ParsePriority:
  428.          o OPERATOR: Each operator has a specific priority, which is used to
  429.            calculate a expression. (eg '2+3*4'='14')
  430.          o LEFT-ASSIGNED: The 'left' operator has always a greater priority.
  431.            (eg '2+3*4'='24')
  432.       o CatchCustomBootBlock:
  433.          o Whenever the system tries to boot from a non-default
  434.            disk-bootblock it will enter TK before execution. The pc will
  435.            point to the first command of the bootblock.
  436.       o PrivateMMU:
  437.          o If enabled a own mmu-pagetable is set up. Must be enabled to use
  438.            the CustomMMU function. Do no enable if you run a VMM programm.
  439.       o ALT-FX:
  440.          o Here you can define the fast-macros. Multiple command are
  441.            possible.
  442.  
  443. -----------------------------------------------------------------------------
  444.  
  445. Thrill Kill - The editor
  446. -----------------------------------------------------------------------------
  447.  
  448. The basic surface for TK is the so called editor. Its like a system-shell
  449. with special commands and functions. The keyboard type can be changed by the
  450. preferences. Beside the usual keys the following functions are
  451. available:
  452.  
  453.    o <F1> : Clear screen
  454.    o <F2> : Toogle Insert-/Overwritemode
  455.    o <F3> : Enter preferences
  456.    o <F4> : Repeat last command
  457.    o <F5> : Enter 'debugger'
  458.    o <F6> : Jump to page 1
  459.    o <F7> : Jump to page 2
  460.    o <F8> : Jump to page 3
  461.    o <F9> : Jump to page 4
  462.    o <F10> : Jump to page 5
  463.    o <SHIFT>+<F6> : Copy actual page to page 1
  464.    o <SHIFT>+<F7> : Copy actual page to page 2
  465.    o <SHIFT>+<F8> : Copy actual page to page 3
  466.    o <SHIFT>+<F9> : Copy actual page to page 4
  467.    o <SHIFT>+<F10> : Copy actual page to page 5
  468.    o <ALT>+<FX> : Execute fast macro x, (macros can be modified in in the
  469.      ;4mpreferences)
  470.    o <AMIGA>+<F5> : Make snapshot and save it
  471.    o <ESC> : Abort/Cancel current running commands (if supported)
  472.    o <TAB> : Insert space at current position
  473.    o <HELP> : Show internal help
  474.    o <SHIFT> : Hold/Pause current command (if supported)
  475.    o <AMIGA>+<SHIFT>+<ESC> : Emergency exit!! This command allows you to
  476.      leave TK any any time. This can be useful to return when a command
  477.      (should) hang up. BE WARNED! You can abort the write-commands, too, this
  478.      can cause major damage to your harddisk etc..
  479.  
  480. Some commands support 'fast signs'. This means that if you scroll up/down and
  481. in the top/bottom line is a 'fast sign' the programm will automatically
  482. generate the previous/next line. Eg. you can easily disassemblel
  483. up/down.(check out)
  484. -----------------------------------------------------------------------------
  485. Thrill Kill - Command description  
  486. -----------------------------------------------------------------------------
  487.  
  488. Command index - alphabetically
  489.  
  490.    o ? <Value>
  491.    o A <Address>
  492.    o ADD <Bytes>,<Start> <End>
  493.    o AND <Bytes>,<Start> <End>
  494.    o AVAIL
  495.    o B
  496.    o BOOTCHK <Address>
  497.    o BD <Address>
  498.    o BD #<BreakpointNumber>
  499.    o BDA
  500.    o BITCHK <Address>
  501.    o BLKCHK <Address>
  502.    o BS [#<BreakpointNumber>] <Address>
  503.    o BT #<TrapNumber>
  504.    o BTI
  505.    o CATCHFILE <StringPattern>
  506.    o CD [Path]
  507.    o COMP <Start> <End> <Destination>
  508.    o D [#<Mode>]<Address>
  509.    o DELETE <Filename>
  510.    o DEVS
  511.    o DEVICES
  512.    o DIR [Path]
  513.    o DISKLEN [#Unit] [LOW <Track>] [HIGH <Track>]
  514.    o DLAB <Labelname>
  515.    o DLABA
  516.    o E[<CUSTOM-REG>]
  517.    o EOR <Bytes>,<Start> <End>
  518.    o F <Bytes> [,Range]
  519.    o FA <Address> [,Range]
  520.    o FAQ <Address> [,Range]
  521.    o FAR <Start> <End> [,Range]
  522.    o FARQ <Start> <End> [,Range]
  523.    o FC [Range]
  524.    o FCQ [Range]
  525.    o FD <DisassemblyPattern> [,Range]
  526.    o FDQ <DisassemblyPattern> [,Range]M[.<B|W|L] [#<Entries per row>]
  527.      ;4m<Address>
  528.    o FP <PBytes> [,Range]
  529.    o FR <Bytes> [,Range]
  530.    o FS <Bytes> [,Range]
  531.    o G <Address>
  532.    o GETKEY
  533.    o HELP
  534.    o INFO
  535.    o INTS
  536.    o INTERRUPTS
  537.    o LA <Address>
  538.    o LAB <Labelname>=<Value>
  539.    o LABS
  540.    o LABELS
  541.    o LE <Filename>
  542.    o LESS <Filename>
  543.    o LIBS
  544.    o LIBRARIES
  545.    o LM <Filename>,<Start> [<End>]
  546.    o LS [Path]
  547.    o M[.<B|W|L] [#<Entries per row>] <Address>
  548.    o MA
  549.    o MAD <Start> <End>
  550.    o MADA
  551.    o MAKEDIR <Path>
  552.    o MAS <Start> <End>
  553.    o MD <Address>
  554.    o MDA
  555.    o MEM
  556.    o MFMC <Start> <End> <Destination>
  557.    o MFMD <Start> <End> <Destination>
  558.    o MFMR [#<Unit>] [INDEX] [SYNC=<SYNC>] <Track> <DMA-Length> <Destination>
  559.    o MFMSL <Start> <End> <Destination> <BitShift>
  560.    o MFMSR <Start> <End> <Destination> <BitShift>
  561.    o MFMSS <Start> <End> <Destination> <Sync>
  562.    o MFMW [#<Unit>] [INDEX] <Track> <DMA-Length> <Source>
  563.    o MKDIR <Path>
  564.    o MMUD <Start> <End>
  565.    o MMUDA
  566.    o MMUS <Start> <End>
  567.    o MMUSW <Start> <End>
  568.    o MMUV
  569.    o MORE <Filename>
  570.    o MP
  571.    o MS [.<B|W|L] <Address>
  572.    o MV
  573.    o N [#<Entries per row>] <Address>
  574.    o NO <Offset>
  575.    o O <Bytes>,<Start> <End>
  576.    o OR <Bytes>,<Start> <End>
  577.    o PORTS
  578.    o Q <Start> <End> <Destination>
  579.    o R [<CPU-REG> <Value>]
  580.    o RB <Filename>,<Start> [<End>]
  581.    o RD [#<Unit>] <DiskOffset> <Length> <Destination>
  582.    o RESET
  583.    o RES
  584.    o RESOURCES
  585.    o RF [<FPU-REG> <Value>]
  586.    o RM [<MMU-REG> <Value>]
  587.    o RS [#<Unit>] <Sector> <SectorAmount> <Destination>
  588.    o RT [#<Unit>] <Track> <TrackAmount> <Destination>
  589.    o SA <Start> [<End>]
  590.    o SE <Filename>
  591.    o SETX
  592.    o SETEXCEPTIONS
  593.    o SHOWSTACKFRAME
  594.    o SI [<Count>]
  595.    o SIM <Rawkey>
  596.    o SM <Filename>,<Start> <End>
  597.    o ST [<Count>]
  598.    o T <Value>
  599.    o TASKS
  600.    o TB <Start> <End>
  601.    o TBD
  602.    o TBV
  603.    o TDC
  604.    o TDS [Range]
  605.    o TDV
  606.    o TDX
  607.    o TR [<Count>]
  608.    o TRACKER [<START>]
  609.    o TRANS <Start> <End> <Destination>
  610.    o TS <Value> [,Range]
  611.    o TV
  612.    o TX
  613.    o TYPE <Filename>
  614.    o USEBLIT
  615.    o USECPU
  616.    o VERSION
  617.    o W [<CIA-REG>]
  618.    o WB <Filename>,<Start> <End>
  619.    o WD [#<Unit>] <DiskOffset> <Length> <Source>
  620.    o WN [<Count>]
  621.    o WPC <Address>
  622.    o WS [#<Unit>] <Sector> <SectorAmount> <Source>
  623.    o WT [#<Unit>] <Track> <TrackAmount> <Source>
  624.    o X
  625.    o Y [#<Entries per row>] <Address>
  626.  
  627. -----------------------------------------------------------------------------
  628.  
  629. Command index - sorted by command groups
  630.  
  631.    o Commands for manipulation 
  632.    o Commands for searching data
  633.    o Commands for manipulating breakpoints
  634.    o Commands for 'Trace' actions
  635.    o Commands for MMU manipulation
  636.    o Commands for 'Training' actions
  637.    o Commands for io-access
  638.    o Commands for diskio-access only
  639.    o Commands for mfm manipulation
  640.    o Commands for misc usage
  641.    o Commands for sys usage
  642.  
  643. -----------------------------------------------------------------------------
  644. Commands for manipulation 
  645.  
  646.    o A <Address>
  647.    o ADD <Bytes>,<Start> <End>
  648.    o AND <Bytes>,<Start> <End>
  649.    o CATCHFILE <StringPattern>
  650.    o COMP <Start> <End> <Destination>
  651.    o D [#<Mode>]<Address>
  652.    o E[<CUSTOM-REG>]
  653.    o EOR <Bytes>,<Start> <End>
  654.    o G <Address>
  655.    o M[.<B|W|L] [#<Entries per row>] <Address>
  656.    o N [#<Entries per row>] <Address>
  657.    o NO <Offset>
  658.    o LA <Address>
  659.    o O <Bytes>,<Start> <End>
  660.    o OR <Bytes>,<Start> <End>
  661.    o Q <Start> <End> <Destination>
  662.    o R [<CPU-REG> <Value>]
  663.    o RF [<FPU-REG> <Value>]
  664.    o RM [<MMU-REG> <Value>]
  665.    o SA <Start> [<End>]
  666.    o SETEXCEPTIONS
  667.    o SETX
  668.    o SIM <Rawkey>
  669.    o TRANS <Start> <End> <Destination>
  670.    o W [<CIA-REG>]
  671.    o X
  672.    o Y [#<Entries per row>] <Address>
  673.  
  674. Commands for searching data
  675.  
  676.    o F <Bytes> [,Range]
  677.    o FA <Address> [,Range]
  678.    o FAQ <Address> [,Range]
  679.    o FAR <Start> <End> [,Range]
  680.    o FARQ <Start> <End> [,Range]
  681.    o FC [Range]
  682.    o FCQ [Range]
  683.    o FD <DisassemblyPattern> [,Range]
  684.    o FDQ <DisassemblyPattern> [,Range]
  685.    o FP <PBytes> [,Range]
  686.    o FR <Bytes> [,Range]
  687.    o FS <Bytes> [,Range]
  688.  
  689. Commands for manipulating breakpoints
  690.  
  691.    o B
  692.    o BD <Address>
  693.    o BD #<BreakpointNumber>
  694.    o BDA
  695.    o BT #<TrapNumber>
  696.    o BTI
  697.    o BS [#<BreakpointNumber>] <Address>
  698.  
  699. Commands for 'Trace' actions
  700.  
  701.    o MA
  702.    o MAD <Start> <End>
  703.    o MADA
  704.    o MAS <Start> <End>
  705.    o MD <Address>
  706.    o MDA
  707.    o MS [.<B|W|L] <Address>
  708.    o MV
  709.    o SI [<Count>]
  710.    o ST [<Count>]
  711.    o TR [<Count>]
  712.    o WN [<Count>]
  713.    o WPC <Address>
  714.  
  715. Commands for MMU manipulation
  716.  
  717.    o MMUD <Start> <End>
  718.    o MMUDA
  719.    o MMUS <Start> <End>
  720.    o MMUSW <Start> <End>
  721.    o MMUV
  722.    o RM [<MMU-REG> <Value>]
  723.  
  724. Commands for 'Training' actions
  725.  
  726.    o T <Value>
  727.    o TB <Start> <End>
  728.    o TBD
  729.    o TBV
  730.    o TDC
  731.    o TDS [Range]
  732.    o TDV
  733.    o TDX
  734.    o TS <Value> [,Range]
  735.    o TV
  736.    o TX
  737.  
  738. Commands for io-access
  739.  
  740.    o CD [Path]
  741.    o DELETE <Filename>
  742.    o DIR [Path]
  743.    o LESS <Filename>
  744.    o LM <Filename>,<Start> [<End>]
  745.    o LS [Path]
  746.    o MAKEDIR <Path>
  747.    o MORE <Filename>
  748.    o RB <Filename>,<Start> [<End>]
  749.    o SM <Filename>,<Start> <End>
  750.    o TYPE <Filename>
  751.    o WB <Filename>,<Start> <End>
  752.  
  753. Commands for diskio-access only
  754.  
  755.    o BITCHK <Address>
  756.    o BLKCHK <Address>
  757.    o BOOTCHK <Address>
  758.    o RD [#<Unit>] <DiskOffset> <Length> <Destination>
  759.    o RS [#<Unit>] <Sector> <SectorAmount> <Destination>
  760.    o RT [#<Unit>] <Track> <TrackAmount> <Destination>
  761.    o WD [#<Unit>] <DiskOffset> <Length> <Source>
  762.    o WS [#<Unit>] <Sector> <SectorAmount> <Source>
  763.    o WT [#<Unit>] <Track> <TrackAmount> <Source>
  764.  
  765. Commands for mfm manipulation
  766.  
  767.    o DISKLEN [#Unit] [LOW <Track>] [HIGH <Track>]
  768.    o MFMR [#<Unit>] [INDEX] [SYNC=<SYNC>] <Track> <DMA-Length> <Destination>
  769.    o MFMW [#<Unit>] [INDEX] <Track> <DMA-Length> <Source>
  770.    o MFMC <Start> <End> <Destination>
  771.    o MFMD <Start> <End> <Destination>
  772.    o MFMSL <Start> <End> <Destination> <BitShift>
  773.    o MFMSR <Start> <End> <Destination> <BitShift>
  774.    o MFMSS <Start> <End> <Destination> <Sync>
  775.  
  776. Commands for misc usage
  777.  
  778.    o ? <Value>
  779.    o DLAB <Labelname>
  780.    o DLABA
  781.    o GETKEY
  782.    o HELP
  783.    o INFO
  784.    o LAB <Labelname>=<Value>
  785.    o LABS
  786.    o LABELS
  787.    o LE <Filename>
  788.    o MP
  789.    o RESET
  790.    o SE <Filename>
  791.    o SHOWSTACKFRAME
  792.    o TRACKER [<START>]
  793.    o USEBLIT
  794.    o USECPU
  795.    o VERSION
  796.  
  797. Commands for system usage
  798.  
  799.    o AVAIL
  800.    o DEVS
  801.    o DEVICES
  802.    o INTS
  803.    o INTERRUPTS
  804.    o MEM
  805.    o LIBS
  806.    o LIBRARIES
  807.    o PORTS
  808.    o RES
  809.    o RESOURCES
  810.    o TASKS
  811.  
  812. -----------------------------------------------------------------------------
  813.  
  814. Commands description - no order
  815.  
  816. -----------------------------------------------------------------------------
  817.  
  818. Syntax:
  819.  
  820.      ? <Value>
  821.  
  822. Description:
  823.  
  824.      Print value <Value> in differnt bases. This function can be used as a
  825.      simple calculator.
  826.  
  827. Example:
  828.  
  829.       o ? (!123*345%4|234)<<3
  830.  
  831. -----------------------------------------------------------------------------
  832.  
  833. Syntax:
  834.  
  835.      A <Address>
  836.  
  837. Description:
  838.  
  839.      Start assembly at <Address>. The command uses the dis/assembler
  840.      specified with the D command.
  841.  
  842. Example:
  843.  
  844.       o a 100000
  845.         ^$00100000 movec vbr,d0
  846.         ^$00100004 btst #6,$bfe001
  847.         ^$0010000c bne 100004
  848.  
  849. -----------------------------------------------------------------------------
  850.  
  851. Syntax:
  852.  
  853.      ADD <Bytes>,<Start> <End>
  854.  
  855. Description:
  856.  
  857.      Add given pattern <Bytes> bytewise to memory from <Start> to <End>.
  858.  
  859. Example:
  860.  
  861.       o add "Mok",80000 90000
  862.  
  863. -----------------------------------------------------------------------------
  864.  
  865. Syntax:
  866.  
  867.      AND <Bytes>,<Start> <End>
  868.  
  869. Description:
  870.  
  871.      And given pattern <Bytes> bytewise to memory from <Start> to <End>.
  872.  
  873. Example:
  874.  
  875.       o and "Samir",80000 90000
  876.  
  877. -----------------------------------------------------------------------------
  878.  
  879. Syntax:
  880.  
  881.      AVAIL
  882.  
  883.      MEM
  884.  
  885. Description:
  886.  
  887.      Lists all currently available memory nodes and total memory usage.
  888.  
  889. Example:
  890.  
  891.       o avail
  892.  
  893. -----------------------------------------------------------------------------
  894. Syntax:
  895.  
  896.      B
  897.  
  898. Description:
  899.  
  900.      Display all current breakpoints and breakpoint method.
  901.  
  902. Example:
  903.  
  904.       o b
  905.  
  906. -----------------------------------------------------------------------------
  907.  
  908. Syntax:
  909.  
  910.      BD #<BreakpointNumber>
  911.  
  912.      BD <Address>
  913.  
  914. Description:
  915.  
  916.      Either delete breakpoint at <Address> or breakpoint with specified
  917.      <BreakpointNumber>. The value of <BreakpointNumber> must be one of
  918.      [0..31[.
  919.  
  920. Example:
  921.  
  922.       o bd pc
  923.       o bd 80000
  924.       o bd #!31
  925.  
  926. -----------------------------------------------------------------------------
  927.  
  928. Syntax:
  929.  
  930.      BDA
  931.  
  932. Description:
  933.  
  934.      Delete all breakpoints.
  935.  
  936. Example:
  937.  
  938.       o bda
  939.  
  940. -----------------------------------------------------------------------------
  941.  
  942. Syntax:
  943.  
  944.      BITCHK <Address>
  945.  
  946. Description:
  947.  
  948.      Correct bitmapblock-checksum for bitmapblock at <Address>.
  949.  
  950. Example:
  951.  
  952.       o bitchk 10000
  953.  
  954. -----------------------------------------------------------------------------
  955.  
  956. Syntax:
  957.  
  958.      BLKCHK <Address>
  959.  
  960. Description:
  961.  
  962.      Correct datablock-checksum for datablock at <Address>.
  963.  
  964. Example:
  965.  
  966.       o blkchk 10000
  967.  
  968. -----------------------------------------------------------------------------
  969.  
  970. Syntax:
  971.  
  972.      BOOTCHK <Address>
  973.  
  974. Description:
  975.  
  976.      Correct bootblock-checksum for bootblock at <Address>.
  977.  
  978. Example:
  979.  
  980.       o bootchk 10000
  981.  
  982. -----------------------------------------------------------------------------
  983.  
  984. Syntax:
  985.  
  986.      BS [#<BreakpointNumber>] <Address>
  987.  
  988. Description:
  989.  
  990.      Set breakpoint at <Address>. If <BreapointNumber> is not given the next
  991.      free breakpoint is used. The value of <BreakpointNumber> must be one of
  992.      [0..31[.
  993.  
  994. Example:
  995.  
  996.       o bs 80000
  997.       o bs #!31 80000
  998.  
  999. -----------------------------------------------------------------------------
  1000.  
  1001. Syntax:
  1002.  
  1003.      BT #<TrapNumber>
  1004.  
  1005. Description:
  1006.  
  1007.      Set breakpoint method to 'trap #<TrapNumber>' (dc.w $4e4<TrapNumber>).
  1008.      The value of <Trapnumber> must be one of [0..15[.
  1009.  
  1010. Example:
  1011.  
  1012.       o bt #f
  1013.  
  1014. -----------------------------------------------------------------------------
  1015.  
  1016. Syntax:
  1017.  
  1018.      BTI
  1019.  
  1020. Description:
  1021.  
  1022.      Set breakpoint method to 'illegal' (dc.w $4afc) opcode.
  1023.  
  1024. Example:
  1025.  
  1026.       o bti
  1027.  
  1028. -----------------------------------------------------------------------------
  1029.  
  1030. Syntax:
  1031.  
  1032.      CATCHFILE <StringPattern>
  1033.  
  1034. Description:
  1035.  
  1036.      The function will patch the current LoadSeg() function from the the
  1037.      dos-library. If the system now tries to load a executable with the
  1038.      specified pattern/name TK will return before the executable is started.
  1039.      The patch is removed and the pc will point to the first instruction of
  1040.      the executable.
  1041.  
  1042. Example:
  1043.  
  1044.       o catchfile *tk.exe ; this will catch all executables, including eg
  1045.         'C:tk.exe'
  1046.       o catchfile tk.exe ; this will not catch eg 'C:tk.exe' !!
  1047.  
  1048. -----------------------------------------------------------------------------
  1049.  
  1050. Syntax:
  1051.  
  1052.      CD [Path]
  1053.  
  1054. Description:
  1055.  
  1056.      The command will try to set the current-directory to given path. If
  1057.      [Path] is not given it will just show the current path.
  1058.  
  1059. Example:
  1060.  
  1061.       o cd
  1062.       o cd hd1:tk/
  1063.  
  1064. -----------------------------------------------------------------------------
  1065.  
  1066. Syntax:
  1067.  
  1068.      D [#<Mode>]<Address>
  1069.  
  1070. Description:
  1071.  
  1072.      Disassembly memory at <Address>. If address is zero the current pc is
  1073.      used. (like in the AR). The <Mode> argument allows you to use different
  1074.      dis- and assembler; default mode is zero.
  1075.  
  1076.       o 0 : usual 680x0 dis/assembler
  1077.       o 1 : RNC mode 1 (old)
  1078.       o 2 : RNC mode 2
  1079.  
  1080. Example:
  1081.  
  1082.       o d f800d2
  1083.  
  1084. -----------------------------------------------------------------------------
  1085.  
  1086. Syntax:
  1087.  
  1088.      DELETE <Filename>
  1089.  
  1090. Description:
  1091.  
  1092.      Delete file <Filename>.
  1093.  
  1094. Example:
  1095.  
  1096.       o delete "hd1:tk/tk.exe"
  1097.  
  1098. -----------------------------------------------------------------------------
  1099.  
  1100. Syntax:
  1101.  
  1102.      DEVS
  1103.  
  1104.      DEVICES
  1105.  
  1106. Description:
  1107.  
  1108.      Lists all currently available devices.
  1109.  
  1110. Example:
  1111.  
  1112.       o devs
  1113.  
  1114. -----------------------------------------------------------------------------
  1115.  
  1116. Syntax:
  1117.  
  1118.      DIR [Path]
  1119.  
  1120.      LS [Path]
  1121.  
  1122. Description:
  1123.  
  1124.      The command will display the directory for given [Path]. If [Path] is
  1125.      not given it will use the current path.
  1126.  
  1127. Example:
  1128.  
  1129.       o dir hd1:tk/
  1130.  
  1131. -----------------------------------------------------------------------------
  1132.  
  1133. Syntax:
  1134.  
  1135.      DISKLEN [#<Unit>] [LOW <Track>] [HIGH <Track>]
  1136.  
  1137. Description:
  1138.  
  1139.      The function will determinate the disk-speed. Note that the data on the
  1140.      disk is lost (so use a empty one).
  1141.  
  1142. Example:
  1143.  
  1144.       o disklen
  1145.  
  1146. -----------------------------------------------------------------------------
  1147.  
  1148. Syntax:
  1149.  
  1150.      DLAB <Labelname>
  1151.  
  1152. Description:
  1153.  
  1154.      Delete label <Labelname>.
  1155.  
  1156. Example:
  1157.  
  1158.       o dlab mfmload
  1159.  
  1160. -----------------------------------------------------------------------------
  1161.  
  1162. Syntax:
  1163.  
  1164.      DLABA
  1165.  
  1166. Description:
  1167.  
  1168.      Delete all labels.
  1169.  
  1170. Example:
  1171.  
  1172.       o dlaba
  1173.  
  1174. -----------------------------------------------------------------------------
  1175.  
  1176. Syntax:
  1177.  
  1178.      E [<CUSTOM-REG>]
  1179.  
  1180. Description:
  1181.  
  1182.      If no paramter is specified it will show the first CUSTOM register. The
  1183.      output can be edited (hit return to accept new values). The following
  1184.      flags exist:
  1185.  
  1186.       o 'R': a read only register; just for information; no change possible
  1187.       o '-': reg has not been touched by TK; its kept at its original value;
  1188.         can be changed to '*'
  1189.       o '*': reg has been backuped correctly and will be written back
  1190.       o '?': reg has not been fully backuped but will be written back.
  1191.         (probably the reg was used by TK, too) It may be necessary to adjust
  1192.         it manually! (eg set $1dc to $20/$1bb8 for a PAL/MULTISCAN screen)
  1193.  
  1194. Example:
  1195.  
  1196.       o e 1dc ; show/edit beamcon0
  1197.  
  1198. -----------------------------------------------------------------------------
  1199.  
  1200. Syntax:
  1201.  
  1202.      EOR <Bytes>,<Start> <End>
  1203.  
  1204. Description:
  1205.  
  1206.      Eor bytewise memory from <Start> to <End> with given pattern <Bytes>.
  1207.  
  1208. Example:
  1209.  
  1210.       o eor "Mok",80000 90000
  1211.  
  1212. -----------------------------------------------------------------------------
  1213.  
  1214. Syntax:
  1215.  
  1216.      F <Bytes> [,Range]
  1217.  
  1218. Description:
  1219.  
  1220.      Find all locations in [Range] where <Bytes> occures.
  1221.  
  1222. Example:
  1223.  
  1224.       o f 4e 7b 00 f8 00 00
  1225.       o f "Hello" ; will find 'Hello' but not 'HELLO','hello'
  1226.  
  1227. -----------------------------------------------------------------------------
  1228.  
  1229. Syntax:
  1230.  
  1231.      FA <Address> [,Range]
  1232.  
  1233.      FAQ <Address> [,Range]
  1234.  
  1235. Description:
  1236.  
  1237.      Find all commands in [Range] which refer to <Address>. This code is
  1238.      analyzed and all commands accessing <Address> are reported. Note that
  1239.      the current registers are used for scanning. If quick mode is used then
  1240.      the range-pointer is always increased by the command-size instead of 2.
  1241.      This means that you may loose valid locations.
  1242.  
  1243. Example:
  1244.  
  1245.       o fa f800d2
  1246.  
  1247. -----------------------------------------------------------------------------
  1248.  
  1249. Syntax:
  1250.  
  1251.      FAR <Start> <End> [,Range]
  1252.  
  1253.      FARQ <Start> <End> [,Range]
  1254.  
  1255. Description:
  1256.  
  1257.      Find all commands in [Range] which refer to memory from <Start> to
  1258.      <End>. This code is analyzed and all commands accessing specified memory
  1259.      are reported. Note that the current registers are used for scanning,
  1260.      too. If quick mode is used then the range-pointer is always increased by
  1261.      the command-size instead of 2. This means that you may loose valid
  1262.      locations.
  1263.  
  1264. Example:
  1265.  
  1266.       o far dff09a dff09c,f80000 f90000
  1267.  
  1268. -----------------------------------------------------------------------------
  1269.  
  1270. Syntax:
  1271.  
  1272.      FC [Range]
  1273.  
  1274.      FCQ [Range]
  1275.  
  1276. Description:
  1277.  
  1278.      Find all commands in [Range] which match to the internal library.
  1279.  
  1280. Example:
  1281.  
  1282.       o fcq
  1283.  
  1284. -----------------------------------------------------------------------------
  1285.  
  1286. Syntax:
  1287.  
  1288.      FD <DisassemblyPattern> [,Range]
  1289.  
  1290.      FDQ <DisassemblyPattern> [,Range]
  1291.  
  1292. Description:
  1293.  
  1294.      Find all commands in [Range] which match to given pattern. The output of
  1295.      the disassmbler is check for given pattern. Note that you can also
  1296.      search for multiple commands. If quick mode is used then the
  1297.      range-pointer is always increased by the command-size instead of 2. This
  1298.      means that you may loose valid locations.
  1299.  
  1300. Example:
  1301.  
  1302.       o fdq "\move.l $*,(a?)\\tst.l #?"
  1303.  
  1304. -----------------------------------------------------------------------------
  1305.  
  1306. Syntax:
  1307.  
  1308.      FP <PBytes> [,Range]
  1309.  
  1310. Description:
  1311.  
  1312.      Find all locations in [Range] where pattern <PBytes> occures.
  1313.  
  1314. Example:
  1315.  
  1316.       o fp 4e ?? 00 ?8 00 0? ; will find eg $4e $4e $00 $f8 $00 $0f
  1317.  
  1318. -----------------------------------------------------------------------------
  1319.  
  1320. Syntax:
  1321.  
  1322.      FR <Bytes> [,Range]
  1323.  
  1324. Description:
  1325.  
  1326.      Find all locations in [Range] where relative <Bytes> occures. This means
  1327.      that only a 'differnce-pattern' is searched. The given offset can be
  1328.      used for the NO command.
  1329.  
  1330. Example:
  1331.  
  1332.       o f r "Hello" ; will find eg 'Hello','Ifmmp',..
  1333.  
  1334. -----------------------------------------------------------------------------
  1335.  
  1336. Syntax:
  1337.  
  1338.      FS <Bytes> [,Range]
  1339.  
  1340. Description:
  1341.  
  1342.      Find all locations in [Range] where uppercased <Bytes> occures. This
  1343.      means that eg 'f' and 'F' is treated as same.
  1344.  
  1345. Example:
  1346.  
  1347.       o fs "HeLLo" 0,80000 90000 ; will find eg 'HELLO','hello'
  1348.  
  1349. -----------------------------------------------------------------------------
  1350.  
  1351. Syntax:
  1352.  
  1353.      G <Address>
  1354.  
  1355. Description:
  1356.  
  1357.      Exit freezer programm and continue the freezed programm at <Address>.
  1358.  
  1359. Example:
  1360.  
  1361.       o r sr 2700
  1362.       o g f800d2
  1363.  
  1364. -----------------------------------------------------------------------------
  1365.  
  1366. Syntax:
  1367.  
  1368.      GETKEY
  1369.  
  1370. Description:
  1371.  
  1372.      The function will output the rawkey-code of every pressed key. (No need
  1373.      to look into a book)
  1374.  
  1375. Example:
  1376.  
  1377.       o getkey
  1378.  
  1379. -----------------------------------------------------------------------------
  1380.  
  1381. Syntax:
  1382.  
  1383.      HELP
  1384.  
  1385. Description:
  1386.  
  1387.      Show help-page. Press the <Help> key for the same effect.
  1388.  
  1389. Example:
  1390.  
  1391.       o help
  1392.  
  1393. -----------------------------------------------------------------------------
  1394.  
  1395. Syntax:
  1396.  
  1397.      INFO
  1398.  
  1399. Description:
  1400.  
  1401.      Show global system-information like available mem, privatized mem, cpu,
  1402.      fpu, mmu, current trackpos of drives, head pos, available devices, to be
  1403.      ejected devices and much more (check out).
  1404.  
  1405. Example:
  1406.  
  1407.       o info
  1408.  
  1409. -----------------------------------------------------------------------------
  1410. Syntax:
  1411.  
  1412.      INTS
  1413.  
  1414.      INTERRUPTS
  1415.  
  1416. Description:
  1417.  
  1418.      Lists all currently available interrupts. The first value is a pointer
  1419.      to the interrupt node and the second one is a pointer to the interrupt
  1420.      code.
  1421.  
  1422. Example:
  1423.  
  1424.       o ints
  1425.  
  1426. -----------------------------------------------------------------------------
  1427.  
  1428. Syntax:
  1429.  
  1430.      LA <Address>
  1431.  
  1432. Description:
  1433.  
  1434.      Load frozen programm-data from memory at <Address>. A programm can be
  1435.      saved using the SA command.
  1436.  
  1437. Example:
  1438.  
  1439.       o la 7c00000
  1440.  
  1441. -----------------------------------------------------------------------------
  1442.  
  1443. Syntax:
  1444.  
  1445.      LAB <Labelname>=<Value>
  1446.  
  1447. Description:
  1448.  
  1449.      Define label <Labelname> and set it to value <Value>. If the label
  1450.      already exists it will be redefined.
  1451.  
  1452. Example:
  1453.  
  1454.       o lab sync=$9521
  1455.       o lab mfmload=824
  1456.  
  1457. -----------------------------------------------------------------------------
  1458.  
  1459. Syntax:
  1460.  
  1461.      LABS
  1462.  
  1463.      LABELS
  1464.  
  1465. Description:
  1466.  
  1467.      Show all current defined labels.
  1468.  
  1469. Example:
  1470.  
  1471.       o labs
  1472.  
  1473. -----------------------------------------------------------------------------
  1474.  
  1475. Syntax:
  1476.  
  1477.      LE <Filename>
  1478.  
  1479. Description:
  1480.  
  1481.      Load envirement from given file <Filename>. Only settings that have been
  1482.      saved with the current programm version can be used. Settings can be
  1483.      genereated by the SE command.
  1484.  
  1485. Example:
  1486.  
  1487.       o le "hd1:tk/tk.prefs"
  1488.  
  1489. -----------------------------------------------------------------------------
  1490.  
  1491. Syntax:
  1492.  
  1493.      LIBS
  1494.  
  1495.      LIBRARIES
  1496.  
  1497. Description:
  1498.  
  1499.      Lists all currently available libraries.
  1500.  
  1501. Example:
  1502.  
  1503.       o libs
  1504.  
  1505. -----------------------------------------------------------------------------
  1506.  
  1507. Syntax:
  1508.  
  1509.      LM <Filename>,<Start> [<End>]
  1510.  
  1511.      RB <Filename>,<Start> [<End>]
  1512.  
  1513. Description:
  1514.  
  1515.      Load data-file <Filename> to memory starting at <Start>. If <End> is
  1516.      given, data will only be loaded upto <End>.
  1517.  
  1518. Example:
  1519.  
  1520.       o lm "hd1:tk/tk.exe",100000
  1521.  
  1522. -----------------------------------------------------------------------------
  1523.  
  1524. Syntax:
  1525.  
  1526.      M[.<B|W|L] [#<Entries per row>] <Address>
  1527.  
  1528. Description:
  1529.  
  1530.      Display memory at <Address> as <Entries per row> byte/word/long
  1531.      depending on the [.<B|W|L] parameter. The command uses the byte offset
  1532.      defined by the Y command. Using optional paramters will define the
  1533.      default paramter. The optinal parameter can be reseted by illegal values
  1534.      or just be using '#'.
  1535.  
  1536. Example:
  1537.  
  1538.       o m.b #5 80000
  1539.         $0080000 $41 $42 $43 $44 $45 "ABCDE"
  1540.  
  1541. -----------------------------------------------------------------------------
  1542.  
  1543. Syntax:
  1544.  
  1545.      MA
  1546.  
  1547. Description:
  1548.  
  1549.      View all current memory access ranges.
  1550.  
  1551. Example:
  1552.  
  1553.       o ma
  1554.  
  1555. -----------------------------------------------------------------------------
  1556.  
  1557. Syntax:
  1558.  
  1559.      MAD <Start> <End>
  1560.  
  1561. Description:
  1562.  
  1563.      Delete memory access range at area from <Start> to <End>.
  1564.  
  1565. Example:
  1566.  
  1567.       o mad dff000 dff200
  1568.  
  1569. -----------------------------------------------------------------------------
  1570.  
  1571. Syntax:
  1572.  
  1573.      MADA
  1574.  
  1575. Description:
  1576.  
  1577.      Delete all memory access ranges.
  1578.  
  1579. Example:
  1580.  
  1581.       o mada
  1582.  
  1583. -----------------------------------------------------------------------------
  1584.  
  1585. Syntax:
  1586.  
  1587.      MAKEDIR <Path>
  1588.  
  1589.      MKDIR <Path>
  1590.  
  1591. Description:
  1592.  
  1593.      Creates a directory with for given <Path>.
  1594.  
  1595. Example:
  1596.  
  1597.       o makedir "hd1:tk/tk.dir"
  1598.  
  1599. -----------------------------------------------------------------------------
  1600.  
  1601. Syntax:
  1602.  
  1603.      MAS <Start> <End>
  1604.  
  1605. Description:
  1606.  
  1607.      Set memory access range to area from <Start> to <End>.
  1608.  
  1609. Example:
  1610.  
  1611.       o mas dff000 dff200
  1612.  
  1613. -----------------------------------------------------------------------------
  1614.  
  1615. Syntax:
  1616.  
  1617.      MD <Address>
  1618.  
  1619. Description:
  1620.  
  1621.      Delete memory watch point at <Address>.
  1622.  
  1623. Example:
  1624.  
  1625.       o md 80000
  1626.  
  1627. -----------------------------------------------------------------------------
  1628.  
  1629. Syntax:
  1630.  
  1631.      MDA
  1632.  
  1633. Description:
  1634.  
  1635.      Delete all memory watch points.
  1636.  
  1637. Example:
  1638.  
  1639.       o mda
  1640.  
  1641. -----------------------------------------------------------------------------
  1642.  
  1643. Syntax:
  1644.  
  1645.      MFMC <Start> <End> <Destination>
  1646.  
  1647. Description:
  1648.  
  1649.      Code data from <Start> to <End> into mfm-data stored at <Destination>.
  1650.      Each read long is coded into two mfm-longs (odd/even). This means that
  1651.      <End>-<Start> must be a multiple of four.
  1652.  
  1653. Example:
  1654.  
  1655.       o mfmc 80000 82000 84000
  1656.  
  1657. -----------------------------------------------------------------------------
  1658.  
  1659. Syntax:
  1660.  
  1661.      MFMD <Start> <End> <Destination>
  1662.  
  1663. Description:
  1664.  
  1665.      Decode mfm-data from <Start> to <End> to normal data stored at
  1666.      <Destination>. Each two read long (odd/even) are decoded into one long.
  1667.      This means that <End>-<Start> must be a multiple of eight.
  1668.  
  1669. Example:
  1670.  
  1671.       o mfmd 84000 88000 90000
  1672.  
  1673. -----------------------------------------------------------------------------
  1674.  
  1675. Syntax:
  1676.  
  1677.      MFMR [#<Unit>] [INDEX] [SYNC=<Sync>] <Track> <DMA-Length> <Destination>
  1678.  
  1679. Description:
  1680.  
  1681.      Read <DMA-Length> words of mfm-data from track <Track> of disk in unit
  1682.      <Unit> to memory at <Destination>. The default <Unit> is the
  1683.      current-device-unit. By default data will not be read on index or sync.
  1684.      Using keywords 'INDEX' or 'SYNC=<SYNC>' will enable these functions.
  1685.      Mfm-data is read directly by DMA. <Destination> may only be in
  1686.      chip-memory.
  1687.  
  1688. Example:
  1689.  
  1690.       o mfmr #0 index sync=4489 0 2000 100000 ; will read $2000 words=$4000
  1691.         bytes !!
  1692.  
  1693. -----------------------------------------------------------------------------
  1694.  
  1695. Syntax:
  1696.  
  1697.      MFMSL <Start> <End> <Destination> <BitShift>
  1698.  
  1699. Description:
  1700.  
  1701.      Shift data from <Start> to <End> by <Bitshift> bits left and store it at
  1702.      <Destination>. Of course, this command can also be used for normal data.
  1703.      <Bitshift> must be lower than 16.
  1704.  
  1705. Example:
  1706.  
  1707.       o mfmsl 84000 88000 90000 3
  1708.  
  1709. -----------------------------------------------------------------------------
  1710.  
  1711. Syntax:
  1712.  
  1713.      MFMSR <Start> <End> <Destination> <BitShift>
  1714.  
  1715. Description:
  1716.  
  1717.      Shift data from <Start> to <End> by <Bitshift> bits right and store it
  1718.      at <Destination>. Of course, this command can also be used for normal
  1719.      data. <Bitshift> must be lower than 16.
  1720.  
  1721. Example:
  1722.  
  1723.       o mfmsr 84000 88000 90000 3
  1724.  
  1725. -----------------------------------------------------------------------------
  1726.  
  1727. Syntax:
  1728.  
  1729.      MFMSS <Start> <End> <Destination> <Sync>
  1730.  
  1731. Description:
  1732.  
  1733.      Search word <Sync> in data from <Start> to <End>. If <Sync> is found all
  1734.      following data are copied to <Destination>, including the found sync.
  1735.      This command is very usefull for 'sync-read-by-hand'.
  1736.  
  1737. Example:
  1738.  
  1739.       o mfmr 0 2000 80000
  1740.       o mfmss 80000 84000 90000 4489
  1741.  
  1742. -----------------------------------------------------------------------------
  1743.  
  1744. Syntax:
  1745.  
  1746.      MFMW [#<Unit>] [INDEX] <Track> <DMA-Length> <Source>
  1747.  
  1748. Description:
  1749.  
  1750.      Write <DMA-Length> words of mfm-data to track <Track> of disk in unit
  1751.      <Unit> with memory at <Source>. The default <Unit> is the
  1752.      current-device-unit. By default data will not be written on index. Using
  1753.      keyword 'INDEX' will enable this function. Mfm-data is written directly
  1754.      by DMA. <Source> may only be in chip-memory.
  1755.  
  1756. Example:
  1757.  
  1758.       o mfmw #0 index 0 2000 100000 ; will write $2000 words=$4000 bytes !!
  1759.  
  1760. -----------------------------------------------------------------------------
  1761.  
  1762. Syntax:
  1763.  
  1764.      MMUD <Start> <End>
  1765.  
  1766. Description:
  1767.  
  1768.      Delete mmu catchlist from <Start> to <End>.
  1769.  
  1770. Example:
  1771.  
  1772.       o mmud 81234 81235
  1773.  
  1774. -----------------------------------------------------------------------------
  1775.  
  1776. Syntax:
  1777.  
  1778.      MMUDA
  1779.  
  1780. Description:
  1781.  
  1782.      Delete all mmu catchlists.
  1783.  
  1784. Example:
  1785.  
  1786.       o mmuda
  1787.  
  1788. -----------------------------------------------------------------------------
  1789.  
  1790. Syntax:
  1791.  
  1792.      MMUS <Start> <End>
  1793.  
  1794. Description:
  1795.  
  1796.      Add memory from <Start> to <End> to mmu catchlist. The specified memory
  1797.      is added as read/write catch.
  1798.  
  1799. Example:
  1800.  
  1801.       o mmus 81234 81235
  1802.  
  1803. -----------------------------------------------------------------------------
  1804.  
  1805. Syntax:
  1806.  
  1807.      MMUSW <Start> <End>
  1808.  
  1809. Description:
  1810.  
  1811.      Add memory from <Start> to <End> to mmu catchlist. The specified memory
  1812.      is added as write catch.
  1813.  
  1814. Example:
  1815.  
  1816.       o mmusw 81234 81235
  1817.  
  1818. -----------------------------------------------------------------------------
  1819.  
  1820. Syntax:
  1821.  
  1822.      MMUV
  1823.  
  1824. Description:
  1825.  
  1826.      Show current mmu catchlist.
  1827.  
  1828. Example:
  1829.  
  1830.       o mmuv
  1831.  
  1832. -----------------------------------------------------------------------------
  1833.  
  1834. Syntax:
  1835.  
  1836.      MP
  1837.  
  1838. Description:
  1839.  
  1840.      Start the memory-peeker. This tools allows you to scan through the
  1841.      memory and 'browse around'. Its also possible to view non-chipmem. Use
  1842.      the modulo feature to adjust the srceensize (eg. for finding images).
  1843.  
  1844.      The following keys functions are available:
  1845.  
  1846.       o <CURSOR-DOWN>: Scroll one line down
  1847.       o <CURSOR-UP>: Scroll one line up
  1848.       o <CURSOR-DOWN>+<SHIFT>: Scroll a 3/4 screen down
  1849.       o <CURSOR-UP>+<SHIFT>: Scroll a 3/4 screen up
  1850.       o <CURSOR-LEFT>: Scroll 32 bit left/down
  1851.       o <CURSOR-RIGHT>: Scroll 32 bit right/up
  1852.       o <ESC>: Back to TK
  1853.       o <TAB>: Cycle to next memory-page
  1854.       o <DEL>: Reset modulo to zero
  1855.       o <DEL>: Decrease modulo by 2
  1856.       o <HELP>: Increase modulo by 2
  1857.  
  1858. Example:
  1859.  
  1860.       o mp
  1861.  
  1862. -----------------------------------------------------------------------------
  1863.  
  1864. Syntax:
  1865.  
  1866.      MS [.<B|W|L] <Address>
  1867.  
  1868. Description:
  1869.  
  1870.      Set memory watch point to byte/word/long at <Address>. Default size is
  1871.      byte.
  1872.  
  1873. Example:
  1874.  
  1875.       o ms.l 80000
  1876.       o ms 60000
  1877.  
  1878. -----------------------------------------------------------------------------
  1879.  
  1880. Syntax:
  1881.  
  1882.      MV
  1883.  
  1884. Description:
  1885.  
  1886.      View all current memory watch points.
  1887.  
  1888. Example:
  1889.  
  1890.       o mv
  1891.  
  1892. -----------------------------------------------------------------------------
  1893.  
  1894. Syntax:
  1895.  
  1896.      N [#<Entries per row>] <Address>
  1897.  
  1898. Description:
  1899.  
  1900.      Display memory at <Address> as line of <Entries per row> ascii-codes.The
  1901.      command uses the byte offset defined by the Y command. Using optional
  1902.      paramters will define the default paramter. The optinal parameter can be
  1903.      reseted by illegal values or just be using '#'.
  1904.  
  1905. Example:
  1906.  
  1907.       o n #$10 $80000
  1908.         $0080000 "ABCDEFGHIJKLMNOP"
  1909.  
  1910. -----------------------------------------------------------------------------
  1911.  
  1912. Syntax:
  1913.  
  1914.      NO <Offset>
  1915.  
  1916. Description:
  1917.  
  1918.      Set the ascii-offset for the M/N command. The offset is added to every
  1919.      read byte and subtracted from every written byte. Only the low byte of
  1920.      <Offset> is used!
  1921.  
  1922. Example:
  1923.  
  1924.       o n $80000
  1925.         $0080000 "ABC"
  1926.       o no 1
  1927.       o n $80000
  1928.         $0080000 "BCD"
  1929.  
  1930. -----------------------------------------------------------------------------
  1931.  
  1932. Syntax:
  1933.  
  1934.      O <Bytes>,<Start> <End>
  1935.  
  1936. Description:
  1937.  
  1938.      Fill memory from <Start> to <End> with given pattern <Bytes>.
  1939.  
  1940. Example:
  1941.  
  1942.       o o "Mok" 0 "!" !10 0,0 20000
  1943.  
  1944. -----------------------------------------------------------------------------
  1945.  
  1946. Syntax:
  1947.  
  1948.      OR <Bytes>,<Start> <End>
  1949.  
  1950. Description:
  1951.  
  1952.      Or bytewise memory from <Start> to <End> with given pattern <Bytes>.
  1953.  
  1954. Example:
  1955.  
  1956.       o or "Mok",80000 90000
  1957.  
  1958. -----------------------------------------------------------------------------
  1959.  
  1960. Syntax:
  1961.  
  1962.      PORTS
  1963.  
  1964. Description:
  1965.  
  1966.      Lists all currently available ports and its owner tasks.
  1967.  
  1968. Example:
  1969.  
  1970.       o ports
  1971.  
  1972. -----------------------------------------------------------------------------
  1973.  
  1974. Syntax:
  1975.  
  1976.      Q <Start> <End> <Destination>
  1977.  
  1978.      COMP <Start> <End> <Destination>
  1979.  
  1980. Description:
  1981.  
  1982.      Compare memory from <Start> to <End> with memory at <Destination>.
  1983.  
  1984. Example:
  1985.  
  1986.       o q f80000 f90000 80000
  1987.  
  1988. -----------------------------------------------------------------------------
  1989.  
  1990. Syntax:
  1991.  
  1992.      R [<CPU-REG> <Value>]
  1993.  
  1994. Description:
  1995.  
  1996.      If arguments are not given the current registers will be shown. If
  1997.      arguments are used the cpu-register <CPU-REG> can be set to value
  1998.      <Value>. If you want to change MMU/FPU registers take a look at the
  1999.      RM/RF command.
  2000.  
  2001.      The following registers are available:
  2002.  
  2003.       o 68000: d0-d7,a0-a7,sr,pc,ssp,usp
  2004.       o 68010: d0-d7,a0-a7,sr,pc,ssp,usp,vbr,sfc,dfc
  2005.       o 68020: d0-d7,a0-a7,sr,pc,isp,usp,msp,vbr,sfc,dfc,caar,cacr
  2006.       o 68030: d0-d7,a0-a7,sr,pc,isp,usp,msp,vbr,sfc,dfc,caar,cacr
  2007.       o 68040: d0-d7,a0-a7,sr,pc,isp,usp,msp,vbr,sfc,dfc,cacr
  2008.       o 68060: d0-d7,a0-a7,sr,pc,isp,usp,msp,vbr,sfc,dfc,cacr
  2009.  
  2010. Example:
  2011.  
  2012.       o r ssp \ssp+4
  2013.       o r d0 44894489
  2014.  
  2015. -----------------------------------------------------------------------------
  2016.  
  2017. Syntax:
  2018.  
  2019.      RD [#<Unit>] <DiskOffset> <Length> <Destination>
  2020.  
  2021. Description:
  2022.  
  2023.      Read <Length> bytes from diskoffset <DiskOffset> of disk in unit <Unit>
  2024.      to memory at <Destination>. The default <Unit> is the
  2025.      current-device-unit. <DiskOffset> can also be odd.
  2026.  
  2027. Example:
  2028.  
  2029.       o rd #0 !880*200 4 80000 ; read first 4 bytes to $80000 from sector
  2030.         !880
  2031.  
  2032. -----------------------------------------------------------------------------
  2033.  
  2034. Syntax:
  2035.  
  2036.      RES
  2037.  
  2038.      RESOURCES
  2039.  
  2040. Description:
  2041.  
  2042.      Lists all currently available resources.
  2043.  
  2044. Example:
  2045.  
  2046.       o res
  2047.  
  2048. -----------------------------------------------------------------------------
  2049.  
  2050. Syntax:
  2051.  
  2052.      RESET
  2053.  
  2054. Description:
  2055.  
  2056.      The function will immediatly perform a reset.
  2057.  
  2058. Example:
  2059.  
  2060.       o reset
  2061.  
  2062. -----------------------------------------------------------------------------
  2063. Syntax:
  2064.  
  2065.      RF [<FPU-REG> <Value>]
  2066.  
  2067. Description:
  2068.  
  2069.      If arguments are not given the current registers will be shown. If
  2070.      arguments are used the fpu-register <FPU-REG> can be set to value
  2071.      <Value>.
  2072.  
  2073.      The following registers are available:
  2074.  
  2075.       o 68881/68882/68040: fp0-fp7,fpsr,fpcr,fpiar (Currently they can not be
  2076.         modifed!)
  2077.  
  2078. Example:
  2079.  
  2080.       o rf
  2081.  
  2082. -----------------------------------------------------------------------------
  2083.  
  2084. Syntax:
  2085.  
  2086.      RM [<MMU-REG> <Value>]
  2087.  
  2088. Description:
  2089.  
  2090.      If arguments are not given the current registers will be shown. If
  2091.      arguments are used the mmu-register <MMU-REG> can be set to value
  2092.      <Value>.
  2093.  
  2094.      The following registers are available:
  2095.  
  2096.       o 68000/68010: none
  2097.       o 68851/68030: tt0,tt1,srp (lower long),srp.0 (lower long), srp.1
  2098.         (upper long),crp (lower long),crp.0 (lower long), crp.1 (upper
  2099.         long),sr,tc
  2100.       o 68040/68060: itt0,itt1,dtt0,dtt1,srp,urp,tc,sr
  2101.  
  2102. Example:
  2103.  
  2104.       o rm tc 81235678
  2105.       o rm dtt0 0
  2106.  
  2107. -----------------------------------------------------------------------------
  2108.  
  2109. Syntax:
  2110.  
  2111.      RS [#<Unit>] <Sector> <SectorAmount> <Destination>
  2112.  
  2113. Description:
  2114.  
  2115.      Read <SectorAmount> sectors from sector <Sector> and following of unit
  2116.      <Unit> to memory at <Destination>. The default <Unit> is the
  2117.      current-device-unit.
  2118.  
  2119. Example:
  2120.  
  2121.       o rs !880 1 80000
  2122.  
  2123. -----------------------------------------------------------------------------
  2124.  
  2125. Syntax:
  2126.  
  2127.      RT [#<Unit>] <Track> <TrackAmount> <Destination>
  2128.  
  2129. Description:
  2130.  
  2131.      Read <TrackAmount> tracks from track <Track> and following of disk in
  2132.      unit <Unit> to memory at <Destination>.The default <Unit> is the
  2133.      current-device-unit.
  2134.  
  2135. Example:
  2136.  
  2137.       o rt !80 1 80000
  2138.  
  2139. -----------------------------------------------------------------------------
  2140.  
  2141. Syntax:
  2142.  
  2143.      SA <Start> [<End>]
  2144.  
  2145. Description:
  2146.  
  2147.      Save current programm to memory starting from <Start>. <End> is the
  2148.      upper boundary for the programm data. If not given it will use as much
  2149.      memory as needed. Freezed programm-data can be reloaded using the LA
  2150.      command.
  2151.  
  2152. Example:
  2153.  
  2154.       o sa 7c00000 7fa0000
  2155.  
  2156. -----------------------------------------------------------------------------
  2157.  
  2158. Syntax:
  2159.  
  2160.      SE <Filename>
  2161.  
  2162. Description:
  2163.  
  2164.      Save envirement to given file <Filename>. The settings can be loaded
  2165.      using the LE command.
  2166.  
  2167. Example:
  2168.  
  2169.       o se "hd1:tk/tk.prefs"
  2170.  
  2171. -----------------------------------------------------------------------------
  2172.  
  2173. Syntax:
  2174.  
  2175.      SETX
  2176.  
  2177.      SETEXCEPTIONS
  2178.  
  2179. Description:
  2180.  
  2181.      This command will install a exception-'handler' into the actual
  2182.      programm. If the programm should crash now it will come back into TK.
  2183.      You can check out what happend and maybe solve the 'bug'. The following
  2184.      vectors are patched:
  2185.  
  2186.       o +$08: BUS-ERROR exception
  2187.       o +$0c: ADDRESS-ERROR exception
  2188.       o +$10: ILLEGAL-COMMAND exception
  2189.       o +$14: DIVISION BY ZERO exception
  2190.       o +$24: TRACE exception
  2191.       o +$28: LINA-A exception
  2192.       o +$2c: LINE-F exception (no fpu/mmu?)
  2193.  
  2194. Example:
  2195.  
  2196.       o SETX
  2197.  
  2198. -----------------------------------------------------------------------------
  2199.  
  2200. Syntax:
  2201.  
  2202.      SHOWSTACKFRAME
  2203.  
  2204. Description:
  2205.  
  2206.      Show the stackframe of the freezed program.
  2207.  
  2208. Example:
  2209.  
  2210.       o showstackframe
  2211.  
  2212. -----------------------------------------------------------------------------
  2213.  
  2214. Syntax:
  2215.  
  2216.      SI [<Count>]
  2217.  
  2218. Description:
  2219.  
  2220.      Skip <Count> command (eg jsr/bsr is one command). The default value for
  2221.      <Count> is one. Note that the disassembly is used to calculate the new
  2222.      address.
  2223.  
  2224. Example:
  2225.  
  2226.       o si 5
  2227.  
  2228. -----------------------------------------------------------------------------
  2229.  
  2230. Syntax:
  2231.  
  2232.      SIM [<Rawkey>]
  2233.  
  2234. Description:
  2235.  
  2236.      The function will install a faked NMI-simulator into the system by
  2237.      patching directly the +$68 keyboard interrupt vector. If the user now
  2238.      presses the selected key it will simulate a NMI. This will only work if
  2239.      the interrupt is not disabled and the vector is not changed. The
  2240.      specfied key must be given as a rawkey code. Check out the GETKEY
  2241.      function. If no argument is given and the simulator is not installed the
  2242.      patch is added with the default rawkey $5d ('*' on the keypad). If no
  2243.      argument is given and the simulator is installed the patch will be
  2244.      removed. In the other cases the rawkey will be redefined.
  2245.  
  2246. Example:
  2247.  
  2248.       o sim
  2249.  
  2250. -----------------------------------------------------------------------------
  2251.  
  2252. Syntax:
  2253.  
  2254.      SM <Filename>,<Start> <End>
  2255.  
  2256.      WB <Filename>,<Start> <End>
  2257.  
  2258. Description:
  2259.  
  2260.      Save memory from <Start> to <End> to data-file <Filename>. If you
  2261.      overwrite a file the old filename is not changed! (eg. old 'AbCd', save
  2262.      'ABCD', result 'AbCd')
  2263.  
  2264. Example:
  2265.  
  2266.       o sm "hd1:tk/tk.exe",100000 120000
  2267.  
  2268. -----------------------------------------------------------------------------
  2269.  
  2270. Syntax:
  2271.  
  2272.      ST [<Count>]
  2273.  
  2274. Description:
  2275.  
  2276.      Exit and execute <Count> command. Programm is traced step by step (eg
  2277.      trace into jsr/bsr). The default value for <Count> is one.
  2278.  
  2279. Example:
  2280.  
  2281.       o st
  2282.       o st !100000
  2283.  
  2284. -----------------------------------------------------------------------------
  2285.  
  2286. Syntax:
  2287.  
  2288.      T <Value>
  2289.  
  2290. Description:
  2291.  
  2292.      Remove all address in buffer for training which do not hold <Value>.
  2293.      Then continue collecting all address which hold <Value>. Scanned memory
  2294.      was set by the TS command. Multiple use is possible. The command can
  2295.      only be used in byte-value-trainer-mode.
  2296.  
  2297. Example:
  2298.  
  2299.       o ts 5,780000 7c00000
  2300.       o x
  2301.       o t 4
  2302.  
  2303. -----------------------------------------------------------------------------
  2304.  
  2305. Syntax:
  2306.  
  2307.      TASKS
  2308.  
  2309. Description:
  2310.  
  2311.      Lists all currently available tasks. The tasks are listed in 3
  2312.      categories : ready,waiting,running. A 'P' indicates a process and a 'T'
  2313.      a task. The first value is pointer to the task/process structure, the
  2314.      second one is a pointer to the stack of the process (the first long at
  2315.      this address points to the routine that will be executed when the task
  2316.      is running again (must be in the wait-list for that))
  2317.  
  2318. Example:
  2319.  
  2320.       o tasks
  2321.         ..
  2322.         P: $07989c88 $0798fd94 MagicWB-Demon {C:MagicWB-Demon}
  2323.         ; a process, task node at $7989c88, first call to *798fd94, name
  2324.         'Magic..', Process command 'C:Magic..)
  2325.  
  2326. -----------------------------------------------------------------------------
  2327.  
  2328. Syntax:
  2329.  
  2330.      TB <Start> <End>
  2331.  
  2332. Description:
  2333.  
  2334.      Set location of buffer for training to memory from <Start> to <End>.
  2335.  
  2336. Example:
  2337.  
  2338.       o tb 7c00000 7f80000
  2339.  
  2340. -----------------------------------------------------------------------------
  2341.  
  2342. Syntax:
  2343.  
  2344.      TBD
  2345.  
  2346. Description:
  2347.  
  2348.      Reset location of buffer for training to default. The internal reserved
  2349.      memory is used.
  2350.  
  2351. Example:
  2352.  
  2353.       o tbd
  2354.  
  2355. -----------------------------------------------------------------------------
  2356.  
  2357. Syntax:
  2358.  
  2359.      TBV
  2360.  
  2361. Description:
  2362.  
  2363.      View current location of buffer for training.
  2364.  
  2365. Example:
  2366.  
  2367.       o tbv
  2368.  
  2369. -----------------------------------------------------------------------------
  2370.  
  2371. Syntax:
  2372.  
  2373.      TDC
  2374.  
  2375. Description:
  2376.  
  2377.      If the deep-trainer-mode is already active all stored address are
  2378.      compared to their current value. If the value has changed the address is
  2379.      kept in the buffer, so only address that have changed are kept in the
  2380.      buffer. As usual the command tries to continue scanning the given
  2381.      [Range] . See also the TDS command. The command can only be used in the
  2382.      deep-trainer-mode.
  2383.  
  2384. Example:
  2385.  
  2386.       o tdc
  2387.  
  2388. -----------------------------------------------------------------------------
  2389.  
  2390. Syntax:
  2391.  
  2392.      TDS [Range]
  2393.  
  2394. Description:
  2395.  
  2396.      If deep-trainer-mode is not active, it will be enabled now. All address
  2397.      in [Range] are stored in the buffer for training. If [Range] can not be
  2398.      scanned in one pass you can repeat the operation by using the TDS/TDC
  2399.      command. If the deep-trainer-mode is already active all stored address
  2400.      are compared to their current value. If the value has changed the
  2401.      address is removed, so only address that have not changed are kept in
  2402.      the buffer. As usual the command tries to continue scanning the given
  2403.      [Range] . Note that eg 'TDS 80000 90000' will not restart the
  2404.      deep-trainer if it was already active, in this case the [Range] paramter
  2405.      is ignored!. Using the command the first time will enable the
  2406.      deep-trainer-mode. This function needs around three bytes per stored
  2407.      address.
  2408.  
  2409. Example:
  2410.  
  2411.       o tds 780000 7c00000
  2412.       o tds
  2413.  
  2414. -----------------------------------------------------------------------------
  2415.  
  2416. Syntax:
  2417.  
  2418.      TDV
  2419.  
  2420. Description:
  2421.  
  2422.      View all address in the buffer for training. See also the
  2423.      TDS/TDCcommand. The command can only be used in the deep-trainer-mode.
  2424.  
  2425. Example:
  2426.  
  2427.       o tdv
  2428.  
  2429. -----------------------------------------------------------------------------
  2430.  
  2431. Syntax:
  2432.  
  2433.      TDX
  2434.  
  2435. Description:
  2436.  
  2437.      Free buffer for training, so that it can be used for
  2438.      byte-value-trainer-mode. All address in the deep-trainer-mode are lost.
  2439.      The command can only be used in deep-trainer-mode.
  2440.  
  2441. Example:
  2442.  
  2443.       o tdx
  2444.  
  2445. -----------------------------------------------------------------------------
  2446.  
  2447. Syntax:
  2448.  
  2449.      TR [<Count>]
  2450.  
  2451. Description:
  2452.  
  2453.      Exit and execute <Count> command. Programm is traced command by command
  2454.      (eg no trace into jsr/bsr). The default value for <Count> is one.
  2455.  
  2456. Example:
  2457.  
  2458.       o tr
  2459.       o tr 5
  2460.  
  2461. -----------------------------------------------------------------------------
  2462.  
  2463. Syntax:
  2464.  
  2465.      TRACKER [<Start>]
  2466.  
  2467. Description:
  2468.  
  2469.      Start the module-ripper. The memory is scanned for known modules.
  2470.      Currently the usual 31-sample noise/protracker, prorunner v2 and the
  2471.      player6.1a is included. If <Start> is specfied the scan is started at
  2472.      the given address (only chipmem!)
  2473.  
  2474. Example:
  2475.  
  2476.       o tracker
  2477.  
  2478. -----------------------------------------------------------------------------
  2479. Syntax:
  2480.  
  2481.      TRANS <Start> <End> <Destination>
  2482.  
  2483. Description:
  2484.  
  2485.      Copy memory from <Start> to <End> to memory at <Destination>.
  2486.  
  2487. Example:
  2488.  
  2489.       o trans f80000 f90000 80000
  2490.  
  2491. -----------------------------------------------------------------------------
  2492.  
  2493. Syntax:
  2494.  
  2495.      TS <Value> [,Range]
  2496.  
  2497. Description:
  2498.  
  2499.      Init buffer for training and collect all address in [Range] which hold
  2500.      the byte <Value>. If [Range] can not be scanned in one pass you can
  2501.      repeat the operation by using the T command. The command enables the
  2502.      byte-value-trainer-mode. This function needs around 2 bytes per stored
  2503.      address.
  2504.  
  2505. Example:
  2506.  
  2507.       o ts 5,780000 7c00000
  2508.  
  2509. -----------------------------------------------------------------------------
  2510.  
  2511. Syntax:
  2512.  
  2513.      TV
  2514.  
  2515. Description:
  2516.  
  2517.      View all address in buffer for training. The command can only be used in
  2518.      the byte-value-trainer-mode.
  2519.  
  2520. Example:
  2521.  
  2522.       o ts 5,780000 7c00000
  2523.       o x
  2524.       o t 4
  2525.  
  2526. -----------------------------------------------------------------------------
  2527.  
  2528. Syntax:
  2529.  
  2530.      TX
  2531.  
  2532. Description:
  2533.  
  2534.      Free buffer for training, so that it can be used for the
  2535.      deep-trainer-mode. All address in the byte-value-trainer-mode are lost.
  2536.      The command can only be used in byte-value-trainer-mode.
  2537.  
  2538. Example:
  2539.  
  2540.       o ts 99
  2541.       o tx
  2542.       o tds
  2543.  
  2544. -----------------------------------------------------------------------------
  2545.  
  2546. Syntax:
  2547.  
  2548.      TYPE <Filename>
  2549.  
  2550.      LESS <Filename>
  2551.  
  2552.      MORE<Filename>
  2553.  
  2554. Description:
  2555.  
  2556.      Type text-file <Filename> to screen.
  2557.  
  2558. Example:
  2559.  
  2560.       o type "df0:s/startup-sequence"
  2561.  
  2562. -----------------------------------------------------------------------------
  2563.  
  2564. Syntax:
  2565.  
  2566.      USEBLIT
  2567.  
  2568. Description:
  2569.  
  2570.      Use the blitter for scrolling. On slow machines(68000) this method
  2571.      allows realtime scrolling on small screens. The major disadvantage is
  2572.      the loss of the blitter custom-regs, so use with care!
  2573.  
  2574. Example:
  2575.  
  2576.       o useblit
  2577.  
  2578. -----------------------------------------------------------------------------
  2579. Syntax:
  2580.  
  2581.      USECPU
  2582.  
  2583. Description:
  2584.  
  2585.      Use the processor for scrolling. On faster machines(68020++) this method
  2586.      allows realtime scrolling on big screens, too. Also the blitter
  2587.      custom-regs are not touched.
  2588.  
  2589. Example:
  2590.  
  2591.       o usecpu
  2592.  
  2593. -----------------------------------------------------------------------------
  2594. Syntax:
  2595.  
  2596.      VERSION
  2597.  
  2598. Description:
  2599.  
  2600.      The current version number is shown.
  2601.  
  2602. Example:
  2603.  
  2604.       o version
  2605.  
  2606. -----------------------------------------------------------------------------
  2607.  
  2608. Syntax:
  2609.  
  2610.      W [<CIA-REG>]
  2611.  
  2612. Description:
  2613.  
  2614.      If no paramter is specified it will show the first CIA register. The
  2615.      output can be edited (hit return to accept new values). Usually there
  2616.      are just $10 regs per CIA but they are multiplexed; so there are some
  2617.      more. The following flags exist:
  2618.  
  2619.       o '*': reg has been backuped correctly and will be written back
  2620.       o '?': reg has not been fully backuped and will not be written back;
  2621.  
  2622. Example:
  2623.  
  2624.       o w 7 ; show/edit TimerB-High
  2625.  
  2626. -----------------------------------------------------------------------------
  2627.  
  2628. Syntax:
  2629.  
  2630.      WD [#<Unit>] <DiskOffset> <Length> <Source>
  2631.  
  2632. Description:
  2633.  
  2634.      Write <Length> bytes to diskoffset <DiskOffset> of disk in unit <Unit>
  2635.      with memory at <Source>. The default <Unit> is the current-device-unit.
  2636.      <DiskOffset> can also be odd.
  2637.  
  2638. Example:
  2639.  
  2640.       o wd #0 !880*200 1 80000
  2641.  
  2642. -----------------------------------------------------------------------------
  2643.  
  2644. Syntax:
  2645.  
  2646.      WN [<Count>]
  2647.  
  2648. Description:
  2649.  
  2650.      Exit and return when the <Count>-th command after current position is
  2651.      executed.Note that the disassembly is used to calculate the ned address.
  2652.      Programm is not traced, instead a temporary breakpoint is set. The
  2653.      default value for <Count> is one.
  2654.  
  2655. Example:
  2656.  
  2657.       o wn 5
  2658.  
  2659. -----------------------------------------------------------------------------
  2660.  
  2661. Syntax:
  2662.  
  2663.      WPC <Address>
  2664.  
  2665. Description:
  2666.  
  2667.      Exit and return when command at <Address> is executed. Programm is
  2668.      traced and works also in ROM area.
  2669.  
  2670. Example:
  2671.  
  2672.       o wpc f800d2
  2673.  
  2674. -----------------------------------------------------------------------------
  2675.  
  2676. Syntax:
  2677.  
  2678.      WS [#<Unit>] <Sector> <SectorAmount> <Source>
  2679.  
  2680. Description:
  2681.  
  2682.      Write <SectorAmount> sectors to sector <Sector> and following of disk in
  2683.      unit <Unit> with memory at <Source>. The default <Unit> is the
  2684.      current-device-unit.
  2685.  
  2686. Example:
  2687.  
  2688.       o ws !880 1 80000
  2689.  
  2690. -----------------------------------------------------------------------------
  2691.  
  2692. Syntax:
  2693.  
  2694.      WT [#<Unit>] <Track> <TrackAmount> <Source>
  2695.  
  2696. Description:
  2697.  
  2698.      Write <TrackAmount> tracks to track <Track> and following of disk in
  2699.      unit <Unit> with memory at <Source>. The default <Unit> is the
  2700.      current-device-unit.
  2701.  
  2702. Example:
  2703.  
  2704.       o wt !80 1 80000
  2705.  
  2706. -----------------------------------------------------------------------------
  2707.  
  2708. Syntax:
  2709.  
  2710.      X
  2711.  
  2712. Description:
  2713.  
  2714.      Exit freezer programm and continue the freezed programm.
  2715.  
  2716. Example:
  2717.  
  2718.       o x
  2719.  
  2720. -----------------------------------------------------------------------------
  2721.  
  2722. Syntax:
  2723.  
  2724.      Y [#<Entries per row>] <Address>
  2725.  
  2726. Description:
  2727.  
  2728.      Display memory at <Address> as <Entries per row> binary bytes. Using
  2729.      optional paramters will define the default. The optinal parameter can be
  2730.      reseted by illegal values or just be using '#'.
  2731.  
  2732. Example:
  2733.  
  2734.       o y #1 80000
  2735.         $0080000 %01011111
  2736.  
  2737. -----------------------------------------------------------------------------
  2738.  
  2739. Thrill Kill - Argument description
  2740. -----------------------------------------------------------------------------
  2741.  
  2742.    o <Value>, <Count>, <Offset>, <Entries per row>, <TrapNumber>,
  2743.      ;4m<BreakpointNumber>, <Length>, <SectorAmount>, <TrackAmount>, <Sync>,
  2744.      ;4m<DMA-Length>,<BitShift>,<Rawkey>
  2745.    o <Address>, <Start>, <End>, <Destination>, <Source>
  2746.    o <String>,<Labelname>
  2747.    o <StringPattern>
  2748.    o <Bytes>
  2749.    o <PBytes>
  2750.    o <Range>
  2751.    o <DisassmeblyPattern>
  2752.    o <Path>
  2753.    o <Filename>
  2754.    o <Unit>
  2755.    o <DiskOffset>
  2756.    o <Sector>
  2757.    o <Track>
  2758.  
  2759. -----------------------------------------------------------------------------
  2760. Argument:
  2761.  
  2762.      <Value>, <Count>, <Offset>, <Entries per row>, <TrapNumber>,
  2763.      <BreakpointNumber>, <Length>, <SectorAmount>, <TrackAmount>, <Sync>,
  2764.      <DMA-Length>,<BitShift>,<Rawkey>
  2765.  
  2766. Description:
  2767.  
  2768.      These arguments are the base for almost every other argument. The
  2769.      argument parser supports many operators (listed below). The operator
  2770.      priority is 'left-assigned' or is defined by the used operator (see
  2771.      prefs setting). The base for any input is 10(dec) or 16(hex) (see prefs
  2772.      setting).
  2773.  
  2774.    o Simple values:
  2775.       o '!' <digits> : Parse digits following in dec-mode(base 10) (eg.
  2776.         '!123456789', '!10'='$a')
  2777.       o '$' <digits> : Parse digts following in hex-mode (base 16) (eg.
  2778.         '$44899521', '$10'='!16')
  2779.       o '%' <digits> : Parse digts following in bin-mode (base 2);dots are
  2780.         skipped for a better overview (eg. '%1111'='$f',
  2781.         '%00001111.11110000.00000000.11111111'='$0ff000ff')
  2782.       o '\<CPU-REG>' : The value of the specfied register is returned. The
  2783.         '\' is necessary if specified in the preferences. See the R command
  2784.         for available cpu-register.
  2785.       o '"<ascii-digits>"' : The value of the ascii-string is returend (eg.
  2786.         "A"='$41',"ABCD"='$41424344')
  2787.       o <labelname> : The value of the label is returned
  2788.    o Unary operators:
  2789.       o '~' <Value> : Exor following value (eg. '~$ff'='$ffffff00')
  2790.       o '+' <Value> :Do not negate following value, dummy operator (eg.
  2791.         '+$100'='$100')
  2792.       o '-' <Value> : Negate following value (eg '-1'='$fffffffe')
  2793.       o '{' <Value>, '*' <Value>: Dereference following value. The longword
  2794.         at <Value> is fetched. (eg. '*4'=*execbase)
  2795.    o Unary end operators:
  2796.       o <Value> '.B' : Extend <Value> from byte to longword (signed
  2797.         operation) (eg. '$80.b='$ffffff80')
  2798.       o <Value> '.W' : Extend <Value> from word to longword (signed
  2799.         operation) (eg. '$8000.w'='$ffff8000')
  2800.       o <Value> '.L' : Extend <Value> from longword to longword (dummy
  2801.         operation)
  2802.    o Binary operators (first operator in list has the lowest priority, the
  2803.      last one has the highest)
  2804.       o <Value1> = <Value2>, <Value1> == <Value2> : If <Value1> is the same
  2805.         as <Value2> result is 1 (true), else 0(false) (eg. '!10==$10' is
  2806.         false, '!10==$a' is true)
  2807.       o <Value1> != <Value2> : If <Value1> is the not the same as <Value2>
  2808.         result is 1 (true), else 0(false) (eg. '!10!=$10' is true, '!10!=$a'
  2809.         is false)
  2810.       o <Value1> < <Value2> : If <Value1> is less (signed) than <Value2>
  2811.         result is 1 (true), else 0(false) (eg. '!10<$10' is true)
  2812.       o <Value1> <= <Value2> : If <Value1> is less same (signed) than
  2813.         <Value2> result is 1 (true), else 0(false) (eg. '!10<=$10' is true)
  2814.       o <Value1> > <Value2> : If <Value1> is greater (signed) than <Value2>
  2815.         result is 1 (true), else 0(false) (eg. '$10>!10' is true)
  2816.       o <Value1> >= <Value2> : If <Value1> is greater same (signed) than
  2817.         <Value2> result is 1 (true), else 0(false) (eg. '$a>=!10' is true)
  2818.       o <Value1> && <Value2> : If <Value1> and <Value2> are true the result
  2819.         is 1 (true), else 0(false) (eg. '0&&1' is false)
  2820.       o <Value1> || <Value2> : If <Value1> or <Value2> is true the result is
  2821.         1 (true), else 0(false) (eg. '1||0' is true)
  2822.       o <Value1> & <Value2> : The result is <Value1> (bitwise) and <Value2>
  2823.         (eg. '$101&$ff'='1')
  2824.       o <Value1> ! <Value2> : The result is <Value1> (bitwise) or <Value2>
  2825.         (eg. '$101!$ff'='$1ff')
  2826.       o <Value1> ~ <Value2> : The result is <Value1> (bitwise) xor <Value2>
  2827.         (eg. '$101~$ff'='$1ff')
  2828.       o <Value1> + <Value2> : The result is <Value1> plus <Value2> (eg.
  2829.         '2+4'='6')
  2830.       o <Value1> - <Value2> : The result is <Value1> minus <Value2> (eg.
  2831.         '2-4'='-2')
  2832.       o <Value1> * <Value2> : The result is <Value1> multiplied with <Value2>
  2833.         (eg. '2*4'='8')
  2834.       o <Value1> / <Value2> : The result is <Value1> divided by <Value2> (eg.
  2835.         '5/2'='2')
  2836.       o <Value1> % <Value2> : The result is the rest of <Value1> diveded by
  2837.         <Value2> (eg. '5%2'='1')
  2838.       o <Value1> << <Value2> : The result is <Value1> shifted by <Value2>
  2839.         bits left (eg. '1<<!31'='$80000000')
  2840.       o <Value1> >> <Value2> : The result is <Value1> shifted by <Value2>
  2841.         bits right (eg. '$80000000>>!31'='1')
  2842.       o <Value1> ^ <Value2> : The result is <Value1> to the power of <Value2>
  2843.         (eg. '2^!31'='$80000000')
  2844.  
  2845. Example:
  2846.  
  2847.       o *4 ; address of execbase
  2848.       o *((*(*4+$9c)+$17c)+$28) ; cuurent beamcon0
  2849.       o (2+3*4==2+(3*4)) ; is true if operator priority is enabled
  2850.  
  2851. -----------------------------------------------------------------------------
  2852.  
  2853. Argument:
  2854.  
  2855.      <Address>, <Start>, <End>, <Destination>, <Source>
  2856.  
  2857. Description:
  2858.  
  2859.      These arguments are parsed the same like <Value>. The received address
  2860.      is then validated. If the address conflicts with the the current
  2861.      memory-mode (see prefs setting) it will report an error. If eg. <Start>
  2862.      and <End> is used then <End> must be higher than <Start> and both must
  2863.      be in a continous memory-block. (eg not from $1f0000 to $f80000 -
  2864.      depends on the mmeory-mode!)
  2865.  
  2866. Example:
  2867.  
  2868.       o $10000+4*100
  2869.  
  2870. -----------------------------------------------------------------------------
  2871. Argument:
  2872.  
  2873.      <String>,<Labelname>
  2874.  
  2875. Description:
  2876.  
  2877.      A plain string can be started either with " or a ' and must of course
  2878.      end with it. However, if you do not use ",' the string will be
  2879.      uppercased and will terminate at the first space or tab.
  2880.  
  2881. Example:
  2882.  
  2883.       o "amiga"
  2884.       o "amiga'
  2885.       o amiga ; identicall to "AMIGA"
  2886.  
  2887. -----------------------------------------------------------------------------
  2888. Argument:
  2889.  
  2890.      <StringPattern>
  2891.  
  2892. Description:
  2893.  
  2894.      The argument <StringPattern> is just a <String> which holds some special
  2895.      symbols. The following wildcards are available: '?' (single wild-char)
  2896.      and '*','#?' (multiple wild-chars). The pattern is incasesensitive.
  2897.  
  2898. Example:
  2899.  
  2900.       o '*dir'
  2901.  
  2902. -----------------------------------------------------------------------------
  2903.  
  2904. Argument:
  2905.  
  2906.      <Bytes>
  2907.  
  2908. Description:
  2909.  
  2910.      The argument is usually use for searching mutliple bytes. <Bytes> is
  2911.      build up of multiple <Value> or <strings> seperated by a space. The
  2912.      value must be given is hex-mode! Only the low bytes of a value is used.
  2913.      However, strings will be converted to multiple bytes.
  2914.  
  2915. Example:
  2916.  
  2917.       o $45 45 ; same as 45 45
  2918.       o 45 890 45 ; same as 45 90 45
  2919.       o "password" 00
  2920.       o "diskname" 0 "sync" $0a $00 ; searches what it means!
  2921.  
  2922. -----------------------------------------------------------------------------
  2923.  
  2924. Argument:
  2925.  
  2926.      <PBytes>
  2927.  
  2928. Description:
  2929.  
  2930.      The argument is given in the same ways as in argument <Bytes>. If the
  2931.      parsed value (byte sized) included a '?' the upper/lower nibble is
  2932.      marked as a wildcard.
  2933.  
  2934. Example:
  2935.  
  2936.       o ?? 00; same as if you would search just $00
  2937.       o "d" ?? ?? ".library" ; will find eg 'dos.library'
  2938.       o 8? ?? ?? ?8 "SXI!"
  2939.       o "diskname" ?? "sync" $?? $00 ; searches what it means!
  2940.  
  2941. -----------------------------------------------------------------------------
  2942.  
  2943. Argument:
  2944.  
  2945.      <Range>
  2946.  
  2947. Description:
  2948.  
  2949.      The argument <Range> is build up of a list of <Address>. If the argument
  2950.      <Range> is not used all available memory pages are scanned. A single
  2951.      address as argument means that the scan will start at the specfied
  2952.      address (instead of $00000000). A additional (second) address is used to
  2953.      determinate when to stop. (check out the memory setting)
  2954.  
  2955. Example:
  2956.  
  2957.       o <no arg> ; scan all available pages
  2958.       o $80000 ; scan all available pages starting at $80000
  2959.       o $1f8000 $7880000 ; may scan $1f8000-$200000,$7800000-$7880000
  2960.  
  2961. -----------------------------------------------------------------------------
  2962.  
  2963. Argument:
  2964.  
  2965.      <DisassmeblyPattern>
  2966.  
  2967. Description:
  2968.  
  2969.      The argument <DisassemblyPattern> is just a <String> which holds some
  2970.      special symbols. The following wildcards are available: '?' (single
  2971.      wild-char) and '*','#?' (multiple wild-chars). The pattern is
  2972.      incasesensitive. A space is extended to a '*' wildcard. If the parser
  2973.      encounters a '\' it will use the pattern for the next command.
  2974.  
  2975. Example:
  2976.  
  2977.       o "movec ,vbr","MOVEC*,vbr*" ; same pattern
  2978.       o "move.l ,?0" ; finds eg "movea.l $7c.w,a0" but not "movea.l $7c.w,a0"
  2979.         (check out if destination is a address reg!)
  2980.       o "cmp*.l #$????????,*\b*\" ; find eg "cmp.l #$12345678,-$10(a7)\beq.l
  2981.         $80000"
  2982.  
  2983. -----------------------------------------------------------------------------
  2984.  
  2985. Argument:
  2986.  
  2987.      <Path>
  2988.  
  2989. Description:
  2990.  
  2991.      The argument <Path> is just a <String> which holds the device path. If
  2992.      no absolute path is used it is appended to the current path. The path my
  2993.      not point to a file!
  2994.  
  2995. Example:
  2996.  
  2997.       o "df0:tk/","df0:tk" ; absolute path
  2998.       o "tk" ; relative to the current path
  2999.  
  3000. -----------------------------------------------------------------------------
  3001.  
  3002. Argument:
  3003.  
  3004.      <Filename>
  3005.  
  3006. Description:
  3007.  
  3008.      The argument <Filename> is just a <String> which holds the filename. If
  3009.      no absolute path is used it is appended to the current path. The
  3010.      filename may not point to a directory!
  3011.  
  3012. Example:
  3013.  
  3014.       o "df0:tk.exe" ; absolute path
  3015.       o "tk.exe" ; relative to the current path
  3016.  
  3017. -----------------------------------------------------------------------------
  3018.  
  3019. Argument:
  3020.  
  3021.      <DiskOffset>
  3022.  
  3023. Description:
  3024.  
  3025.      The argument <DiskOffset> is just a <Value> which addresses the diskdata
  3026.      as one continous memory block. It must be lower than $dc0000
  3027.      (DD-Disk)/$1b8000(HD-Disk).
  3028.  
  3029. Example:
  3030.  
  3031.       o !880*200 ; root block (DD)
  3032.       o $c ; eg read data from diskoffset !12 (bootblock code)
  3033.  
  3034. -----------------------------------------------------------------------------
  3035.  
  3036. Argument:
  3037.  
  3038.      <Unit>
  3039.  
  3040. Description:
  3041.  
  3042.      The argument <Unit> is just a <Value> which determinats the drive to be
  3043.      used. <Unit> can only be 0(DF0),1(DF1),2(DF2),3(DF3).
  3044.  
  3045. Example:
  3046.  
  3047.       o 0 ; "df0:" (what to say else??)
  3048.  
  3049. -----------------------------------------------------------------------------
  3050.  
  3051. Argument:
  3052.  
  3053.      <Sector>
  3054.  
  3055. Description:
  3056.  
  3057.      The argument <Sector> is just a <Value> which addresses data on a disk.
  3058.      It must be lower than 1760(DD-Disk)/3520(HD-Disk). A sector has a size
  3059.      of $200 bytes.
  3060.  
  3061. Example:
  3062.  
  3063.       o !880 ; root.-block
  3064.  
  3065. -----------------------------------------------------------------------------
  3066.  
  3067. Argument:
  3068.  
  3069.      <Track>
  3070.  
  3071. Description:
  3072.  
  3073.      The argument <Track> is just a <Value> which addresses data on disk. It
  3074.      must be lower than 80(DD/HD-Disk). A track consists of
  3075.      11(DD-Disk)/22(HD-Disk) sectors. So a track has a length of $2c00/$5800
  3076.      bytes.
  3077.  
  3078. Example:
  3079.  
  3080.       o !80 ; track with root-block (DD)
  3081.  
  3082. -----------------------------------------------------------------------------
  3083.  
  3084. Thrill Kill - How to make a NMI-button
  3085. -----------------------------------------------------------------------------
  3086.  
  3087. If you want to use TK you must have a NMI-button, else you will not be able
  3088. to enter TK at any point, because the software patches are usually eliminated
  3089. by eg NDOS-programms. If you have never soldered anything try to find someone
  3090. who can do it for you, though its very easy (in my opinion..) You need the
  3091. following stuff:
  3092.  
  3093.    o 1 x button (on/off)
  3094.    o 3 x diodes (no special type required, (at least 10V/100mA, i think) eg
  3095.      1N4148, 1N4001-7 or any universial diode)
  3096.    o some wires and the usual equipment to solder
  3097.  
  3098. You must connect a ground signal to one pin of the button and the other
  3099. button pin to every cathode of thediodes and from their anodes to the IPL0,
  3100. IPL1, IPL2 signal, so quite easy. (If the instruction for your computer is
  3101. missing do it yourself or find someone...). Make sure that the black ring of
  3102. the diodes point to the button and not to the ipl lines. It should look like
  3103. this
  3104.  
  3105.    o IPL0 ----------------------- |>| ----\
  3106.    o IPL1 ----------------------- |>| ------------ BUTTON ----- GROUND
  3107.    o IPL2 ----------------------- |>| ----/
  3108.  
  3109. Note: '..--|>|--..' is a diode which anode is left and cathode is right!
  3110.  
  3111. LAST WARNING! NO WARRANTY FOR ANY INSTRUCTION LISTED BELOW!! LAST WARNING!
  3112.  
  3113. A1200:
  3114.  
  3115.    o I would advise to use the internal 150-pin expansion connector.The
  3116.      ipl-lines are at pin 81, 82, 83 and the ground is eg at pin 79 (take a
  3117.      look at your A1200 manual for verification). If you have a cpu-card
  3118.      installed try so solder on the connector of it.
  3119.      The expansion connector looks like this:
  3120.  
  3121.                                  ...|IPL1|...
  3122.                                       |
  3123.      (upper half) |2|4|6|8|..........|82|......|148|150|
  3124.      (lower half) |1|3|5|7|.......|79|81|83|...|147|149|
  3125.                                    /   |   \
  3126.                             ...|GROUND|IPL0|IPL2|...
  3127.  
  3128.      (PIN 81) IPL0 ------- |>| ----\
  3129.      (PIN 82) IPL1 ------- |>| ------- BUTTON --- GROUND (PIN 79)
  3130.      (PIN 83) IPL2 ------- |>| ----/
  3131.  
  3132. A4000 (and maybe A3000):
  3133.  
  3134.      I would advise to use the internal 200-pin expansion connector of the
  3135.      cpu-card, because all other connectors do not support the ipl-signals
  3136.      (including the Zorro2/3 slots!!). Unfortunatly, i have not found a
  3137.      description where all signals are described with correct pin numbers, so
  3138.      i will just give a exact pin-location. If you have a manual where the
  3139.      pins are described try to contact me. You should solder on the upper
  3140.      side (the one where the connector pins are soldered to the card). The
  3141.      following instructions were tested on a A4000 with a 68030 and 68040
  3142.      original cpu card. It should also work with the cyberstorm cards! (not
  3143.      tested yet!, no warranty!)
  3144.      The expansion connector looks like this:
  3145.  
  3146.      /--------------------------------------------------------------\
  3147.      |                                                              |
  3148.      |   x x x x ... x x x x x x x x x       x x x x ... x x x x    |
  3149.      |    x x x x ... x x I J K x x x x       x x x x ... x x x x   |
  3150.      | O x x x x ... x x x x x x x x x       x x x x ... x x x x  O |
  3151.      |    x x x x ... x x x x x x x x         x x x x ... x x x G   |
  3152.      |                                                              |
  3153.      | ()                                                        () |
  3154.      .                                                              .
  3155.      .                                                              .
  3156.      | ()                                                        () |
  3157.      \--------------------------------------------------------------/
  3158.  
  3159.      I,J,K: IPL signals, G:GROUND signal
  3160.  
  3161.      I(IPL) ------- |>| ----\
  3162.      J(IPL) ------- |>| ------- BUTTON --- G (GROUND)
  3163.      K(IPL) ------- |>| ----/
  3164.  
  3165.      BTW: I use this hardware patch!
  3166.  
  3167. A500/A2000:
  3168.  
  3169.    o I would advise to use the external 86-pin expansion connector.The
  3170.      ipl-lines are at pin 40, 42, 44 and the ground is eg at pin 37 (take a
  3171.      look at your A500 manual for verification).
  3172.      The expansion connector looks like this:
  3173.  
  3174.                             ...|IPL0|IPL1|IPL2|...
  3175.                                    \  |   /
  3176.      (upper half) |2|4|6|8|.......|40|42|44|.....|84|86|
  3177.      (lower half) |1|3|5|7|....|37|..............|84|85|
  3178.                                 |
  3179.                           ...|GROUND|...
  3180.  
  3181.      (PIN 40) IPL0 ------- |>| ----\
  3182.      (PIN 42) IPL1 ------- |>| ------- BUTTON --- GROUND (PIN 37)
  3183.      (PIN 44) IPL2 ------- |>| ----/
  3184.    o The internal 86-pin-MMU-connector of the A2000 has the same pin
  3185.      assignment as the A500 86-pin connector. However if want to use a
  3186.      Zorro2-slot then you need just to connect the EINT7-signal (pin 40)
  3187.      directly via a button to a ground signal (eg pin 37). Take a look at
  3188.      your A2000 manual for verification.
  3189.  
  3190. -----------------------------------------------------------------------------
  3191.  
  3192. Thrill Kill - Registration/Demo limits/How to order
  3193. -----------------------------------------------------------------------------
  3194.  
  3195. If you run the demo version the following restrictions are active:
  3196.  
  3197.    o No write operations are possible (SM,MFMW,SE,SA,WT,WS,WD,..)
  3198.    o No external trainer buffer! (TB,TBD)
  3199.    o No deep-trainer! (TDS/TDC)
  3200.    o Assembling is not possible! (A)
  3201.    o The demo version is basically a crippled standard version of TK
  3202.    o Max 10 entries into TK, then TK will lock you system. You will have to
  3203.      do a reset to get out!
  3204.  
  3205. If you register you can decide between two versions available, the standard
  3206. and the professional. The professional versions includes some commands which
  3207. are used very seldom or need special equipment (eg a working mmu). The
  3208. following commands are only available in the professional version:
  3209.  
  3210.    o All mmu functions (MMUV,MMUS,MMUSW,MMUD,MMUDA)
  3211.    o A dis-/assembler for special code (A,D)
  3212.    o Commands for direct-ram-freezing (LA,SA)
  3213.    o Any programm launched from system can be catched before execution
  3214.      ;4m(CATCHFILE)
  3215.    o Find disassembly allows multiple line matching (FD)
  3216.    o Probably find special code (FC) (but not with my lib!)
  3217.  
  3218. Notice the following rules:
  3219.  
  3220.    o The money can only be send to my bank-account (no mail-queues etc..)
  3221.    o You pay in advance, then you get the software
  3222.    o You should contact me before sending the money
  3223.    o I prefer sending the software via e-mail/internet or via modem (the
  3224.      fastest method)
  3225.    o Its not impossible to send TK via snail (ask'n'hope)
  3226.    o If you order from outside germany make sure that the correct amount of
  3227.      german marks will be transfered by your bank
  3228.    o NO WARRANTY FOR ANY DATA LOST BY USING TK !
  3229.  
  3230. If you order please include a short description about your
  3231. system-configuration (not necessary)
  3232.  
  3233.    o cpu
  3234.    o mmu
  3235.    o fpu
  3236.    o memory + its location
  3237.    o amiga model
  3238.  
  3239. The standard version costs 200-DM. Yet i am not sure about the price for the
  3240. professional version, just ask!
  3241. Finally if you want to order contact me (or Goldman) and leave a message with
  3242. your wish. You will receive a bank-account nr to send the money to.
  3243. -----------------------------------------------------------------------------
  3244. Thrill Kill - Yet known bugs
  3245. -----------------------------------------------------------------------------
  3246.  
  3247. The following bugs are yet known:
  3248.  
  3249.   1. No support for graphics-cards, and other kewl equipment. Tk can not
  3250.      support every available hardware.
  3251.   2. TK does not like programms who also use the MMU, especially on 68040++.
  3252.   3. Strange things happen if you access memory higher $0ffffff on some A4000
  3253.      (but not mine :)).. all custom regs are gone and much more. TK gives its
  3254.      best to restore the custom regs, but however its not a magican. (you
  3255.      have to generate an own setting which does not do a memory detect for
  3256.      $1dc00000++)
  3257.   4. TK can not debug programms who misuse the stackpoiner (a general problem
  3258.      of all freezers!)
  3259.   5. The simple NMI-button cause multiple instances of NMIs. They may blow up
  3260.      the internal/external stack.
  3261.  
  3262. -----------------------------------------------------------------------------
  3263.  
  3264. Thrill Kill - History
  3265. -----------------------------------------------------------------------------
  3266.  
  3267.    o Version 1.04:
  3268.       o first real public release
  3269.  
  3270. -----------------------------------------------------------------------------
  3271.  
  3272. Thrill Kill - Contact
  3273. -----------------------------------------------------------------------------
  3274.  
  3275. Information about registration, bug reports, new featues or anything else
  3276. available can be obtained via
  3277.  
  3278.    o e-mail: Leave a message to 'ajunk@uni-paderborn.de' with subject 'TK'
  3279.      and your question. (be very patient...)
  3280.    o WWW: (will be soon available..be patient)
  3281.    o BBS: Call 'Straight Hate' and use the 'c' command to leave me(ferox) or
  3282.      goldman a message (use login:'customer', password:'kill')
  3283.    o IRC: You may find me in one of the following channels: 'AmiElite',
  3284.      'AmigaSCNE', 'Amiga', 'AmigaGER' (my nick is 'ferox')
  3285.      I will try to setup a channel named 'ThrillKill' for TK-support.
  3286.  
  3287. Leave a message to 'Goldman' (my beta-tester NR 1) on a scene bbs (especially
  3288. the Sunflex Inc. boards).
  3289. You may also try to post a message to 'ferox' on some bbs (be warned! i do
  3290. not visit them often).
  3291.  
  3292. -----------------------------------------------------------------------------
  3293.  
  3294. Thrill Kill - Future
  3295. -----------------------------------------------------------------------------
  3296.  
  3297. The following things are (not) planned:
  3298.  
  3299.   1. Improved freezer ability (there are still some games which could be
  3300.      freezed 100%)
  3301.   2. More compatibility (just how..)
  3302.   3. Better OS-filesystem support (to less fun..)
  3303.   4. A better NMI-button hardware (the easy NMI-button has major
  3304.      disadvantages, tough its very easy to implement)
  3305.   5. A amigaguide documentation (Has anyone a html-to-amigaguide converter
  3306.      ??)
  3307.   6. A PPC dis- and assembler (not even started yet)
  3308.   7. A PPC version (not even started yet)
  3309.   8. Maybe a hardware version (but not for the 680x0 versions)
  3310.   9. No picture saver (For what ? Only if really many many would request
  3311.      it...)
  3312.  
  3313. -----------------------------------------------------------------------------
  3314.  
  3315.