Nsight Compute Command Line Interface - NVIDIA Developer

NSIGHT COMPUTE COMMAND LINE INTERFACE

v2023.3.1 | October 2023

User Manual

TABLE OF CONTENTS

Chapter 1. Introduction.........................................................................................1 Chapter 2. Quickstart........................................................................................... 2 Chapter 3. Usage................................................................................................. 5

3.1. Modes....................................................................................................... 5 3.2. Multi-Process Support.................................................................................... 5 3.3. Output Pages.............................................................................................. 6 3.4. Profile Import............................................................................................. 7 3.5. Metrics and Units......................................................................................... 7 3.6. NVTX Filtering............................................................................................. 7 3.7. Config File................................................................................................ 11 Chapter 4. Command Line Options......................................................................... 13 4.1. General....................................................................................................13 4.2. Launch.....................................................................................................14 4.3. Attach..................................................................................................... 16 4.4. Profile..................................................................................................... 16 4.5. PM Sampling..............................................................................................26 4.6. Warp Sampling........................................................................................... 26 4.7. File......................................................................................................... 27 4.8. Console Output.......................................................................................... 28 4.9. Response File.............................................................................................30 4.10. File Macros.............................................................................................. 30 Chapter 5. Environment Variables.......................................................................... 32 Chapter 6. Nvprof Transition Guide........................................................................ 34 6.1. Trace.......................................................................................................34 6.2. Metric Collection........................................................................................ 34 6.3. Metric Comparison...................................................................................... 36 6.4. Event Comparison....................................................................................... 40 6.5. Filtering................................................................................................... 42 6.6. Output..................................................................................................... 42 6.7. Launch and Attach...................................................................................... 43

Nsight Compute Command Line Interface

v2023.3.1 | ii

LIST OF TABLES

Table 1 General Command Line Options ....................................................................13 Table 2 Launch Command Line Options .....................................................................14 Table 3 Attach Command Line Options ..................................................................... 16 Table 4 Profile Command Line Options ..................................................................... 16 Table 5 PM Sampling Command Line Options .............................................................. 26 Table 6 Warp Sampling Command Line Options ........................................................... 26 Table 7 File Command Line Options .........................................................................27 Table 8 Console Output Command Line Options .......................................................... 28 Table 9 Macro Expansions ..................................................................................... 30 Table 10 Environment Variables .............................................................................. 32 Table 11 Metrics Mapping Table from CUPTI to PerfWorks .............................................. 36 Table 12 Events Mapping Table from CUPTI Events to PerfWorks Metrics for Compute

Capability >= 7.0............................................................................................. 40

Nsight Compute Command Line Interface

v2023.3.1 | iii

 Nsight Compute Command Line Interface

v2023.3.1 | iv

Chapter 1. INTRODUCTION

NVIDIA Nsight Compute CLI (ncu) provides a non-interactive way to profile applications from the command line. It can print the results directly on the command line or store them in a report file. It can also be used to simply launch the target application (see General for details) and later attach with NVIDIA Nsight Compute or another ncu instance. For users migrating from nvprof to NVIDIA Nsight Compute, please additionally see the Nvprof Transition Guide for comparison of features and workflows.

Nsight Compute Command Line Interface

v2023.3.1 | 1

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download