DEBUGO

IBM License Agreement for DEBUGO IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. International Business Machines corporation grants you a license to use the Program only in the country where you acquired it. The Program is copyrighted and licensed (not sold). We do not transfer title to the Program to you. You obtain no rights other that those granted you under this license. Under this license, you may: 1. use the Program on one or more machines at a time; 2. make copies of the Program for use or backup purposes within your Enterprise; and 3. modify the Program and merge it into another program. You must reproduce the copyright notice and any other legend of ownership on each copy or partial copy, of the Program. Except as expressly provided in the DAPTOOLS LIBRARY License Agreement (TOOLIC.TXT), you may NOT: 1. distribute the program in any manner, including through electronic bulletin board systems or other means; 2. sublicense, rent, lease, or assign the Program; and 3. reverse assemble, reverse compile, or otherwise translate the object code of the Program. We do not warrant that the Program is free from claims by a third party of copyright, patent, trademark, trade secret, or any other intellectual property infringement. Under no circumstances are we liable for any of the following: 1. third-party claims against you for losses or damages; 2. loss of, or damage to, your records or data; or 3. economic consequential damages (including lost profits or savings) or incidental damages, even if we are informed of their possibility. Some jurisdictions do no allow these limitations or exclusions, so they may not apply to you. We do not warrant uninterrupted or error free operation of the Program. We have no obligation to provide service, defect correction, or any maintenance for the Program. We have no obligation to supply any Program updates or enhancements to you even in such are or later become available. IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. THIS PROGRAM IS PROVIDED "AS IS" WITHOUT ANY WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. You may terminate this license at any time. We may terminate this license if you fail to comply with any of its terms. In either event, you must destroy all your copies of the Program. You are responsible for the payment of any taxes resulting from this license. You may not sell, transfer, assign, or subcontract any of your rights or obligations under this license. Any atdttempt to do so is void. Neither of us may bring a legal action more than two years after the cause of action arose. If you acquired the Program in the United States, this license is governed by the laws of the State of New York. If you acquired the Program in Canada, this license is governed by the laws of the Province of Ontario. Otherwise, this license is governed by the laws of the country in which you acquired the Program. ----------------------------------------------------------------------------- DEBUGO MONTE COPELAND DEBUGO REVISION HISTORY ---------------------------------------------------------------- 22APR94: search output with / and ^F. Tweak on line help. 04APR94: remove PM listbox; use GPI on display. REXX fixes. 28JAN94: include a REXX sample program for use with Debugo. 10SEP93: cosmetic changes, assertion code out 18JUL93: F-key edits auto-scroll. Larger stack. Debug assertion code is out. C Set optimization is in. 01JUL93: Mouse-a-matic typing: click on an address or symbolic with mouse button 2 and Debugo copies it into the entry field. New INI format, will migrate old INI. Remembers restored window size and position. Fixed double-spaced log output problem. COM port heuristics. See on-line help. Debug version with assertions. 29JUN93: better parser but still not a yacc-generated parser. Now detects undefined typedefs. All detected errors report the line number in the input file. Assertion code in. 15Jun93: fixed a trap when applying H file settings. 20APR93: Delete off top when listbox fills. Tweak Helps. Assertion code out. 04MAR93: Rexx. Debug version with assertions. INI should be compatible with 21OCT92. 21OCT92: four-level function keys; better error checking and reporting, bug fixes, and diagnostic dump for struct support; output window inserts from another thread; log file options in one dialog; clipboard ops only in marking mode; output area erase; double-click on struct list item shows struct; save settings; find INI in current directory only; paint problem; clobbers your 09SEP92 ini. 09SEP92: hang-on-exit fix 03SEP92: initial placement on OS2TOOLS INTRODUCTION ---------------------------------------------------------------- Debugo is PM terminal program especially for use with the OS/2 debug kernel. It makes the debug kernel easier to use. Perhaps the best feature of Debugo is last-command callback. There is also F-key macros, REXX, and programmable function keys. Debugo has point-and-click typing. With the mouse, point to an address or symbolic in the window. Press mouse button two, and Debugo copies the address or symbolic into your next command. Debugo formats memory dumps according to C structs you define using IBM C Set/2 compiler. Throw the /La+ switch on the compiler; it generates a layout file from which Debugo builds a database. With this database, Debugo can format byte dumps as C structs. See the online help. Known bugs are documented in the online help. Monte Copeland, IBM Boca Raton (c) Copyright International Business Machines Corporation, 1992, 1994. All rights reserved. INSTALLATION ---------------------------------------------------------------- . ensure you have configured asynchronous device support on the OS/2 2.x machine which will be the debug terminal. Look in config.sys for DEVICE=\OS2\COM.SYS . If you plan to use Debugo structure dumping, you must set up the Debugo environment as you would your C compiler. Ensure there are proper environment settings for DPATH= PATH= INCLUDE= TMP= . copy debugo.exe into your PATH . copy debugo.hlp into your HELP path . choose a directory from which to start Debugo. Debugo.exe does not have to be in this directory, but CD into that directory before starting Debugo. Debugo will use (or create) DEBUGO.INI in that directory. Rule: Debugo will only use the DEBUGO.INI in the currently-logged process sub-directory. . hit Alt-P and enter port, baud rate, and other parameters. . press F1 for on-line help.