# Copyright (C) March 2023- Linaro Limited (or its affiliates). All rights reserved.

# Copyright (C) 1995-2023 Arm Limited (or its affiliates). All rights reserved.

# 
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
               Known problems in GDB-INTEL 7.5
  See also: http://software.intel.com/en-us/forums/intel-many-integrated-core/
              (Organized release by release)

* Wrong variable values are displayed after some watchpoints
* Cannot update variables designated with the "register" hint in C
* For functions with a high parameter count, some floating point parameter values are not displayed correctly
* Inferior calls with floating point arguments cause a segmentation fault
* Unable to call functions with _Decimal64 or _Decimal128 parameters
* No support for reverse execution
* No support for process record files

* Data race detection

 ** Data race detection only supports a single process in stop-all (default) mode.

 ** You may use the "pdbx check" command to help you diagnose and fix common
    setup problems.

 ** When detecting data races in Intel(R) OpenMP programs, beware that the
    following variables need to be defined in the debuggee's environment:

      INTEL_ITTNOTIFY_GROUPS=sync
      INTEL_LIBITTNOTIFY64=""
      INTEL_LIBITTNOTIFY32=""

 ** Make sure that GDB finds the correct version of libpdbx that comes with the
    Intel(R) compiler for the Intel(R) Many Integrated Core (MIC) architecture.
    GDB will otherwise not be able to configure the data race detector or report
    data races.

    The easiest way to achieve this is to copy the Intel compiler's run-time
    support libraries for MIC to GCC's libraries for MIC - both on host and
    target.

    Alternatively, use GDB's "set solib-search-path" to point GDB to the Intel
    compiler's run-time support libraries for MIC on the host.

 ** If the PDBX data race detector does not detect any races, check that you
    compiled (and linked) with -debug parallel and that GDB has loaded the
    symbols for libpdbx.so.5. Use the "pdbx" command to see whether the run-time
    library has been loaded.
