Release Notes

Nsight Graphics Release Notes.

Release notes and known issues.

New Features and Capabilities

For a listing of new features and capabilities, see Release Notes for 2020.1 .

Required Display Driver

You must install the NVIDIA display driver that supports the Nsight Graphics tools. If you have an NVIDIA graphics card installed on your target machine, you likely already have an NVIDIA display driver; however, Nsight Graphics requires a specific version of the driver in order to function properly. From the NVIDIA web site, download and install the following display driver:

Windows: Release 441.66 or newer

Linux: Release 440.44 or newer

Deprecations

Deprecated features or operating system support that will be removed in a future release

  • Support for the Windows 7 operating system will be removed in a future release.
  • Support for Windows 10 RS4 will be removed at a future date in conjunction with support of future Windows 10 releases.

Known Issues

General Known Issues

  1. Profiling of systems in an SLI configuration is not supported.

  2. Nsight Graphics requires a network connection to debug applications. This limitation will be addressed in a future release.

  3. Linux users: Applications that launch child processes are not fully supported in Nsight Graphics. This will be improved in a future version.

  4. Serialized projects can fail to compile if range names contain newline characters. This will be handled in a future release. (54263)

  5. The draw call count in the Range Profiler may be larger than the number of draw calls submitted at the API level. This can be caused by the driver optimizing the submitted workload. This will be updated in a future version. (51956)

  6. Under certain conditions, the Range Profiler pane may be disabled and display one of the following messages.

    Hardware signals are not supported in this configuration

    This message could be due to one of the following reasons:

    1. You are running Nsight Graphics with a Kepler or lower GPU.

    2. You are using a defunct or non-NVIDIA GPU.

    3. You are attempting to profile a debug build of the project.

    No hardware signals found for this API/GPU combination

    This message is likely to occur when you are running Nsight Graphics on a non-MSHybrid laptop. (55730)

  7. Nsight Graphics C++ serialization attempts to pick a reasonable default Windows SDK given the content of the capture. On Visual Studio 2015 and later, the SDK may be easily selected as the Target Platform Version property. (53984)

  8. When calculating the histogram for array or cube map resources, the tool only takes into account face 0. As a work around, if you click on a different face, the histogram will be recalculated for that face. In a future version, this will be fixed to take into account all faces. (34403)

  9. If you experience a TDR on either your host or target system, it is recommended that you reboot your machine before trying to restart the debugging session. (22986)

  10. Since the frame scrubber only allows navigation to actions, there may be times when you select a revision for a resource that is not on or near an action. In this case, an earlier revision is selected that is on/near the selected action. This limitation will be addressed in a future version, when the scrubber allows for navigating to any event, not just actions. (26229)

  11. The Frame Scrubber view does not support the nvtxRangeBegin and nvtxRangeEnd functions, only nvtxRangePush and nvtxRangePop. (21499)

  12. Forcing the target application to close through the task manager while in the Frame Debugger may crash the target application.

  13. Windows DPI scaling is not respected in mixed-DPI scenarios with multiple monitors (always keys off main monitor).

  14. Paths with non-UTF8 characters are not supported as a document save location.

OpenGL Known Issues

  1. Using names that are generated by glGen* is advised for performance and correctness. Under normal operation, if an application uses a mix of generated and non-generated names (e.g. via a middleware product), there is the possibility of conflicts/aliases between names. When running an application under Nsight, Nsight will create its own resources that use names generated by the driver, further increasing the likelihood of conflicts. The recommended approach is to always use names that are generated by the driver via glGen*. (30578)

  2. The Pixel value in the tables for the OpenGL profiler represent shaded pixels (i.e., fragments that ran the fragment shader). If color writes are disabled and the fragment shader doesn't write Z, this value may be 0, even though the depth value for a fragment may be written. (22061)

  3. If you are connected to your target using VNC and attempting to debug an OpenGL program, make sure to disable any "Hook" or "Mirror" driver option in the VNC server settings. (20686)

  4. Nsight Graphics may not work correctly unless double buffering is enabled by the application, since GLUT or other toolkits may skip the SwapBuffer calls for a single buffered window. (24590)

Vulkan Known Issues

  1. When running Vulkan applications, you need to leave some memory available for Nsight Graphics to use as staging areas on the GPU. If you get an out of memory warning on the host, this is a hint that you are hitting this problem.

  2. Vulkan support known limitations include:

    • OpenGL interop is not supported (e.g., glDrawVulkanImageNV).

    • There is no HUD.

    • Shader editing is not yet supported.

    • Native shaders are unavailable.

  3. When running a C++ Capture of some large Vulkan applications on Linux, an error may be reported of "Too many resident pages". This can be worked around by adjusting the MAX_RESIDENT_PAGES constant in Helpers.cpp.

Embedded Linux Target Known Issues

  1. GPU debug and profiling tools will not run with "regular" user accounts due to device permissions. In order to use these tools, users must either:

    1. Have the administrator add the user's account to the debug group.
    2. Execute the tool as root, or with the sudo command.

Notices

Notice

ALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES, DRAWINGS, DIAGNOSTICS, LISTS, AND OTHER DOCUMENTS (TOGETHER AND SEPARATELY, "MATERIALS") ARE BEING PROVIDED "AS IS." NVIDIA MAKES NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.

Information furnished is believed to be accurate and reliable. However, NVIDIA Corporation assumes no responsibility for the consequences of use of such information or for any infringement of patents or other rights of third parties that may result from its use. No license is granted by implication of otherwise under any patent rights of NVIDIA Corporation. Specifications mentioned in this publication are subject to change without notice. This publication supersedes and replaces all other information previously supplied. NVIDIA Corporation products are not authorized as critical components in life support devices or systems without express written approval of NVIDIA Corporation.

Trademarks

NVIDIA and the NVIDIA logo are trademarks or registered trademarks of NVIDIA Corporation in the U.S. and other countries. Other company and product names may be trademarks of the respective companies with which they are associated.