

                        Dbx 4.0
                        WorkShop
=============================================================================
  
Introduction:

Dbx 4.0 is part of the Sun WorkShop.

Dbx 4.0 runs under SunOS (TM) 5.4, or Solaris 2.x.

For complete Operating Environment information, see the WorkShop Global
README.

Table of Contents :
          A. New Features
          B. Changes to Features 
          C. Software Incompatibilities
          D. Current Software Bugs
          E. Fixed Software Bugs
          F. Documentation Errata
          G. Dbx and MT
____________________________________________________________________________

A. New Features

The following new features have been added:
          
___________________________________________________________________________

B. Changes to Features

___________________________________________________________________________

C. Software Incompatibilities


  *  Using older copies of libC.so.5 or libC.so.4 may cause problems for 
     dbx in the area of C<esc>++<\esc> exceptions. Warning messages about
     bad stabs and unhandled exceptions may result.

     Workaround: Link libC statically, remove libC.so.5 and libC.so.4 from
     the system prior to linking, or install the latest libC.so.5 on all
     systems. Patch numbers: 101242-11 for sparc-S2, 102859-02 for intel-S2,
     and 103721-01 for ppc-S2.

  *  Dbx may fail to find files that are accessed through non-generic
     automounter paths. See the "pathmap" command for help in dealing
     with these unusual directory mappings.

  *  The profiling feature of the Collector is broken on the Intel Solaris 2.5
     platform.  Kernel patch 103094-04 fixes this problem.

  *  Run Time Checking (RTC)

        - if "follow_fork_mode" is set to "parent", checking is turned
          off for child processes.  If "follow_fork_mode" is set to
          "child", checking is turned off for the parent process.
 
        - FORTRAN users should compile with the -stackvar option to
          take full advantage of RTC.
        
          Note: some programs may not work properly with -stackvar;
                see the FORTRAN User's Guide and Reference Manual for more
                information.  In such cases, users may wish to try the
                -C compiler option, which will turn on array subscript
                checking without RTC.
 
        - RTC + watchpoints (stop modify) should not be used together.
          There is a multiplicative slowdown effect.
 
        - Use of RTC with the Collector is not allowed.  The code
          inserted by RTC would seriously perturb any performance
          measurements.
 
   * MT applications
         
        - Use of Solaris 2.4 or 2.5 is necessary for multithreaded features to
          operate correctly (Solaris 2.5 is preferred).
 
        - RTC is supported on Solaris 2.4 when the Solaris 2.4 patch
          102224 is installed.
 
        - Follow Fork may be unreliable.
 
        - Watchpoints or "stop modify" requires the dbxenv variable
          "mt_watchpoints" set to 'On'. Use of watchpoints with MT may
          cause the program to hang.
 
        - Use of "call" or printing function calls may cause deadlock
          situations.

______________________________________________________________________________

D. Current Software Bugs
 

     BugId   Synopsis
    ------- -----------------------------------------------------

____________________________________________________________________________

E. Fixed Software Bugs

Bug/Rfe Bug ID    Category   Subcategory    Synopsis
____________________________________________________________________________


____________________________________________________________________________

F. Documentation Errata
 
No known errors at this time.
____________________________________________________________________________

G. Dbx and MT

 * Use of dbx on MT no longer requires the "sunpro.mpmt"
   license feature line for SPARC and the "proworks.mpmt" license
   feature line for X86.
____________________________________________________________________________





