home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / mass61.zip / mass.zip / masm61 / DISK1 / CV.TX$ / CV
Text File  |  1992-12-07  |  12KB  |  296 lines
  1.                                CV.TXT File
  2.  
  3.           Product Information for Microsoft(R) CodeView, Version 4.01
  4.        Copyright (C) 1992, Microsoft Corporation.  All rights reserved.
  5.  
  6.      This document contains release notes for version 4.01 of Microsoft
  7.      CodeView for MS-DOS(R) and Microsoft Windows(TM) operating systems.
  8.  
  9.  
  10.      Remote Debugging with CodeView
  11.      ------------------------------
  12.  
  13.      The required files needed on the host and the remote debugging
  14.      machine are operating-system dependent.
  15.  
  16.      For running CodeView under MS-DOS, the following files must be
  17.      installed on the MS-DOS host. These files are needed for all
  18.      execution models:
  19.  
  20.      - CV.EXE (CodeView kernel)
  21.      - SHD1.DLL (symbol handler)
  22.      - EED1CXX.DLL or EED1CAN.DLL (C++ expression evaluator or ANSI C
  23.        expression evaluator. Only one is needed, but EED1CXX.DLL
  24.        is required for programming with C++.  EED1CXX.DLL is the only
  25.        expression evaluator provided with MASM.)
  26.  
  27.      For remote debugging, you need to include these statements in the
  28.      [RCVCOM] section of your TOOLS.INI file:
  29.  
  30.      parameters: com1:9600
  31.  
  32.      or specify this at the command line:
  33.  
  34.      RCVCOM [-p com1:4800] [-r] [-?]
  35.  
  36.      where [ ] represents an optional parameter. See page 370 in the
  37.      "Environment and Tools" manual for a description of these parameters.
  38.  
  39.      Remote debugging has three limitations:
  40.  
  41.      - You must specify that the shell be exclusive.
  42.  
  43.      - The recommended baud rate is 9600. If you experience any problems,
  44.        try decreasing the baud rate.
  45.  
  46.      - The shell should be specified as full screen.
  47.  
  48.      Specify these settings in a .PIF file or in an MS-DOS session. Use the
  49.      Settings command to specify these settings in an MS-DOS shell.
  50.  
  51.      If you install a CodeView DLL in a directory other than where Setup
  52.      installs it, specify the path of the DLL with the appropriate entry
  53.      in your TOOLS.INI file. For example:
  54.  
  55.      SYMBOLHANDLER:C:\CV4\SHD1.DLL
  56.  
  57.      See also "Configuring CodeView with TOOLS.INI" on page 301, and
  58.      "Remote Debugging" on page 367, both in the "Environment and Tools"
  59.      manual.
  60.  
  61.      The following four sections describe additional files you need for
  62.      specific hosts and targets.
  63.  
  64.  
  65.           DOS-Hosted, DOS-Targeted Debugging: Host Computer
  66.           -------------------------------------------------
  67.  
  68.           If you are not doing remote debugging, these additional files
  69.           must be installed on the host computer for DOS-hosted,
  70.           DOS-targeted debugging:
  71.  
  72.           - EMD1D1.DLL (DOS host/DOS target execution model)
  73.           - TLD1LOC.DLL (local transport layer)
  74.  
  75.           If you are doing remote debugging, these additional files must
  76.           be installed on the host computer for DOS-hosted, DOS-targeted
  77.           debugging:
  78.  
  79.           - EMD1D1.DLL (DOS host/DOS target execution model)
  80.           - TLD1COM.DLL (COM port transport layer)
  81.  
  82.           To specify these transport options, use the TRANSPORT statement
  83.           in your TOOLS.INI file. The path must be specified:
  84.  
  85.           TRANSPORT:C:\CV4\DLL\TLD1COM.DLL COM1:9600
  86.  
  87.           If you do not specify COM#:baud_rate in the TRANSPORT statement,
  88.           CodeView prompts you for it.
  89.  
  90.           You must also add the Native entry to your TOOLS.INI file giving
  91.           the execution model. The path is required:
  92.  
  93.           NATIVE:C:\CV4\EMD1D1.DLL (for DOS host/DOS target execution model)
  94.  
  95.  
  96.           DOS-Hosted, DOS-Targeted Debugging: Target Computer
  97.           ---------------------------------------------------
  98.  
  99.           If you are doing remote debugging, this file must be installed
  100.           on the target computer for DOS-hosted, DOS-targeted debugging:
  101.  
  102.           - RCVCOM.EXE (remote CodeView for COM port)
  103.  
  104.  
  105.           DOS-Hosted, Windows-Targeted Debugging: Host Computer
  106.           -----------------------------------------------------
  107.  
  108.           If you are doing remote debugging, these additional files must be
  109.           installed on the host computer for DOS-hosted, Windows-targeted
  110.           debugging:
  111.  
  112.           - EMD1W0.DLL (DOS host/Windows target execution model)
  113.           - TLD1COM.DLL (COM port transport layer)
  114.  
  115.  
  116.           DOS-Hosted, Windows-Targeted Debugging: Target Computer
  117.           -------------------------------------------------------
  118.  
  119.           If you are doing remote debugging, these additional files must be
  120.           installed on the target computer for DOS-hosted, Windows-targeted
  121.           debugging:
  122.  
  123.           - RCVWCOM.EXE (remote CodeView for COM port)
  124.           - DMW0.EXE (debug monitor on Windows target)
  125.           - TOOLHELP.DLL (Toolhelp)
  126.  
  127.  
  128.      Debugging Locally on an 80286
  129.      -----------------------------
  130.  
  131.      To run CodeView with Windows and debug locally on an 80286 computer,
  132.      these files must be installed on the host computer:
  133.  
  134.      - CVW4.EXE (CodeView kernel)
  135.      - EEW0CXX.DLL (C++ expression evaluator)
  136.      - EEW0CAN.DLL (ANSI C expression evaluator)
  137.      - SHW0.DLL (symbol handler)
  138.      - EMW0W0.DLL (Windows-Windows execution model)
  139.      - TLW0LOC.DLL (local transport layer)
  140.      - TOOLHELP.DLL (Toolhelp)
  141.  
  142.  
  143.      Running CodeView on an 80286 Computer
  144.      -------------------------------------
  145.  
  146.      To run CVW on an 80286 computer, delete CVW.EXE and rename CVW4.EXE as
  147.      CVW.EXE. Local debugging on an 80286 computer with an EGA adapter
  148.      requires a secondary monitor. Single-screen debugging is not supported.
  149.      Local debugging on an EGA requires CodeView to be invoked with the /2
  150.      command-line option.
  151.  
  152.  
  153.      Debugging Code Which Uses 32-Bit Registers
  154.      ------------------------------------------
  155.      
  156.      CodeView does not support single-stepping through code which uses
  157.      the 32-bit registers of the 80386 and higher CPUs, if a DPMI server
  158.      is present.  Windows 3.1 and 386-MAX are examples of DPMI servers.
  159.      In order to single-step through 32-bit code, you must exit Windows or 
  160.      disable your DPMI server and use a VCPI server such as EMM386.EXE to 
  161.      run CodeView.  Alternately, you can use a different debugger such as 
  162.      WDEB386 (available in the Microsoft Windows Software Development Kit).
  163.  
  164.  
  165.      CodeView's Access to Function Code in Libraries
  166.      -----------------------------------------------
  167.  
  168.      The MASM CodeView debugger and linker do not guarantee that the
  169.      name of an .OBJ file is the same name the debugger or linker uses
  170.      to access the function code. To be certain of function access, use
  171.      the /f option when compiling. To avoid problems, do not put code in
  172.      include files. If you do put code into include files, specify the
  173.      function as inline.
  174.  
  175.  
  176.      Unloading DLLs When CodeView Terminates
  177.      ---------------------------------------
  178.  
  179.      You may have applications that use the LoadLibrary function to load
  180.      DLLs to be used by the application. When CVW.EXE terminates or
  181.      restarts such applications, Windows terminates the application without
  182.      unloading DLLs or decrementing the DLL usage count. As a result, DLLs
  183.      still exist in the system. To unload DLLs, you must either exit
  184.      Windows and restart, or use a utility.
  185.  
  186.  
  187.      Removing CodeView 3.07 from SDK Program Manager Group
  188.      -----------------------------------------------------
  189.  
  190.      You can safely remove CodeView 3.07 from your SDK Program Manager 
  191.      group to avoid confusion with the CodeView for Windows provided 
  192.      with MASM or MS C/C++.
  193.  
  194.  
  195.      Unsuccessful Connection to Remote Terminal
  196.      ------------------------------------------
  197.  
  198.      A remote monitor may appear to hang (the screen clears except for 
  199.      the CodeView sign-on banner) when connecting to it from a host that 
  200.      is running the debug kernel. In order to resolve this situation, 
  201.      retry the connection when the debug kernel is not running on the 
  202.      host computer.
  203.  
  204.  
  205.      Running Screen Saver Programs While Debugging
  206.      ---------------------------------------------
  207.  
  208.      Do not run screen savers such as Idlewild or AfterDark while
  209.      debugging, as their interactions with Windows can cause problems
  210.      when debugging.
  211.  
  212.  
  213.      MS-DOS Session Running in a Window Does Not Have Mouse Support
  214.      -----------------------------------------------------------
  215.  
  216.      Running CodeView with the /2 option in an MS-DOS session window does
  217.      not have mouse support. If you want mouse support, change the
  218.      DOS session to full screen.
  219.  
  220.  
  221.      Application I/O When Debugging Can Cause Screen Corruption
  222.      ----------------------------------------------------------
  223.  
  224.      If an application executes an I/O operation when the Flip/Swap
  225.      option is OFF, the screen may be corrupted.
  226.  
  227.  
  228.      Recovering From "Internal Debugger Error"
  229.      -----------------------------------------
  230.  
  231.      If CodeView generates an "Internal debugger error," restart your
  232.      system.
  233.  
  234.  
  235.      Debugging Applications That Use a Mouse
  236.      ---------------------------------------
  237.  
  238.      If you are using CV.EXE in a Windows MS-DOS session, and if you are
  239.      debugging an application that uses or alters the mouse, you must
  240.      specify the CodeView /M option to disable the mouse. This option is
  241.      necessary because the DPMI services provided by Windows 3.x in
  242.      enhanced mode do not allow for saving and restoring the mouse state
  243.      correctly.
  244.  
  245.  
  246.      Setting the Scope of the Show Address Option in CodeView
  247.      --------------------------------------------------------
  248.  
  249.      The printed documentation and Help incorrectly list the
  250.      syntax for setting the scope of the Show Address option in
  251.      the CodeView Command window (OL) as:
  252.  
  253.           OL[<scope>]
  254.  
  255.      instead of:
  256.  
  257.           OL[[<scope>][+|-]].
  258.  
  259.      The + and - switches can be used to turn other options on or
  260.      off, but will cause a syntax error if used to modify the scope
  261.      of the Show Address option.
  262.  
  263.      Several options for the OL command can be chosen at the same time.
  264.      Each time you use the OL command, the scopes you specify will be
  265.      turned on and the scopes you don't specify will be turned off.
  266.      The OL command does not toggle the scopes. For example, the command:
  267.  
  268.           ollfg
  269.  
  270.      turns on lexical, function, and global scope while it turns off module
  271.      and executable scope.
  272.  
  273.  
  274.      Disable the Minimize On Use Option When Debugging
  275.      -------------------------------------------------
  276.  
  277.      Running an application in CodeView for Windows can disable
  278.      mouse and keyboard control if the Minimize On Use option
  279.      is set in the Windows Program Manager.  This behavior occurs
  280.      if you run an application using F5, restart from the Run
  281.      menu, and begin to debug the application. If you experience
  282.      this problem, use CTRL+ALT+SysRq to stop the application,
  283.      issue the WKA command from within Codeview for Windows, and
  284.      choose Exit from the File menu to return to Windows.
  285.  
  286. ===========================================================================
  287.  
  288.  
  289.      Microsoft, MS, MS-DOS, and CodeView are registered trademarks, and
  290.      Windows is a trademark of Microsoft Corporation.  386-MAX is a
  291.      trademark of Qualitas Corporation.
  292.  
  293.      NOTE: Microsoft improves its languages documentation at the time of
  294.      reprinting, so some of the information in this file may already be
  295.      included in your manuals.
  296.