Nsight Compute Command Line Interface User Manual v2020.4.1 | September 2020 Table of Contents Chapter 1. Profiling Linux Targets from the GUI................................................................ 1 1.1. Connecting to the Target Device.............................................................................................. 1 1.2. System-Wide Profiling Options.................................................................................................3 1.2.1. Linux x86_64....................................................................................................................... 3 1.2.2. Linux for Tegra................................................................................................................... 4 1.3. Target Sampling Options.......................................................................................................... 5 Target Sampling Options for Workstation...................................................................................5 Target Sampling Options for Embedded Linux...........................................................................6 1.4. Hotkey Trace Start/Stop............................................................................................................7 1.5. Launching and Attaching to Processes................................................................................... 7 Chapter 2. Profiling Windows Targets from the GUI...........................................................9 Remoting to a Windows Based Machine........................................................................................ 9 Hotkey Trace Start/Stop...................................................................................................................9 Target Sampling Options on Windows.......................................................................................... 10 Symbol Locations........................................................................................................................... 11 Chapter 3. Profiling Android Targets from the GUI...........................................................12 Configuring Your Android Device...................................................................................................12 Application.......................................................................................................................................13 Chapter 4. Profiling QNX Targets from the GUI................................................................ 15 Chapter 5. Profiling from the CLI...................................................................................... 16 5.1. Installing the CLI on Your Target........................................................................................... 16 5.2. Command Line Options.......................................................................................................... 16 5.2.1. CLI Global Options............................................................................................................17 5.3. CLI Command Switches......................................................................................................... 17 5.3.1. CLI Profile Command Switch Options.............................................................................18 5.3.2. CLI Start Command Switch Options................................................................................30 5.3.3. CLI Stop Command Switch Options................................................................................ 35 5.3.4. CLI Cancel Command Switch Options............................................................................ 35 5.3.5. CLI Launch Command Switch Options........................................................................... 36 5.3.6. CLI Shutdown Command Switch Options....................................................................... 44 5.3.7. CLI Export Command Switch Options.............................................................................45 5.3.8. CLI Stats Switch Options................................................................................................. 46 5.3.9. CLI Status Command Switch Options............................................................................. 51 5.3.10. CLI Sessions Command Switch Subcommands........................................................... 52 5.4. Example Single Command Lines........................................................................................... 52 Nsight Compute Command Line Interface v2020.4.1 | ii 5.5. Example Interactive CLI Command Sequences.................................................................... 53 5.6. Example Stats Command Sequences....................................................................................58 5.7. Example Output from --stats Option..................................................................................... 61 5.8. Importing and Viewing Command Line Results Files...........................................................62 5.9. Using the CLI to Analyze MPI Codes..................................................................................... 64 5.9.1. Tracing MPI API calls.......................................................................................................64 5.9.2. Using the CLI to Profile Applications Launched with mpirun........................................ 64 Chapter 6. Report Scripts...................................................................................................67 Report Scripts Shipped With Nsight Systems.............................................................................. 67 apigpusum[:base] -- CUDA API & GPU Summary (CUDA API + kernels + memory ops)......67 cudaapisum -- CUDA API Summary......................................................................................... 68 cudaapitrace -- CUDA API Trace...............................................................................................68 gpukernsum[:base] -- CUDA GPU Kernel Summary............................................................... 69 gpumemsizesum -- GPU Memory Operations Summary (by Size)..........................................69 gpumemtimesum -- GPU Memory Operations Summary (by Time)....................................... 70 gpusum[:base] -- GPU Summary (kernels + memory operations)..........................................70 gputrace -- CUDA GPU Trace....................................................................................................71 nvtxppsum -- NVTX Push/Pop Range Summary...................................................................... 71 openmpevtsum -- OpenMP Event Summary............................................................................ 72 osrtsum -- OS Runtime Summary............................................................................................ 72 Report Formatters Shipped With Nsight Systems....................................................................... 73 Column........................................................................................................................................ 73 Table.............................................................................................................................................74 CSV...............................................................................................................................................74 TSV............................................................................................................................................... 74 JSON............................................................................................................................................75 HDoc............................................................................................................................................ 75 HTable..........................................................................................................................................75 Chapter 7. Migrating from NVIDIA nvprof..........................................................................76 Using the Nsight Systems CLI nvprof Command.........................................................................76 CLI nvprof Command Switch Options........................................................................................... 76 Next Steps.......................................................................................................................................79 Chapter 8. Profiling in a Docker on Linux Devices............................................................80 Chapter 9. Direct3D Trace..................................................................................................82 9.1. D3D11 API trace......................................................................................................................82 9.2. D3D12 API Trace..................................................................................................................... 82 Chapter 10. WDDM Queues................................................................................................86 Nsight Compute Command Line Interface v2020.4.1 | iii Chapter 11. Vulkan API Trace............................................................................................ 88 11.1. Vulkan Overview.................................................................................................................... 88 11.2. Pipeline Creation Feedback..................................................................................................89