image1d_t, image1d_array_t, image2d_array_t Limited support. User cannot view contents of image types while kernel debugging.

Transcription

1 AMD gdebugger TM 6.2 Release Notes Introduction These release notes describes the changes to AMD gdebugger TM since the previous version. AMD gdebugger TM is an OpenGL and OpenCL debugger and profiler. gdebugger TM traces application activity on top of OpenCL and OpenGL to provide the application behavior information necessary for finding bugs and optimizing application performance. Installation Prerequisites Following Catalyst TM Driver needs to be installed prior to installing gdebugger AMD Catalyst TM Display Driver 11.8 or higher. New Features and Functionality in gdebugger There is now a standalone version of AMD gdebugger TM for Windows and Linux platforms. 2. Supports kernel and API level debugging on AMD Radeon HD 7000 series graphics cards Supports static array types, union variables 4. Supports OpenCL 1.2 with limited functionality. 5. Enhanced GUI and more intuitive GUI for navigation. 6. Combined installer for standalone and Visual Studio plug-in in Windows Version. OpenCL 1.2 Support The following table provides additional details regarding gdebugger TM OpenCL 1.2 supported features. OpenCL 1.2 Kernel Program Changes popcount Double Precision Support Level image1d_t, image1d_array_t, image2d_array_t Limited support. User cannot view contents of image types while kernel debugging. read_image{f i ui h} write_image{f i ui h} get_image_array_size extern and static storage class specifiers Macros CL_VERSION_1_2 & OPENCL_C_VERSION 1 Requires AMD Catalyst Display Driver 12.4 or higher.

2 OpenCL 1.2 Host Program Changes clenqueuemarkerwithwaitlist clenqueuebarrierwithwaitlist clcreateimage clcreatefromgltexture clunloadplatformcompiler clgetextensionfunctionaddressforplatform clenqueuemigratememobjects clcreatesubdevices clretaindevice clreleasedevice Support Level Function calls made with pointers returned from this function will not be shown in the API calls history view, will not be hit as breakpoints, etc. Additional devices are not supported in the gdebugger views. clretaindevice and clreleasedevice are not supported as API breakpoints clenqueuefillbuffer clenqueuefillimage clcompileprogram cllinkprogram Linked programs cannot be debugged. clgetprograminfo clgetprogrambuildinfo clgetkernelarginfo Depreca ted API's Changes to cl_mem_flags Changes to cl_map_flags clenqueuemarker clenqueuebarrier clenqueuewaitforevents clcreateimage2d clcreateimage3d clunloadcompiler clgetextensionfunctionaddress All deprecations are correctly marked and handled.

3 OpenCL 1.2 Changes clcreatefromgltexture2d clcreatefromgltexture3d CL_DEVICE_MIN_DATA_TYPE_ALIGN_SIZE parameter in clgetdeviceinfo Support Level Known Linux Issues and Work Arounds 1. [8882] gdebugger cannot debug OpenGL applications with Catalyst 12.3 on Ubuntu platforms. If Catalyst 12.3 is installed following the directions to create and install the debian files, gdebugger fails to run OpenGL applications. To avoid this issue, install Catalyst using the amd-driver-installer x86[.x86_64].run 2. [8725] Create new project window on Linux may not function correctly during first invocation of gdebugger. Work Around: Launch gdebugger TM Exit without creating new project Make sure the following folders are created.amd/gdebugger before launching the gdebugger TM again. 3. [8500] Cannot find gdb Error shown on the screen during debugging. Work Around: Clicking OK in the dialog prompt will close the warning message. This warning does not impact functionality. 4. [8676] In order for gdebugger 6.2 to run correctly with the KDE Desktop, after installing gdebugger you need to run the qtconfig tool and change the Appearance GUI Style to Cleanlooks. Qtconfig is usually found on Linux machines at /usr/lib[64]qt4/bin/qtconfig 5. [8168] gdebugger hangs (due to a SIGSTOP). In order to work around this issue, you need to do one of the following: run "aticonfig --sb off" (recommended) add the following option in the Device section of your Xorg.conf: Option "BlockSignalsOnLock" "off" 6. [8428] On OpenSuSE, when trying to start gdebugger, it fails with a message about a missing libpng12.so. Be sure to install or copy libpng12.so into the gdebugger installation folder 7. [8750] The text editor does not support the usage of Windows-style line endings (CR+LF) in C/C++ and OpenCL source files. Using them may cause the line numbers in the debug information and text display to be mismatched. To work around, please convert sources to Linux-style line endings (LF). 8. [8773] AMDTTeapot sample requires libgtkglext-x11 library to run on Linux 9. [8471] On Ubuntu, the system definition for the F10 function key overrides the gdebugger settings. This function key will not work for gdebugger unless the user changes the system preference. 10. [8426] Error Message Failed to Terminate Debug Process appears when user tries to stop debugging [Work Around] User can press OK button and continue.

4 11. [8669] gdebugger TM does not hit breakpoint inserted inside the OpenCL Kernel, if no other breakpoints reside inside the Host code. [Work Around] Place a breakpoint inside Host code, i.e. either on any OpenCL or GL API call for example clenqueuendrangekernel. and step through (F11) till kernel break point is hit. Resolved in AMD gdebugger TM 6.2 The following issues have been fixed for the Windows Stand-alone and Visual Studio Extension: 7341 Step through kernel stops working after changing Work Item values Non Sequential behavior when debugging APIs gdebugger skips a line with Step Over in BoxFilterGL kernel box_filter Context link in properties view is not clickable global uint4* is missing from Locals & Multiwatch global uchar4* missing from various views Mandelbrot: Empty error message while debugging mandelbrot_vector_float Variables not showing in Locals view Multi-watch window: Work Item watch pane is too wide Selecting items in Memory view doesn't always affect the gdebugger Properties view array displays wrong in Watch Zoom Level of images and buffers toolbar set to 1000%. Known Issues Common Issues These issues are common to all platforms supported by gdebugger 6033 Crash when querying GL/CL interop buffer 7353 Variables declared with keyword local show hexadecimal value 7095 Occasional non-sequential stepping when debugging some OpenCL kernels int4 variables appear as an unnamed struct in Watch and Locals 8443 local int[] are not handled correctly 8203 Possible slow debugging performance on double precision cards 8396 Locals is showing wrong value of int Crash when amdclinterceptcreatecontext is called with invalid device IDs 8373 wglmakecurrent returns ERROR_BUSY

5 8180 Installer fails on 64 bit Vista 7060 gdebugger doesn't support printf 7360 Multiple calls to the same function in one statement causes non-sequential debugging Stand-alone gdebugger issues, all platforms These issues are seen only in the Stand-alone gdebugger on all platforms Applications with multiple command queues may cause a crash 7849 Performance Dashboard: Performance Counters screen is broken - No profiling features in When a breakpoint is hit the focus is on command prompt instead of the line where the breakpoint was hit 8401 Step out opens document but leaves display blank 8468 Switches window while debugging 8511 Windows flashing while debugging 8561 Views heights don't change when changing the application's height 8813 Frame Step will point to an empty file in the Teapot sample 7933 Select All (Ctrl + A) doesn t work 7973 Wrong variable list in the Locals window while stepping into a function from a kernel 8274 Find: No message when reaching the end of the text file 8276 Toolbar height is changed when adding the "Work Items" toolbar 8283 Language of API is not shown in Call Stack 8298 Images and Buffers toolbar appears when no images are open 8356 gdebugger SA does not properly handle window resize actions 8440 Size of un-docked view is not restored

6 8484 Switching between projects doesn't always update the recent projects list 8560 Delete key doesn't work in OpenGL State Variables view 8570 Breakpoint cannot be disabled on OpenGL Debug Output Extensions Messages 8599 Wrong behavior in Properties view when recording history 8737 Kernel source file folder does not get changed in Debug settings. Known Linux Issues All Platforms These issues are seen on all Linux platforms 8287 Once the debugging process is started then every other gdebugger dialog opens behind gdebugger 8290 Memory View does not show graphs properly 8498 gdebugger explorer is blank when gdebugger is first opened. If you open a project, the Explorer is updated correctly Image view information text overlaps 8648 Second document opened is not placed correctly relative to first document 8676 Users may experience various errors while using gdebugger with the KDE desktop see the Known Linux Issues and Workarounds section for details 8658 Shows blur/grey screen while opening new project 8684 GL Buffers refreshes the whole of gdebugger when opened 8792 Teapot example has wrong Call Stack displayed when breaking on clenqueuendrangekernel 8750 Non Sequential Behavior in OpenCL kernel sources which have both CR and LF in them 8751 gdebugger doesn't show OpenCL 1.2 Deprecated function in statistics 8759 Memory View shows wrong GL objects 8762 gdebugger does not show any logo - gdebugger does not show logo when we do Alt + TAB or when it is minimized 8790 Question marks occasionally appear in Call Stack 8801 Non Sequential behavior whenever at GetEventInfo() and ReleaseEvent() 8802 Watch window occasionally shows wrong value for global variables 8820 Generating an OpenGL Error won t show any message

7 8816 File browser opens behind New Project dialog 8846 Occasionally unable to navigate the contents in gdebugger explorer 8847 gdebugger occasionally hangs when focus is shifted to another application window Debugging does not break at mem_fence(clk_local_mem_fence) function Function Call History does not show OpenGL calls 8860 gdebugger shows grey screen after Alt + Tab 8864 gdebugger shows 0x00000 for global pointers 8868 Assert exception after using the Esc key in the Options dialog 8813 Frame Step will point to an empty file in Teapot sample 8836 Changing the Z coordinate in multi-watch isn t reflected in the Work Item box 8837 gdebugger shows... for work item value 1000 & above 8843 Cannot remove kernel BP while debugging kernel 8848 Export Images and Raw Data under Export Images and Data are not working 8861 Typing full path into browser for executable creates invalid working directory path 8579 Function call statistics graph is too wide 8712 Temporary files are not removed from /tmp on exit from gdebugger 8714 When the user clicks on the link "developer.amd.com" present in "About gdebugger Window", two browser windows start up 8757 gdebugger update notification appears at the left hand top corner 8761 Shared GL context doesn't show shared icon in gdebugger explorer window 8824 Unwanted letters appear in both the smoke and help menus on the right side of the Teapot example 8794 gdebugger check for updates window does not have a close, minimize or restore button 8825 Properties name is not wrapped correctly in Properties view 8830 Exiting gdebugger does not close all open dialogs 8834 "Enable All Breakpoints" link is not synced with its state 8854 Save image option under Export image is always disabled Memory view does not show correct GLbuffer Graphs in Statistics view do not get updated unless is changed to and from other tabs Shrink from full screen still wider than monitor when 4:3 aspect ratio 8850 Rotate Left and Rotate Right shortcuts under Tools Images do not work 8855 If a non-existent log file directory is specified, the error indicates that the Debug Settings Dialog should be consulted rather than the Options Dialog

8 OpenSuSE These issues are seen only on the OpenSuSE platform 8642 Under KDE, four flashes appear in the upper left corner of the screen while launching gdebugger 8805 Under KDE, gdebugger will occasionally show the application terminated when opening Help->About gdebugger dialog Flashing appears while opening CL Buffers The Edit menu option may become incorrectly disabled under some circumstances Under KDE, shows question mark for Project name during launch Flashing appears in the left corner of the source code window while stepping through some kernels 8726 Shows grey Boxes in window - gdebugger shows grey boxes in window. [Please verify could not reproduce with kit 436] 8803 Window switches focus by hovering mouse cursor Blurred/grey screen shown after minimize Ubuntu These issues are only seen on the Ubuntu platform 8426 Error message sometimes appears when trying to stop debugging Occasionally cannot select any work item from the work item combo box 8432 Occasionally the file menu does not show the dropdown list. Known issues for gdebugger Windows standalone version These are known issues only seen with the gdebugger Windows standalone version 8845 gdebugger shows a grey screen for some of the buffers Known issues for gdebugger Visual Studio 2010 Extension These are known issues only seen with the gdebugger Visual Studio 2010 Extension 6663 VBO is unavailable when running Teapot Example System Information is showing wrong system type.

9 7696 BoxFilterGL SDK sample has non-sequential stepping when debugging kernels gdebugger steps through double4 assignments twice clgetextensionfunctionaddressforplatform sometimes gives no source code available CL Buffer 1 is unavailable in OpenCL SDK samples 8874 Cannot change log file directory default location 8829 Modify option doesn't work properly for VS Extension 8875 Cannot uninstall VS Extension using MSI file 6661 Highlight in Memory Analysis graph doesn't always move 6713 During Kernel Debugging, printing variables via command window hangs 6844 Grid zoom in buffer view does not respect VS font preference 7513 Flickering happens when some windows, e.g. System Information, Project Settings and Options, are closed Wrong call stack when stepping out of a kernel with F Run to cursor: two temporary BPs appear and disappear in the BPs view 7813 Variable value not correctly updated when a variable s value is pinned in the code area Statistics view flickers while size is changed In the Statistics view the Calls history tab has empty lines while debugging 8733 gdebugger explorer shows No project loaded while running BinarySearch SDK sample Format list in Buffer display options is incomplete Tooltip is missing for the Step Over/Step into menu items 8872 Wrong information about deprecated version is displayed in statistics view Additional Information How can I avoid "Cannot debug kernel" error? This error message can be displayed for a number of reasons. Below is a list of the most common problems along with possible workarounds. Cause of error Atomic operations that return a value are not currently supported. Affected extensions include: cl_khr_int64_base_atomics, cl_khr_int64_extended_atomics, cl_khr_global_int32_base_atomics, Possible workaround Split kernels that use atomic operations into a separate program to those kernels that do not use atomic operations. This will allow debugging of the kernels that do not use atomic operations.

10 cl_khr_global_int32_extended_atomics, cl_khr_local_int32_base_atomics, cl_khr_local_int32_extended_atomics, cl_ext_atomic_counters_32 and cl_ext_atomic_counters_64. Debugger could not allocate memory. Kernel argument type may not be supported for debugging by driver. Debug application as a 64 bit application to provide greater process memory resources. If this is not possible, try to reduce host memory usage and fragmentation. Alternatively, try to enqueue smaller global work sizes. Remove const qualifiers from kernel arguments. Supported System Requirements and Operating System Refer to: Where to Get Help Search the AMD Developer Knowledge Base for a solution. Visit the AMD Developer Tools Support Forum. Open a support request in AMD Developer Central. More information Support Forum: Website: