Introduction

Overview

The Kunpeng DevKit command line tool is a toolset that includes the System Migration, Porting Advisor, Affinity Analyzer, Compiler and Debugger, and System Diagnosis tools. This document describes how to obtain, install, and use the Kunpeng DevKit command line tool. The following table lists the supported functions:

**Table 1** Functions supported by the Kunpeng DevKit command line tool
Tool	Description
System Migration	Collects information about installed software including software packages, middleware, and databases in an application system, and analyzes the dependency compatibility in the POM file of a Maven project.
Porting Advisor	Ports software from x86 servers running Linux to Kunpeng servers running Linux, with necessary software scan and analysis capabilities.
Affinity Analyzer	Checks software code on the Kunpeng 920 platform to improve code quality and memory access performance.
Tracer	Parses the user-defined configuration file (.ini) and generates a header file. Users can write header file APIs into program code to record log information. In addition, the Tracer integrates the CTF deserialization function to parse and output log files.
HPC Debugger	Debugs MPI and MPI+OpenMP applications in Launch mode. It must be run using the mpirun command. Debugs MPI and MPI+OpenMP applications in Attach mode. It must use the srun method of the Slurm scheduler.
System Profiler	Collects and analyzes performance data in multiple scenarios, and provides tuning suggestions based on the tuning system.
Python/C Profiler	Samples Python programs and mixed programs of Python and C/C++ and analyzes call stacks.
Java Profiler	Analyzes and optimizes the performance of Java applications running on Kunpeng servers.
System Diagnosis	Analyzes exceptions in applications and sensitive information in files.
Kunpeng Health Inspector	Quickly collects static Kunpeng hardware information to help learn about the overall hardware status before tuning.
JVM Jitter Detector	Monitors the code cache and JIT compiler metrics of Java applications, and generates alarms when detecting any abnormal metrics that could cause performance jitter.
Kunpeng AutoTuner	Automatically tunes application and system parameters to improve application performance metrics in different scenarios.
Kunpeng System Profiler Lite	Collects multi-dimensional performance data with one click, including misses, memory access statistics, NUMA nodes, microarchitecture, miss latency, hotspot functions, CPU usage, NIC bandwidth, I/O, memory usage, and softirq, aligns the data based on the time line, and graphically displays the resource usage from the service layer to the chip layer.

The System Migration, Porting Advisor, Affinity Analyzer, Tracer, and Kunpeng System Profiler Lite tools are available on x86 and Kunpeng 920 servers.
The HPC Debugger, System Profiler, Python/C Profiler, Java Profiler, System Diagnosis, JVM Jitter Detector, Kunpeng Health Inspector, and Kunpeng AutoTuner tools are available only on Kunpeng 920 servers.

System Migration

The System Migration tool collects information about installed software including software packages, middleware, and databases in an application system, and analyzes the dependency compatibility in the POM file of a Maven project.

**Table 2** Function description
Function	Description
Application information collection for system migration	Collects ledger and component information about the software installed in an application system, such as software packages, middleware, and databases.
Maven project source code analysis	Executes the mvn command to invoke the Maven plugin, parses the dependency compatibility in the POM file, and generates an HTML report.

Porting Advisor

The Porting Advisor simplifies the application porting process and supports scanning, analysis, and porting of software from x86 Linux to Kunpeng Linux. This tool can automatically analyze applications and generate guide reports, greatly improving code porting efficiency.

**Table 3** Function description
Function	Description
Source code porting	Analyzes the portability of software written in C/C++/ASM/Fortran/Go or an interpreted language. Checks the C/C++/ASM/Fortran/Go software build project files and provides porting suggestions. Checks the link libraries used by C/C++/Fortran/Go/interpreted language software build project files and provides porting suggestions. Checks the C/C++/ASM/Fortran/Go/interpreted language software source code and provides porting suggestions. The tool supports porting of Fortran source code from the Intel Fortran compiler to the GCC Fortran compiler, and checks of compiler features and syntax extensions. Checks the compatibility of the SO files loaded by the Python/Java/Scala program through the ctypes module. Analyzes some x86 assembly instructions and converts them into equivalent Kunpeng assembly instructions.
Software porting assessment	Analyzes the SO library files in the software installation path in the x86 environment and checks whether these files are compatible with the Kunpeng platform. Checks the shared object (SO) dependency libraries and executable files contained in software packages (RPM, DEB, TAR, ZIP, GZIP, and others) and assesses the portability of these files. Checks the SO dependency libraries and binary files in the Java software packages (JAR, WAR, and EAR) and assesses the portability of these files. Checks the SO dependency libraries and executable files in the specified software installation path and assesses the portability of these files.

Affinity Analyzer

The Affinity Analyzer checks software code to improve code quality and memory access performance. It supports only calculation precision analysis on the x86 platform.

**Table 4** Function description
Function	Description
64-bit running mode check	Identifies the 32-bit applications to be ported to the 64-bit platform and provides modification suggestions. It supports GCC 4.8.5 to GCC 10.3.0.
Byte alignment check	Checks the byte alignment of structure variables in the source code.
BC file generation	A BC file is used for memory consistency check and vectorization check.
Memory consistency check	Checks for any memory consistency problem when the source code is ported to the Kunpeng platform and provides suggestions on inserting memory barriers.
Vectorization check	Checks vectorizable code snippets and provides modification suggestions.
Matricization check	Checks matricizable code snippets and provides modification suggestions.
Build affinity	Analyzes the content in Makefile and CMakeLists.txt that can be replaced with content in the Kunpeng library, and provides replacement suggestions and function repair.
Cache line alignment check	Checks the 128-byte alignment of structure variables in the C/C++ source code to improve memory access performance.
Data race check	Checks for any dynamic memory inconsistency problem when C/C++ source code is running on the Kunpeng platform (specifically Kunpeng 920), and provides the check result and also suggestions on inserting memory barriers.
Calculation precision analysis	Locates the precision differences of the Fortran, C, and C++ languages caused by x86 and Kunpeng instructions.
K-NET data collection and analysis	Collects data during runtime, analyzes and displays function call sequence diagrams, and analyzes POSIX function compatibility.

Tracer

The Tracer parses the user-defined configuration file (.ini) and generates a header file. Users can write header file APIs into program code to record log information. In addition, the Tracer integrates the CTF deserialization function to parse and output log files.

HPC Debugger

The HPC Debugger debugs MPI and MPI+OpenMP applications in Launch mode. It must be run using the mpirun command. Debugs MPI and MPI+OpenMP applications in Attach mode. It must use the srun method of the Slurm scheduler.

System Profiler

The System Profiler is a performance analysis tool for Kunpeng-powered servers. It collects performance data of processor hardware, operating system (OS), processes/threads, and functions, analyzes system performance metrics, locates system bottlenecks and hotspot functions, and provides tuning suggestions.

**Table 5** Function description
Function	Description
Microarchitecture analysis	Obtains the running status of instructions on the CPU pipeline based on Arm performance monitor unit (PMU) events, helping quickly locate performance bottlenecks of the current application on the CPU. You can modify your application to make full use of hardware resources.
HPC application analysis	Collects PMU events of the system and the key metrics of OpenMP and MPI applications to help you accurately obtain the serial and parallel times of the parallel region and barrier-to-barrier, calibrated 2-layer microarchitecture metrics, instruction distribution, L3 usage, and memory bandwidth.
Memory access analysis	Accesses the PMU events of the cache and memory and analyzes the number of storage access times, hit rate, and bandwidth.
NUMA refined analysis	Obtains the refined DDR access, NUMA access bandwidth matrix, and processes' memory access information based on Arm SPE capabilities.
Roofline analysis	Helps pinpoint application bottlenecks on a given hardware platform and optimize the application accordingly.
Hotspot function analysis	Analyzes C/C++ program code, identifies performance bottlenecks, and provides details about the top hotspot functions and call stacks. The tool also displays the function call relationship in flame graphs and provides the tuning path.
Miss event analysis	Uses the Statistical Profiling Extension (SPE) capability to analyze miss events such as LLC Miss, TLB Miss, Remote Access, and Long Latency Load. You can modify your program to reduce the probability of miss events and improve the program processing performance.
Hotspot function analysis (Python/C)	Uses ptrace to sample Python programs and Python & C/C++ hybrid programs, analyzes call stacks, obtains top 20 hotspot functions, and draws flame graphs.

Python/C Profiler

**Table 6** Function description
Function	Description
Hotspot function analysis	Uses ptrace to sample Python programs and Python & C/C++ hybrid programs, analyzes call stacks, obtains top 20 hotspot functions, and draws flame graphs.

Java Profiler

The Java Profiler analyzes and optimizes the performance of Java applications running on Kunpeng servers. The tool identifies hotspot functions, locates performance bottlenecks, and provides tuning suggestions.

**Table 7** Function description
Function	Description
Hotspot analysis	Collects stack information about CPU, CYCLES, LOCK, CACHE_MISSES, and ALLOC events at certain points of time, collects statistics on hotspot methods in the current JVM, and displays the information in a flame graph and an inverted flame graph.

System Diagnosis

The System Diagnosis tool analyzes system running metrics of Kunpeng servers to identify abnormalities, such as memory leak and memory overwriting.

**Table 8** Function description
Function	Description
Memory usage	Collects performance data about memory allocation and release, and checks whether any allocated memory space has not been released.
Memory overwriting	Analyzes memory overwriting problems of applications and provides memory overwriting and access information.

Kunpeng Health Inspector

The Kunpeng Health Inspector is a lightweight and precise tool for collecting static Kunpeng hardware information. It swiftly collects data on server hardware, such as CPUs, memory, network, storage, PCIe, virtual machines (VMs), sensors, software, and module dependencies, and offers performance tuning suggestions based on the collected data.

JVM Jitter Detector

The JVM Jitter Detector tool monitors the code cache and JIT compiler metrics of Java applications, and generates alarms when detecting any abnormal metrics that could cause performance jitter.

CPCA

The Classified Protection and Cryptography Assessment (CPCA) function works based on the System Diagnosis tool. It analyzes cryptographic algorithms that do not comply with CPCA specifications in source code and provides result reports.

Kunpeng AutoTuner

The Kunpeng AutoTuner tool automatically tunes application parameters to improve application performance metrics in different scenarios.

**Table 9** Function description
Function	Description
Generating a template file	Generates a parameter file based on the application and task parameters users set on the interactive user interface.
Enabling automatic tuning	Automatically tunes performance based on the given parameters and performance test result.
Using the tuning result	Apply the tuning result.

Kunpeng System Profiler Lite

The tool collects multi-dimensional performance data with one click, including misses, memory access statistics, NUMA nodes, microarchitecture, miss latency, hotspot functions, CPU usage, NIC bandwidth, I/O, memory usage, and softirq, aligns the data based on the time line, and graphically displays the resource usage from the service layer to the chip layer.

Intended Audience

This document is intended for:

Kunpeng developers
Kunpeng software users
Independent software vendor (ISV) developers