home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 10 / 10.iso / l / l353 / 1.img / README.MDB < prev    next >
Encoding:
Text File  |  1991-04-23  |  9.7 KB  |  263 lines
  1.     Copyright (C) 1991 MetaWare Incorporated.  All Rights Reserved.
  2.  
  3.                        MetaWare Debugger Version 1.13
  4.                          for Extended DOS 80386/486
  5.                                   April 1991
  6.  
  7. Table of Contents
  8. -----------------
  9.  
  10. 1.  Contents of the Distribution
  11. 2.  Configuring the Debugger
  12. 3.  Miscellaneous
  13. 4.  PC-NFS Notes
  14. 5.  AutoCAD Development System
  15. 6.  Known Problems
  16. 7.  Other Problems
  17.  
  18.  
  19. 1. Contents of the Distribution
  20. -------------------------------
  21.  
  22.    The following files on your mdb distribution disk make up the actual
  23.    debugger, mdb examples, and on-line documentation: 
  24.  
  25.    readme.mdb         - This file.
  26.    bin\cfigmdb.exe    - Debugger user-interface configuration utility.
  27.                          Operates on the color.db file.
  28.    bin\color.db       - Binary file used by the debugger to specify user-
  29.                          interface colors.
  30.    bin\cx.exe         - Executable file compress utility
  31.    bin\dbglib.rex     - Phar Lap-provided debugger interface library loaded
  32.                          dynamically at run time by mdb.exe.
  33.    bin\mdb.bod        - Text of the debugger's on-line help.
  34.    bin\mdb.cnf        - Debugger driver configuration file.
  35.    bin\mdb.env        - Debugger environment file.
  36.    bin\mdb.exe        - Debugger driver program.
  37.    bin\mdb.idx        - Index file for on-line help.
  38.    bin\mdb.txt        - Menu help file used by the debugger.
  39.    bin\mdb1.cx        - Compressed debugger executable
  40.    bin\mon.exp        - Remote debugging monitor.
  41.    examples\mdb_bad.c - Example program used in debugger tutorial.
  42.    examples\mdb_good.c- Example program used in debugger tutorial.
  43.  
  44. Your mdb distribution disk also contains batch files, scripts and
  45. executable utility programs that we use during the mdb installation.
  46. This group of files is listed below:
  47.  
  48.    bin\cx.exe         
  49.    mw_db.1
  50.    cleanup.bat
  51.    install.bat
  52.    installit.com
  53.    install1.bat
  54.    install2.bat
  55.    find.exe
  56.    mdbser.exe
  57.  
  58. 2.  Configuring the Debugger
  59. ----------------------------
  60.  
  61. *  Debugger configuration file mdb.env and help files.
  62.  
  63.    Set environment variable MDBENV to the location of the mdb.env file,
  64.    and MDBHELP to the directory in which the help files reside.
  65.  
  66.    For example:
  67.  
  68.       set MDBENV=c:\hc386\bin\mdb.env
  69.       set MDBHELP=c:\hc386\bin
  70.  
  71.    By default, the debugger looks for its configuration file (mdb.cnf) and its
  72.    help files (mdb.txt, mdb.bod, and mdb.idx) in the directory in which the
  73.    debugger executable (mdb1.exp) is found.
  74.  
  75. *  To configure run386 command-line switches for the debugger, you may edit
  76.    the mdb.cnf file to set the R386ARGS variable.
  77.  
  78.    If you hit the MS-DOS command-line limit of 128 characters, you may set
  79.    an arbitrary environment variable, say R386, to the desired switches, and
  80.    set mdb.cnf's R386ARGS variable to %R386.  This will cause run386 to read
  81.    the environment variable as part of the command line.  See Phar Lap's
  82.    run386 documentation for more details.
  83.  
  84. *  User-Interface Colors
  85.  
  86.    To change the debugger's user-interface colors, first edit the debugger
  87.    configuration file mdb.env in the \bin directory and set the COLOR variable
  88.    to the location of the color file in the \bin directory.  The debugger will
  89.    use this color file at start-up.  For example:
  90.  
  91.       COLOR=c:\hc386\bin\color.db
  92.  
  93.    Then use program cfigmdb to edit color.db and change the colors.  Just run
  94.    cfigmdb and specify color.db at the Color:Load menu choice.
  95.  
  96. *  Key Macros
  97.  
  98.    Function keys F2 through F9, all the Alt-F keys, and all the Ctrl-F keys
  99.    can be remapped to any command or macro.  Use the Macro:key menu item to
  100.    remap any of these keys during a debugging session, or edit file mdb.env to
  101.    change the defaults.  These key macros can then be invoked from the
  102.    debugger command line.
  103.  
  104. *  Start-Up Macros
  105.  
  106.    To define a group of macros at debugger start-up, edit the debugger
  107.    configuration file mdb.env and set the STARF variable to the location
  108.    of your macro file.  For example:
  109.  
  110.       STARF=c:\hc386\bin\start.mac
  111.  
  112.  
  113. 3.  Miscellaneous
  114. -----------------
  115.  
  116. *  The debugger (mdb) is a protected-mode program; it runs only on an 80386
  117.    or 80486 machine under Phar Lap's 386|DOS-Extender.  To execute the
  118.    debugger, you must have version 2.2b or later of run386.exe available via
  119.    your PATH environment variable.
  120.  
  121. *  RELOAD to debug a program again.
  122.  
  123.    The RELOAD command prepares the currently loaded program to be debugged
  124.    again.  The debugging environment (breakpoints, watch windows, and so on)
  125.    remains unchanged.
  126.  
  127. *  Integer variables are type long.
  128.  
  129.    The size of an integer is machine dependent.  On the 80386, integers are
  130.    four bytes and are mapped to type long by the debugger.
  131.  
  132. *  Setting the minimum heap size for a program.
  133.  
  134.    The KEEPHEAP command displays or sets the minimum initial heap size for a
  135.    program in pages of 4K bytes.  The default is two pages.  Normally, a
  136.    program grows its heap at run time for dynamic memory allocation.  If your
  137.    program is built with the assumption that a large heap will be available at
  138.    start-up, you may use this command to reserve the amount of memory
  139.    necessary for your heap.
  140.  
  141. *  Expression reevaluation for the EXAMINE command and the Symbol:Examine
  142.    window.
  143.  
  144.    REEVALUATE [ON | OFF] enables or disables expression reevaluation for the
  145.    EXAMINE command and the Symbol:Examine window.  If neither ON nor OFF is
  146.    specified, the current state of reevaluation is displayed.
  147.  
  148.    If enabled, examined expressions are reevaluated every time the value of an
  149.    expression may have changed.  Otherwise the expressions are evaluated only
  150.    once and the addresses of the resulting lvalues are watched for a change of
  151.    contents.  By default, REEVALUATE is OFF.
  152.  
  153.    For example,  consider examining the expression foo[i] when i = 3.  With
  154.    REEVALUATE ON, when i changes, a different element of foo will be
  155.    displayed. With REEVALUATE OFF, a change in i will have no effect, and
  156.    foo[3] will still be displayed.
  157.  
  158.  
  159. 4. PC-NFS Notes
  160. ---------------
  161.  
  162.    If PC-NFS is installed and there is a network drive on your path, when you
  163.    invoke the debugger you will get a message about a network error, such as:
  164.  
  165.       Unexpected Network Failure
  166.         Abort, Retry, Fail?
  167.  
  168.    At this point, if you type "f" the debugger will come up normally.  The
  169.    problem is that the code in the debugger driver that searches your path for
  170.    the DOS extender (run386.exe) provokes an error in PC-NFS.  To eliminate
  171.    this inconvenience, you can provide the debugger driver with the full
  172.    pathname of run386.exe, as follows.
  173.  
  174.    Edit the file mdb.cnf in the \bin subdirectory of the directory in which
  175.    you installed the debugger.  Find the line that reads:
  176.  
  177.       #exec  :run386 ...
  178.  
  179.    and replace it with a line that uses the full pathname of run386, in place
  180.    of ":run386":
  181.  
  182.       #exec  drive:full\pathname\of\run386 ...
  183.  
  184.  
  185. 5. AutoCAD Development System
  186. -----------------------------
  187.  
  188. *  AutoCAD ADS users: please read the ADS appendix in the Debugger User's
  189.    Guide and Reference Manual.
  190.  
  191.  
  192. 6.  Known Problems
  193. ------------------
  194.  
  195. *  To ensure optimal performance of the debugger, an updated copy of Phar Lap
  196.    file dbglib.rex is included in this distribution.  To make sure this file
  197.    is referenced when linking, your PATH variable must reference the \bin
  198.    directory BEFORE referencing the Phar Lap directory.
  199.  
  200. *  Graphics debugging is supported only on a VGA monitor with the following
  201.    debugger toggles:
  202.  
  203.       FLIP ON     /* This toggle must be on.  */
  204.       EGA  OFF    /* This toggle must be off. */
  205.  
  206.    Graphics debugging on an EGA monitor is possible, but expect inconsistent
  207.    results, because EGA video cards have some read-only registers that the
  208.    debugger cannot restore.  Be sure to set the toggles as defined above.
  209.  
  210.    EGA Graphics debugging is supported if you are using the TANDEM feature
  211.    of the debugger.
  212.  
  213. *  DOS program share.exe may cause a program load to fail.
  214.  
  215. *  RELOAD might fail under Phar Lap's VMM.
  216.  
  217. *  Multiple breakpoints at one address are not supported.
  218.  
  219. *  CALLSTACK cannot display register-based arguments.
  220.  
  221.    Until we provide extensions to debug records, the debugger's CALLSTACK
  222.    command will not be able to locate register parameters.
  223.  
  224. *  FLIP OFF mode may be confusing when your program requests input.
  225.  
  226.    If you use FLIP OFF to turn off swapping to the output screen after every
  227.    program step, be aware that if your program requests user input you will
  228.    not be able to view the output screen to see the prompt.
  229.  
  230. *  The debugger currently does not work under ERGO Computing's OS/386.  We are
  231.    working with ERGO Computing to get the needed support added to OS/386.
  232.  
  233. *  Reloading AutoCAD kills the debugger.  AutoCAD resets many interrupt
  234.    vectors, and unless it has an opportunity to clean up, the system will be
  235.    very confused.  
  236.  
  237.  
  238. 7.  Other Problems
  239. ------------------
  240.  
  241. If you think you have discovered a debugger problem, send a problem report to
  242. MetaWare Technical Support.  If possible, please send a test case that
  243. demonstrates the problem.
  244.  
  245. All problem reports must include your serial number and specify which version
  246. of the compiler you are using.  If your sample code exceeds 15 lines, please
  247. send it by diskette to the address below, or by E-mail to:
  248.  
  249.    uunet!acad!metaware!tech
  250.              -or-
  251.    Internet tech@metaware.com
  252.              -or-
  253.    INTERNET:tech@metaware.com
  254.  
  255. MetaWare Technical Support can be reached at (408) 429-6111, 8:00 am to 4:30 pm
  256. Monday through Friday.
  257.  
  258.  
  259. MetaWare Incorporated
  260. 2161 Delaware Avenue
  261. Santa Cruz, CA 95060-5706
  262. (408)429-6382  FAX:(408)429-9273
  263.