MindStudio Sanitizer Development Environment Setup, Build, and UT Methods¶

1. Background Knowledge Required¶

For details about the code framework and core process, see the msSanitizer Architecture Design Specifications.

2. Development Environment Setup¶

Set up the environment by referring to the Operator Tool Development Environment Setup Guide.

3. Building and Packaging¶

There are two methods, each with its own advantages and disadvantages:

Method	Application Scenario	Advantages	Disadvantages
One-click script	Initial build and CI/CD pipeline	Zero configuration, one-step setup	A single step cannot be executed independently.
Step-by-step script	Routine development and incremental build	Flexible and efficient	Multiple steps are required.

3.1 Method 1: One-click Script¶

python build.py

3.2 Method 2: Step-by-Step Script¶

3.2.1 Downloading Dependencies¶

python download_dependencies.py

3.2.2 Building and Packaging¶

3.2.2.1 Starting Build¶

Run the following commands to start the build:

mkdir build
cd build
cmake ../cmake
make -j$(nproc)  # -j indicates the number of parallel build jobs, which can be specified as required. If nproc is unavailable, manually enter a number (for example, -j8).

[!NOTE]NOTE
Debug version build
To perform GDB or VS Code graphical breakpoint debugging, build the debug version. The procedure is as follows:
Add -DCMAKE_BUILD_TYPE=Debug when running the preceding CMake command, for example, cmake ../cmake -DCMAKE_BUILD_TYPE=Debug.
[!NOTE]NOTE
CMake parameter issues
Use cmake ../cmake instead of cmake ... Otherwise, the .run installation package will not be generated.

If the generation time of the Ascend-mindstudio-sanitizer-xxx.run file in the output directory is updated to the current build time, the building and packaging are successful.

3.2.2.2 Build Result Description¶

The build result is generated in the output directory:

output/
|-- Ascend-mindstudio-sanitizer-XXX_linux-aarch64.run  # Installation package
|-- bin                                                  # Executable bin file, which can directly call the debugging function
|-- include                                              # API header file
|-- lib64                                                # Various dynamic and static libraries
|-- version.info                                         # Version information

3.2.3 Cleanup/Rebuild¶

Delete the build directory and perform 3.2.2.1.

rm -rf build

4. Running UT¶

4.1 Method 1: One-Click Script¶

python build.py test

4.2 Method 2: Step-by-Step Script¶

4.2.1 Downloading Dependencies¶

python download_dependencies.py test

4.2.2 Running UT¶

[!NOTE]NOTE
CMake entry description for UT
The UT build uses CMakeLists.txt in the root directory (that is, cmake .. instead of cmake ../cmake) of the project. Only the test and dependency are built, and the .run packaging process is not included.

mkdir build_ut
cd build_ut
cmake .. -DBUILD_TESTS=ON
make -j$(nproc) mssanitizer_test # -j indicates the number of parallel build jobs, which can be specified as required. If nproc is unavailable, manually enter a number (for example, -j8).
./test/ut/mssanitizer_test

If the number of executed test cases is the same as the number of passed test cases, the test is successful. The output is similar to the following:

[==========] 912 tests from 139 test cases ran. (46693 ms total)
[  PASSED  ] 912 tests.

4.2.3 Cleanup/Rebuild¶

Delete the build directory and perform 4.2.2.

rm -rf build_ut

5. FAQ¶

5.1 Why Is No .run Package Generated When I Run the make Command During Building?¶

It is possible that cmake .. is used when running the cmake command. The cmake command is described as follows:

cmake ..: Only the current project is built. The make install command installs the project to the output/ directory, but does not call makeself. Therefore, no Ascend-mindstudio-sanitizer-xxx.run file is generated.
cmake ../cmake: The "super build" of cmake/CMakeLists.txt is used. The project is built and installed first, and then parser.py and makeself are executed to generate the .run file in the output/ directory.