home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / CBMDevKit5.dms / CBMDevKit5.adf / DOCS / tooldocs.lha / OtherTools.doc < prev    next >
Encoding:
Text File  |  1993-11-04  |  27.6 KB  |  986 lines
  1. Table of Contents (and reference to other docs):
  2.  
  3. (NOTE: Development Tools and docs "DevTools" archive may be on another disk)
  4.  
  5. ABSLOAD        see DevTools archive
  6. ADDMEM
  7. ALINK        see DevTools archive
  8. ATOM        see DevTools archive
  9. AUTODOC        see DevTools archive
  10. BREAKTASK
  11. BUMPBPR
  12. BUMPREV        see DevTools archive
  13. CARDS        see DevTools archive
  14. CATCOMP        see CatComp.doc
  15. CHARSET
  16. CONFIGDEV
  17. DECIGEL020
  18. DEVLIST
  19. DEVMON        see devmon.doc
  20. DISKED        see disked.doc
  21. DOSLIST
  22. DRIP        see drip.doc
  23. DTEST
  24. EATCYCLES
  25. EATMEM
  26. ENDRUN        see DevTools archive
  27. ENFORCER    see Enforcer.doc and Enforcer1.3.doc
  28. FLUSH
  29. FRAGS
  30. INTLIST        by Carl Sassenrath
  31. IO_TORTURE    see io_torture.doc
  32. KTEST
  33. LAWBREAKER    see Enforcer.doc
  34. LIBLIST
  35. LVO        see lvo.doc
  36. MEMLIST
  37. MEMMON
  38. MEMMUNG       see MUNGWALL which includes MEMMUNG and is more powerful
  39. MEMORATION     by Bill Hawes - see memoration.doc
  40. MEMORYTIDE
  41. MEMWALL       see MUNGWALL which includes MEMWALL and is more powerful
  42. MERGEMEM
  43. MKS_LENS    see mks_lens.doc
  44. MODLIST
  45. MOVE4K        see Enforcer.doc
  46. MUNGLIST    see Mungwall.doc
  47. MUNGWALL    see Mungwall.doc
  48. OWNER        see owner.doc
  49. PEEK
  50. POKE
  51. PRINTA        see DevTools archive
  52. PRINTERTEST    see DevTools archive
  53. READPIXEL
  54. REPORT        see report.doc
  55. ROMWACK
  56. SCRATCH     by Bill Hawes - see scratch.doc
  57. SEGTRACKER    see Enforcer.doc
  58. SETCAMG
  59. SETPARALLEL
  60. SETTASKNAME
  61. SHOWCONFIG
  62. SHOWGFXBASE
  63. SHOWLOCKS    by Charles McManis
  64. SNOOP        see also Mungwall.doc for MUNGWALL SNOOP option
  65. SNOOPSTRIP
  66. SPAREMEM
  67. STRIPA        see DevTools archive
  68. STRIPC        see DevTools archive
  69. SUSHI        see sushi.doc
  70. SYSLOCK        see DevTools archive
  71. SYSPM
  72. TASKLIST
  73. TNT
  74. TSTAT        see tstat.doc
  75. WACK        see wack.doc in wack.lha
  76. WATCHMEM     see ENFORCER instead if you have an MMU !
  77. WEDGE        see wedge.doc
  78. WINLIST
  79. Some other recomended Tools
  80.  
  81.  
  82.  
  83. ADDMEM
  84.  
  85. Format:      ADDMEM <lower-hex-address> <upper-hex-address> [NOCLEAR]
  86.  
  87. Template:    ADDMEM "LOWER-HEX-ADDRESS,UPPER-HEX-ADDRESS,NOCLEAR/S"
  88.  
  89. Purpose:     To link external, non-autoconfigured RAM added to the Amiga's
  90.              system free list.
  91.  
  92. Specification:
  93.  
  94. ADDMEM is used to add external RAM to the Amiga.  The memory is tested and
  95. linked to the system free list.  If the NOCLEAR option is specified, the
  96. memory is not cleared.
  97.  
  98. ADDMEM uses Exec's AddMemList() function, and the external memory is given
  99. the attributes MEMF_PUBLIC|MEMF_FAST.  The priority specified is zero.
  100.  
  101. Example:
  102.  
  103. 1> ADDMEM F00000 F7FFFF
  104.  
  105. adds one-half megabyte of memory.
  106.  
  107. 1> ADDMEM F00000 F40000 noclear
  108.  
  109. adds 256K of memory, without clearing.
  110.  
  111.  
  112.  
  113. ABSLOAD
  114. Format:      ABSLOAD [-D] [-M] [-X] [-S] [-B <Ksize>] [-O <sfile>] [-T<addr>]
  115.          [<lfile>]
  116.  
  117. Template:    ABSLOAD "-D/S,-M/S,-X/S,-S/S,-B/K,-O/K,-T/K"
  118. Purpose:     To convert Amiga loader format to Motorola srecords.
  119. Specification: see DevTools archive
  120.  
  121.  
  122. ALINK
  123.  
  124. Format:      ALINK [FROM <objectfiles>] [WITH <files>] [TO <file>]
  125.          [MAP <file>] [LIBRARY <files>] [VER <file>] [XREF <file>]
  126.          [width <n>]
  127.  
  128. Template:    ALINK "FROM=ROOT,WITH/K,TO/K,LIBRARY=LIB/K,MAP/K,VER/K,XREF/K,
  129.          WIDTH/K"
  130. Purpose:     To link Amiga binary object files into loadable files.
  131. Specification: see DevTools archive
  132.  
  133.  
  134. ATOM
  135. Format:         ATOM <infile> <outfile> [-I]
  136.                 or
  137.          ATOM <infile> <outfile> [-C[C|D|B]] [-F[C|D|B]]
  138.              [-P[C|D|B]]
  139.  
  140. Template:    ATOM "INFILE,OUTFILE,-I/K"
  141.              or
  142.          ATOM "INFILE,OUTFILE,-C/K,-F/K,-P/K"
  143. Purpose:     To specify the portions of a program that should be loaded into
  144.              CHIP memory and/or FAST memory.
  145. Specification: see DevTools archive
  146.  
  147.  
  148. AUTODOC
  149. CATEGORY: Source code autodoc extractor
  150. USAGE:    See accompanying autodoc.doc
  151. USED FOR: Extracting standard function documentation from your source code
  152.  
  153.  
  154. NAME  autodoc - Extracts and sorts autodocs from the given files to stdout.
  155.  
  156. SYNOPSIS
  157.     autodoc [ -tnum ] [ -i ] [ -a ] [ -s ] [ -C ] [ -lnum ] [ -w ]
  158.     [ -c ] [ -f ] [ -r ] [ -Ffile ] [ -I ] file1 [file2] [...]
  159. Specification: see DevTools archive
  160.  
  161.  
  162. BREAKTASK
  163. USAGE:    breaktask Task/CommandName [c][d][e][f] (default is CTRL-C)
  164. USED FOR: Sending a break signal to any task or process.
  165.       Useful with commands that can throw another program into a Wait
  166.       (example Mungwall, Wedge)
  167.  
  168.  
  169. BUMPBPR
  170. USAGE:      bumpbpr ON|OFF [value] (value must be 32,64,128; default is 64)
  171. USED FOR: emulating AA scan line padding on systems without AA chips
  172.       but running V39 (for additional compatibility testing)
  173. From Workbench: Double-click to toggle on and off
  174.  
  175. Emulates the V39+AA rounding up of the BitMap width (BytesPerRow) of Screen
  176. bitmaps and displayable AllocBitMap'd bitmaps of the higher bandwidth modes.
  177. Use on non-AA or non-promoted V39 machines to test for many BytesPerRow
  178. compatiblity problems.  Test with bitmap/screen widths not divisible by 64.
  179.  
  180.  
  181. BUMPREV
  182. CATEGORY: Revision bumper
  183. USAGE:    Bumprev version revname  (example:  bumprev 37 my_rev)
  184. USED FOR: Updating revision include files (xxx_rev.h and xxx_rev.i)
  185. Specification: see DevTools archive
  186.  
  187.  
  188. CARDS
  189.  
  190. Format:         CARDS <cardfile>
  191. Template:    CARDS "CARDFILE/A"
  192. Purpose:     To display the index cards in an ASCII card file.
  193. Specification: see DevTools archive
  194.  
  195.  
  196. CHARSET
  197. USED FOR:  Displaying the Amiga character set and their ASCII values
  198.  
  199.  
  200.  
  201. CONFIGDEV
  202. USED FOR:  Listing expansion boards
  203. SEE ALSO:  SHOWCONFIG (DEBUG Option)
  204.  
  205.  
  206.  
  207. DECIGEL020
  208. USED FOR:  Fixing software that uses MOVE SR
  209.        A software fix for programs that use instructions which
  210.            are priviledged on the 68010/020/030.
  211.        
  212.  
  213. DEVLIST
  214. USED FOR: Listing resident system devices
  215.       Useful with FLUSH when developing a device
  216.  
  217.  
  218. DEVMON
  219. CATEGORY: Device monitor
  220. USAGE:    Devmon name.device unitnum [remote] [hex] [allunits] [full]
  221.     (remote is serial output, full has exec wedges in DoIO, ReplyMsg)
  222. USED FOR: Monitoring or debugging the calls to a device
  223. REQUIRES: Nothing for local monitoring. Serial terminal optional (slower)
  224. WARNINGS: Stresses system if wedged into high-usage or time-critical devices
  225.     (such stress could lead to crashes or hangs)
  226. Specification: see devmon.doc
  227.  
  228.  
  229.  
  230. DISKED
  231.  
  232. Format:         DISKED <device>
  233.  
  234. Template:    DISKED "DEVICE/A"
  235. Purpose:     To inspect and patch disk blocks.
  236. Specification: see disked.doc
  237.  
  238.  
  239. DOSLIST
  240. CATEGORY: Dos device lister
  241. USAGE:    Doslist [DEVS|VOLS|DIRS]
  242. USED FOR: Examining the dos device list
  243.  
  244.  
  245. DRIP
  246.  
  247. Format:         DRIP [<threshold>]
  248. Template:    DRIP "THRESHOLD"
  249. Purpose:     To reveal unrestrained memory allocation or deallocation.
  250. Specification: see drip.doc
  251.  
  252.  
  253. DTEST
  254. CATEGORY: Parallel connection tester
  255. USAGE:    DTest
  256. USED FOR: Checking parallel debugging setup
  257.  
  258.  
  259. EATCYCLES
  260. CATEGORY: Multitasking load test tool
  261. USAGE:    EatCycles (adjust gadgets for desired load)
  262. USED FOR: Testing software behavior under heavy system load
  263.  
  264.  
  265. EATMEM
  266. CATEGORY: Low memory test tool
  267. USAGE:    EatMem (adjust gadgets for desired amount/sizes of free memory)
  268. USED FOR: Testing software behavior under low memory conditions
  269.  
  270.  
  271. ENFORCER
  272. CATEGORY: MMU-based Watchdog tool for V37 and higher.  Most Important Tool.
  273. USED FOR: Trapping reads and writes of low/non-existent memory
  274. REQUIRES: MMU that is not being used, serial terminal, parallel printer,
  275.       file, or SUSHI (see sushi.doc)
  276. see enforcer.doc for more info.
  277.  
  278.  
  279.  
  280. ENFORCER1.3 and ENFORCER1.3.PAR
  281. CATEGORY: MMU-based Watchdog tool for 1.3 and earlier (doesn't work with '040)
  282. USAGE:    Enforcer [off|on|quiet|fprotect]
  283. USED FOR: Trapping reads and writes of low/non-existent memory
  284. REQUIRES: MMU that is not being used, serial terminal, parallel printer,
  285.       or SUSHI (see sushi.doc)
  286.  
  287. ENFORCER1.3.MEGASTACK is a special version of serial ENFORCER.13 which
  288. outputs many lines of stack dump in addition to the usual info.
  289.  
  290. see enforcer1.3.doc for more info.
  291.  
  292.  
  293.  
  294. FLUSH
  295. CATEGORY: Memory flusher (to check for real memory loss)
  296. USAGE:    Flush  (Note - Flush does 3 flushes when invoked)
  297. USED FOR: Flushing all currently unused devices/libraries/fonts from memory
  298.  
  299.  
  300. FRAGS
  301.  
  302. Format:         FRAGS [full]
  303.  
  304. Template:    FRAGS "FULL/S"
  305.  
  306. Purpose:     To display system free memory size distribution.
  307.  
  308. Specification:
  309.  
  310. FRAGS displays Amiga system free memory size distribution.  System free
  311. memory is maintained as a linked list of free regions of varying sizes.  As
  312. memory is dynamically allocated, some larger blocks of free memory may be
  313. fragmented (thus the command name FRAGS).
  314.  
  315. By default, FRAGS shows the number and sizes of the remaining free regions.
  316. If the full option is specified, FRAGS instead shows the fragments for each
  317. separate allocation pool.
  318.  
  319. Notes:
  320.  
  321. 1.The FRAGS program itself must load into memory (thus, frag memory).
  322.  
  323. 2.Large blocks are expressed as a sum of their parts.  For example, the
  324. count for 72 would appear as a 64 and an 8.
  325.  
  326. Example:
  327.  
  328. 1> FRAGS
  329.  
  330. Free memory size distribution:
  331.  
  332. Chip Memory, $420
  333.  
  334.    Size               Count
  335.     8:               6
  336.      16:           12
  337.      32:        8
  338.      64:        5
  339.     128:        5
  340.     256:        2
  341.     512:        1
  342.    1024:        1
  343.    2048:            1
  344.    4096:           0
  345.    8192:               0
  346.   16384:        0
  347.   32768:        0
  348.   65536:        0
  349.  131072:        0
  350.  262144:        0
  351.  
  352.  
  353. INTLIST by Carl Sassenrath
  354. USED FOR: Listing system interrupt nodes
  355.  
  356.  
  357. IO_TORTURE and IO_TORTURE.PAR
  358. CATEGORY: Specialized watchdog for IORequest re-use
  359. USAGE:    IO_Torture
  360. USED FOR: Remote monitoring of premature re-use of IORequests
  361. REQUIRES: Serial terminal or parallel printer
  362. see io_Torture.doc for much more info
  363.  
  364.  
  365. KTEST
  366. CATEGORY: Serial connection tester
  367. USAGE:    KTest
  368. USED FOR: Checking serial debugging setup
  369.  
  370.  
  371. LAWBREAKER
  372. CATEGORY: Test program for Enforcer
  373. USAGE:    Lawbreaker
  374. REQUIRES: Enforcer
  375.  
  376.  
  377. LIBLIST
  378. USED FOR: Listing resident system libraries
  379.       Useful with FLUSH when developing a library
  380.  
  381.  
  382. LVO
  383. CATEGORY: LVO generator, ROM address finder, Wedge-line generator
  384. USAGE:    lvo library [ funcname | lvo=0xhhhh or -n | romaddress=0xhhhhhhhh ]
  385.       Options:  [CONTAINS] [WEDGELINE [wedgeopts]]
  386. REQUIRES: FD: assigned to a directory containg the FD files.
  387. see lvo.doc for usage
  388.  
  389.  
  390. MEMLIST
  391. CATEGORY: Full used and free memory chunk lister
  392. USAGE:    Memlist [>diskfile]
  393. USED FOR: Debugging fragmentation/deallocation problems
  394.  
  395.  
  396. MEMMON
  397. CATEGORY: Memory use recorder (helps narrow search for lost memory)
  398. USAGE:    MemMon (>diskfile)
  399. USED FOR: Producing a commented record of memory usage
  400.  
  401.  
  402.  
  403. MEMMUNG   (See MUNGWALL which includes MEMMUNG and is more powerful)
  404.  
  405. Format:         MEMMUNG
  406. Template:    MEMMUNG
  407. Purpose:     To test for illegal use of memory.
  408.  
  409. Specification:
  410.  
  411. When a block of memory is freed by a task, it is returned to the free memory
  412. pool, and it becomes illegal for any task to access that memory.  However,
  413. every program is not perfect.  Some programs have bugs that try to access
  414. the memory.
  415.  
  416. When MEMMUNG is running, any call to FreeMem() will be intercepted.  First,
  417. the block will be cleared to $4e41, then the normal free will take place.
  418. Since this value is both odd and a Trap #1 instruction, any attempt by a
  419. task to il legally reference the free memory will probably cause a Guru.
  420.  
  421. Location 0 is set to $1e8b4e41 so that any program illegally accessing a
  422. NULL pointer will change behavior.
  423.  
  424. It is possible to use Forbid(), free memory, then use the memory again.
  425. MEMMUNG will allow this.
  426.  
  427. To quit MEMMUNG, either run it again or send it a break by typing Control-C.
  428.  
  429. Example:
  430.  
  431. 1> run MEMMUNG
  432.  
  433. If your software crashes while MEMMUNG is active, your software has a
  434. use-memory-after-free bug.
  435.  
  436.  
  437.  
  438. MEMORATION by Bill Hawes
  439. CATEGORY: Extensive low memory problem testing and torture tool
  440. USAGE:    See doc file
  441. USED FOR: Selectively restricting available memory.  Memoration
  442.       can be used to individually test failure conditions
  443.       on EACH of your program's allocations.  Very useful.
  444. see memoration.doc for much more info
  445.  
  446.  
  447. MEMORYTIDE
  448. CATEGORY: serial memory usage monitor (based on alloc_max by Nicolas Costes)
  449. USAGE: memorytide [ticks]  (default/lowest is 25 ticks)
  450. USED FOR: watching changes of available memory
  451.  
  452. Memorytide checks every 1/2 second (25 ticks) for changes in the amount
  453. of free system memory.  If there has been a change, it outputs the
  454. FAST and CHIP totals and largest to the serial port.
  455.  
  456.  
  457. MEMWALL   (See MUNGWALL which includes MEMWALL and is more powerful)
  458. CATEGORY: Memory allocation overwrite/underwrite monitor
  459. USAGE:    Memwall [all] [fill N] [presize N] [postsize N] [snoop] [supersnoop]
  460. USED FOR: Finding things that write past their allocated memory
  461.     Also for general snooping of memory allocations.
  462. REQUIRES: Serial terminal
  463. WARNINGS: Some things in the system (such as layers) free memory in smaller chunks
  464.     than they allocated.  When this is done, (or when it finds a fill area hit),
  465.     it does NOT let that area actually be deallocated.  This can lead to loss of
  466.     memory.  Note that presize or postsize may be 0.
  467.  
  468.  
  469. MERGEMEM
  470.  
  471.  
  472. Format:      MERGEMEM
  473.  
  474. Template:    MERGEMEM
  475.  
  476. Purpose:     To merge the MemLists of RAM boards.
  477.  
  478. Specification:
  479.  
  480. MERGEMEM attempts to merge the MemLists of sequentially configured RAM
  481. boards that have the same attributes as contiguous expansion RAM.  Memory
  482. from separate RAM boards is usually kept in separate memory pools.
  483. MERGEMEM attempts to merge the separate memory pools into one large pool
  484. for allocation of larger contiguous memory blocks by programs.  MERGEMEM
  485. only merges memory of the same attributes.  Note that 2.0 contains built
  486. in memory merging.
  487.  
  488.  
  489.  
  490. MKS_LENS
  491. USED FOR: Magnifying and examining individual pixels of screen
  492. USAGE:    MKS_lens (use J gadget to jump to next screen)
  493. see mks_lens.doc for more info
  494.  
  495.  
  496. MODLIST
  497. USED FOR: Listing resident system modules
  498.  
  499.  
  500.  
  501. MUNGLIST
  502. CATEGORY: Used memory allocation lister and remunge/check tool
  503. Requires Mungwall. See mungwall.doc
  504.  
  505.  
  506. MUNGWALL, MUNGWALL.PAR
  507.  
  508. CATEGORY: Memory invalidation and memory overwrite/underwrite monitor
  509. USAGE:    Mungwall [UPDATE] [TASK name][WAIT] [NOWAIT]
  510.                    [SNOOP] [NOSNOOP] [INFO]
  511.                    [PRESIZE] [POSTSIZE [FILLCHAR] plus many new options!
  512. USED FOR: Catching accesses of uninitialized and freed memory
  513.     Finding things that write past their allocated memory
  514.     Also for general snooping of memory allocations by one or all tasks
  515.     (See also SnoopStrip for filtering of snoop option output)
  516. REQUIRES: Serial terminal or parallel printer or SUSHI (see sushi.doc)
  517. WARNINGS: Will provoke bad code to crash if not used with Enforcer.
  518. See mungwall.doc for much more info
  519.  
  520.  
  521.  
  522. OWNER
  523. CATEGORY: Memory ownership tool
  524. USAGE:    Owner [0x] nnnn... (owner ? for help)
  525. USED FOR: Trying to determine ownership of allocated memory
  526.       Useful to determine what ROM library a particular
  527.       ROM address resides in (especially if you are crashing
  528.       inside a ROM routine.  Then use LVO to try to find out
  529.       what function you are crashing in).
  530. see owner.doc for more info
  531.  
  532.  
  533. PEEK
  534. USAGE:    Peek B|W|L [0x]address [[0x]compvalue] [[0x]mask]
  535. USED FOR: Checking or script branching on contents of a memory address
  536.  
  537.  
  538. POKE
  539. USAGE:    Peek B|W|L [0x]address [0x]value [[0x]mask]
  540. USED FOR: Changing the contents of a memory address
  541. WARNINGS: Obviously, poking where you shouldn't may crash machine.
  542.  
  543.  
  544. PRINTA
  545.  
  546. Format:         PRINTA <file> [NOHUNK]
  547. Template:    PRINTA "FROM/A,NOHUNK/S"
  548. Purpose:     To print the contents of Amiga binary format files.
  549. Specification: see DevTools archive
  550.  
  551.  
  552. PRINTERTEST
  553.  
  554. Format:         PRINTERTEST
  555.  
  556. Template:    PRINTERTEST
  557. Purpose:     To test the printer.
  558. Specification: see DevTools archive
  559.  
  560.  
  561. READPIXEL
  562. USED FOR: Reading the XY screen location and color of pixels.  Can be
  563.     used to check the size and position of onscreen images.
  564. USAGE:    Readpixel  (then click on pixels to read)
  565.  
  566.  
  567.  
  568. REPORT
  569. USED FOR: Generating Amiga bug reports and enhancement requests in the
  570.       proper format.
  571. USAGE:    report [outfile] [help] (default outfile is ram:Report.txt)
  572.  
  573. Generates Bug Reports, Compatibility Reports, and Enhancement Requests
  574. Specification: see report.doc
  575.  
  576.  
  577. ROMWACK
  578.  
  579. Format:      ROMWACK
  580.  
  581. Template:    ROMWACK
  582.  
  583. Purpose:     To run the Amiga's ROM-resident debugger.
  584.  
  585. Specification:
  586.  
  587. NOTE: ROMWACK is only present in Amiga ROM version through V37
  588.  
  589. ROMWACK is a small, ROM-resident debugger primarily used for system data
  590. structure examination.  All communication is through the RS-232-C serial
  591. data port at 9600 baud.  When ROMWACK is run, the Amiga will be frozen, but
  592. ROMWACK does not disturb the system beyond using a small amount of
  593. supervisor stack (memory between $200 and $400) and the serial port.  Once
  594. enabled, interrupts continue, but multitasking is halted.
  595.  
  596. When ROMWACK is run, a register frame is printed.  The frame includes the
  597. current processor state as well as the system context from which ROMWACK
  598. was involved.  All numbers are treated as hexadecimal.
  599.  
  600. Several key commands are used by ROMWACK:
  601.  
  602. Relative positioning
  603.  
  604.     .        forward a frame
  605.     ,        backward a frame
  606.     >        forward a word
  607.     <         backward a word
  608.     +n        forward n bytes
  609.     -n        backward n bytes
  610.     <RETURN>    redisplay current frame
  611.     <SPACE>        forward a word
  612.     <BACKSPACE>    backward a word
  613.  
  614. Execution Control
  615.  
  616.     go            execute from current address
  617.     resume            resume execution at current PC address
  618.     ^D            resume execution at current PC address
  619.     ^I (<TAB>)        single instruction step
  620.     boot            system cold reset
  621.     ig            system cold reset
  622.  
  623. Breakpoints
  624.  
  625.     set            set breakpoint at current address
  626.     clear            clear breakpoint at current address
  627.     show            show all breakpoint addresses
  628.     reset            clear all breakpoints
  629.  
  630. Other
  631.  
  632.     <hex-address>        set current address to <hex-address>
  633.     =            modify current memory word
  634.     alter            perform a repeated =; <RETURN> to exit
  635.     limit            set current address as the upper bound of find
  636.     find <pattern>        find <pattern> in memory, beginning with the
  637.                 current address and ending with the address
  638.                 set by limit; <pattern> may be from one to
  639.                 four bytes in length
  640.     fill <pattern>        fill memory with <pattern> from the current
  641.                 address to the upper bound address as set by
  642.                 limit
  643.  
  644. Example:
  645.  
  646. 1> ROMWACK
  647. PC: FC08B8  SR: 0010  USP: 01DB54  SSP: 07FFA  SCPT: 0000  TASK: 01C7D0
  648.  
  649. DR: 00000000 0000F803 0001DC68 00000000 0000F803 00000008 0001C748 00000000
  650.  
  651. AR: 000001E8 0001AC30 0000F803 00FF0282 0001DC68 0001DBBC 00000676
  652.  
  653. SF: 00FF 395A 0001 DC68 00FE F8E4 00FE E$C$ 00FF 3470 00FE FA4A 0002 6B98
  654.     0001
  655.  
  656. <RETURN>
  657.  
  658. FC08B8 4E75 007C 2000 518F 40D7 2F7C 00FC 08B8 N u.. |  .. Q.. @.. / |....^H..
  659. :20
  660. FC08B8 4E75 007C 2000 518F 40D7 2F7C 00FC 08B8 N u.. |  .. Q.. @.. / |....^H..
  661. FC08C8 0002 3F7c 0020 0006 4ED5 0CAF 00FC 08AA ..^B? |..  ..^F N..^L......^H..
  662. :4
  663. FC08B8 4E75 007C  N u..  |
  664. >
  665. FC08BA 007C 2000 .. |   ..
  666. +24
  667. FC08DE 00FC 08BA ....^H..
  668.  
  669. See Also:  For a more detailed explanation of ROMWACK, see the 1.3 Amiga ROM
  670. Kernel Manual.
  671.  
  672.  
  673. SCRATCH by Bill Hawes
  674. CATEGORY: Scratch register (D1,A0,A1) invalidation tool
  675. USAGE:    See sample script scratchall.script,  Very important
  676.       for testing assembler code !!!!
  677. USED FOR: Will provoke code with improper register usage to fail
  678. SEE ALSO: scratch.doc AND the script file SCRATCHALL.SCRIPT for usage
  679.       of SCRATCH.  Execute the script to install SCRATCH.
  680.  
  681.  
  682. SEGTRACKER
  683. CATEGORY: Seglist tracker used by other tools (Enforcer, Owner, Mungwall, Tnt)
  684. USAGE:    call early in startup, after SetPatch, to install
  685. See Enforcer.doc for usage, calling conventions
  686.  
  687.  
  688. SETCAMG
  689. CATEGORY: ILBM CAMG mode changer
  690. USAGE: setcamg ilbmname flag [flag flag flag...]
  691. Flags: HIRES LORES LACE HAM HALFBRITE SUPERHIRES
  692.        PAL NTSC PRODUCTIVITY VGA EURO72 DBLPAL DBLNTSC
  693.        Example: setcamg mypicture HIRES HAM LACE
  694.        
  695.  
  696. SETPARALLEL
  697.  
  698. Format:      SETPARALLEL <index> <value>
  699.  
  700. Template:    SETPARALLEL "INDEX/A,VALUE/A"
  701. Purpose:     To allow the CLI user to dynamically change any particular
  702.              parallel port parameter.
  703. Specification:
  704.  
  705. SETPARALLEL allows the user to change the parameters for the parallel port.
  706.  
  707. <index> is a decimal number that specifies the function SETPARALLEL is to
  708. perform, as follows:
  709.  
  710. QUERY     Print current parameter values and indexes without changing them.
  711.  
  712. FLAG    Set ParFlags to <value>.  Valid values are:
  713.     PARF_SHARED         $20    ParFlags non-exclusive access mask
  714.     PARF_RAD_BOOGIE     $08     ParFlags (not yet implemented)
  715.     PARF_EOFMODE        $02    ParFlags EOF mode enabled mask
  716.  
  717. EOF    Set PTermArray to <value>.  Value is interpreted as a long word and
  718.     thus occupies the first 4 bytes of the 8 byte array.  The latter 7
  719.     bytes are propagated with the low order byte (<value> & $FF).
  720.     PTermArray is only used when EOF mode is selected.  Thereafter, each
  721.     input character will then be compared against those in the array.
  722.     If a match if found, the read is terminated.
  723.  
  724. <value> is the number to which to set the <index> parameter. <value> is
  725. decimal unless it starts with X or x, in  which case the number is
  726. interpreted as hexadecimal.  See <index> for determining <value>.
  727.  
  728. Example:
  729.  
  730. 1> SETPARALLEL EOF x51040303
  731.  
  732. 1> SETPARALLEL QUERY
  733. ACTION        FIELD-NAME                HEXADEC        DECIMAL
  734. flag        io_ParFlags =                      22             34
  735. eof        io_PTermArray.PTermArray0 =  51040303        1359217411
  736.         io_PTermArray.PTermArray1 =  03030303         50529027
  737.  
  738.         io_Status =               06              6
  739.  
  740.  
  741. SETTASKNAME
  742. USAGE:    settaskname newname (will be truncated to length of old name)
  743. USED FOR: giving a shell a unique name so that it can be differentiated
  744.           from other shells when debugging.
  745.  
  746.  
  747. SHOWCONFIG
  748. CATEGORY: Motherboard and Autoconfig configuration lister
  749. USAGE:    ShowConfig [debug]
  750. USED FOR: Checking ROM/Processor/Chip versions, and autoconfig devices
  751.       With debug option, for checking all autoconfig params of boards.
  752.  
  753.  
  754.  
  755. SHOWGFXBASE
  756. USED FOR: Examining GfxBase normal display sizes and flags
  757.  
  758.  
  759.  
  760. SHOWLOCKS by Charles McManis
  761.  
  762. Format:         SHOWLOCKS <volumename:>
  763.  
  764. Template:    SHOWLOCKS "VOLUME"
  765.  
  766. Purpose:     To print out the access mode and path for every DOS file lock
  767.          on a particular volume.
  768.  
  769. Specification:
  770.  
  771. SHOWLOCKS prints out the access mode and path for every DOS file lock on a
  772. particular volume.  This is useful for discovering programs that may not
  773. clean up properly and, consequently, leave unwanted locks in the system.
  774.  
  775. Example:
  776.  
  777. Lock Monitor, Copyright 1988 Charles McManis, prints out outstanding locks
  778. on a given volume.  (Lock #0 is the one created by this program)
  779.  
  780. 1> SHOWLOCKS a:
  781.  
  782. ------------------------
  783. --Number----Access--Path
  784. ------------------------
  785.   Lock #0  : -2   'a:'
  786.   Lock #1  : -1   '(exclusive lock):'
  787.   Lock #2  : -1   '(exclusive lock):'
  788.   Lock #3  : -2   'a:devs/printers/Nec_Pinwriter'
  789.   Lock #4  :  0      'a:devs/printers'
  790.   Lock #5  : -2   'a:S'
  791.   Lock #6  : -2   'a:System'
  792.  
  793.  
  794.  
  795. SNOOP
  796. CATEGORY: Remote AllocMem/FreeMem debugger
  797. USAGE:    Snoop (use SnoopStrip on captured output to isolate unfreed Allocs)
  798. USED FOR: Debugging unfreed memory problems
  799. REQUIRES: Serial terminal
  800. NOTES:    Use Mungwall's SNOOP option instead for compatible output
  801.       and ability to restrict reporting to one or more tasks.
  802.  
  803.  
  804. SNOOPSTRIP
  805. USAGE:    SnoopStrip [>outfile] infile
  806. USED FOR: Stripping matched allocs/frees from captured snoop output
  807.  
  808. Use snoopstrip on the captured output of SNOOP or Mungwall SNOOP option
  809. to discard matched allocs/frees and help track down unfreed memory
  810. allocations.
  811.  
  812.  
  813. SPAREMEM
  814. USAGE:    sparemem c=[-]bytes f=[-]bytes [noisy]
  815. USED FOR: limiting available memory in a startup-sequence (for testing)
  816.  
  817.  
  818.  
  819. STRIPA
  820. Format:         StripA [FROM] <sourcefile> [TO] <destinationfile>
  821. Template:    StripA "FROM,TO/A"
  822. Purpose:     To remove debug and symbol hunks from binary load files.
  823. Specification: see DevTools archive
  824.  
  825.  
  826. STRIPC
  827. Format:         StripC <sourcefile> <destinationfile>
  828. Template:    StripC "SOURCEFILE,DESTINATIONFILE"
  829. Purpose:     To remove comments and extraneous white space characters.
  830. Specification: see DevTools archive
  831.  
  832.  
  833. SUSHI
  834. CATEGORY: RAW serial output capture/display tool
  835. USED FOR: to allow use of serial debugging tools and functions
  836.       (debug.lib kprintf) on a single system.
  837. see sushi.doc
  838.   
  839.  
  840. SYSLOCK
  841. CATEGORY: System security utility
  842. USAGE:    SysLock
  843. USED FOR: Locking system with password
  844. See DevTools archive
  845.  
  846.  
  847. SYSPM
  848. CATEGORY: System performance monitor
  849. USAGE:    SYSPM
  850.  
  851. SYSPM show the performance of a priority -10 task, and graphically
  852. shows the percentage of CHIP and FAST ram free on your system.
  853. The priority of the test task can be adjusted with the +/- keys.
  854. The speed of sampling can be adjusted with the </> keys.
  855. Written back when processors wre slower, might not work as well
  856. on fast machines.
  857.  
  858.  
  859. TASKLIST
  860. USED FOR: Listing system tasks
  861.  
  862.  
  863.  
  864. TNT
  865. CATEGORY: Software error trap catcher (for all versions of OS)
  866. USAGE:    TNT  [ force | off | serial ] (must be installed before the crash occurs)
  867. USED FOR: Examining name, registers, PC, SP, of crashed task.  Useful
  868.       to put in your user-startup unless you commonly use CPR or
  869.       another trap-based debugger.  It you crash, you can get
  870.       a lot more information if TNT is installed.
  871.  
  872.       New SERIAL option causes TNT to also output software error
  873.       debugging information to raw serial.
  874.  
  875. WARNING - If you use a single-step debugger, you may have to turn
  876. off TNT since single-step debuggers may use processor traps to
  877. single step.
  878.  
  879.  
  880.  
  881. TSTAT
  882. CATEGORY: Task monitor
  883. USAGE:    Tstat [CLI# | ExecTaskName | CliCommandName] [-tickdelay]
  884.       New options:  MEGASTACK (for larger stack dump)
  885.             NOCTRL (for no CTRL characters in output)
  886.  
  887. USED FOR: Monitoring PC, regs, stack, signals, etc. of a running task
  888.       Displays the task's info as it was when they were switched out.
  889.       Useful as a poor-man's logic state analyzer.  Bump of the
  890.       priority of the shell running TSTAT to get finer granularity
  891.       when watching another task.
  892. see also tstat.doc
  893.  
  894.  
  895. WACK
  896. USED FOR:  Disassembling, tracing, and other debugging
  897. see wack.doc in wack.lha for full explanation of WACK and its macros.
  898.  
  899.  
  900. WATCHMEM (see ENFORCER instead if you have an MMU !)
  901.  
  902. Format:         WATCHMEM [<file>|<window>] [OPT N] [<interval>]
  903.  
  904. Template:    WATCHMEM "TO,OPT/K,INTERVAL"
  905.  
  906. Purpose:     To detect illegal writes to low memory.
  907.  
  908. Specification:
  909.  
  910. WATCHMEM inspects low memory for illegal writes.  If any illegal writes are
  911. detected, WATCHMEM will intercept them and signal you by an alert.  If you
  912. specify the [<file>|<window>] option, WATCHMEM will instead write to a
  913. window, the serial device, or a designated file. [OPT N] will disable the
  914. interception of the illegal write.
  915.  
  916. The [<interval>] option lets you specify the interval at which WATCHMEM
  917. inspects low memory.  The default for this option is 2000 bytes.
  918.  
  919. To stop WATCHMEM, send it a BREAK signal by simultaneously pressing the
  920. Control and the C keys.
  921.  
  922. To activate WATCHMEM from the Workbench, double-click on its icon.  When run
  923. from the Workbench, WATCHMEM inspects low memory at an interval of 2000
  924. bytes and automatically corrects any illegal writes.
  925.  
  926. Examples:
  927.  
  928. 1> WATCHMEM
  929.  
  930. checks low memory for any illegal writes and signals you with an alert.
  931.  
  932. 1> WATCHMEM SER: OPT N
  933.  
  934. runs WATCHMEM as a separate process and sends the output to the serial
  935. device.  The illegal write is not corrected because the N option was
  936. specified.
  937.  
  938. WARNINGS: This processor-based tool can not prevent writes to low memory.
  939.      It can correct them after they occur, but you might crash first.
  940.     If you have an MMU, use Enforcer instead!
  941.  
  942. (WATCHMEM was inspired by the MemWatch program written by John Toebes VIII.)
  943.  
  944.  
  945. WEDGE
  946. CATEGORY: System function monitor - wedge into any system function
  947. USAGE:    Complex and best done with scripts - type Wedge help for help
  948. USED FOR: Monitoring the calls to and results from any system function
  949. REQUIRES: Limited local monitoring, serial or parallel for full monitoring
  950. WARNINGS: Can bog system down; can crash if calling task has tiny stack.
  951.     Local monitoring can cause recursive looping if functions called
  952.     by text output routines are wedged.
  953. SEE ALSO: wedge.doc for much more information, and LVO for
  954.       generating wedge command lines
  955.  
  956.  
  957.  
  958. WINLIST
  959. USAGE:      WinList
  960. USED FOR: Examining addresses, titles, flags, sizes of screens and windows
  961.  
  962.  
  963.  
  964. Some other recomended Tools:
  965.  
  966. METASCOPE
  967.  (by Metadigm)
  968. CATEGORY: Multiwindow Intuition interface symbolic debugger/disassembler
  969. USED FOR: Disassembling, single stepping, breakpointing
  970. WARNINGS: Improper use could lead to a crash.
  971. FOUND IN: Stores (Commercial product)
  972.  
  973.  
  974. CMD
  975. CATEGORY: Parallel/Serial output capture tool
  976. USAGE:    Type cmd help for usage
  977. USED FOR: Debugging printer, serial, and parallel output
  978. FOUND ON: Workbench 2.0
  979.  
  980.  
  981. RCS
  982. CATEGORY: Source/document control
  983. USAGE:    See accompanying docs on Fish Disk 282
  984. USED FOR: Recording changes to source code and documents
  985. FOUND ON: Fish Disk 282
  986.