Clean up TritonSan for release (#322)

**This PR refactors TritonSan-related files to prepare the tool for
broader use. Key changes include:**

1. **CMake Option for TritonSan**  
Introduced a new CMake option `TRITON_SAN_ENABLED` (default: `ON`) to
allow users to disable TritonSan build and tests if not needed.

2. **Directory Renaming**  
Renamed the `script` folder to `triton-san` for clarity and consistency.

3. **Unified Build Script**  
Added a single build script `triton-san/build.sh` to streamline the
installation process for users.

4. **Driver Script Template**  
Included a template `triton-san.in` used by `build.sh` to generate the
final `triton-san` driver script, enabling users to launch Triton
programs with TritonSan.

5. **Documentation and Examples**  
Provided a new README and example programs to help users get started
with TritonSan.

6. **Test Suite Updates**  
Updated relevant `lit` tests and added `; REQUIRES: triton-san` to
ensure tests are only run when TritonSan is enabled.

7. **Fix some broken path settings in test/lit.site.cfg.py.in**

8. **Move common utility bash functions into `utility.inc` and include
it into other bash scripts through the `source` command**

9. **Use ANSI escape codes to set the color for status/warning/error
messages**

https://stackoverflow.com/questions/5947742/how-to-change-the-output-color-of-echo-in-linux

Author: lechenyu

CMakeLists.txt

@@ -1,4 +1,5 @@
 option(TRITON_SHARED_BUILD_CPU_BACKEND "Build triton-shared CPU backend" ON)
+option(TRITON_SHARED_BUILD_TRITON_SAN "Build the triton-san sanitizer suite" ON)
 
 set(TRITON_SHARED_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
 set(TRITON_SHARED_BINARY_DIR "${CMAKE_CURRENT_BINARY_DIR}")

README.md

@@ -207,7 +207,7 @@ ll.ir  ll.mlir  tt.mlir  ttshared.mlir
 ```
 
 ## Debugging Triton Programs
-Triton-shared includes a build option that enables LLVM-sanitizers - AddressSanitizer (ASan) and ThreadSanitizer (TSan) - to help detect memory safety and concurrency issues in Triton programs. These sanitizers dynamically analyze the program during execution, identifying bugs such as buffer overflows and data races respectively. For more details and setup instructions, refer [here](https://github.com/microsoft/triton-shared/blob/main/scripts/SANITIZER.md).
+Triton-shared includes a build option that enables LLVM-sanitizers - AddressSanitizer (ASan) and ThreadSanitizer (TSan) - to help detect memory safety and concurrency issues in Triton programs. These sanitizers dynamically analyze the program during execution, identifying bugs such as buffer overflows and data races respectively. For more details and setup instructions, refer [here](triton-san/README.md).
 
 ## Contributing
 

lib/CMakeLists.txt

@@ -2,6 +2,10 @@ add_subdirectory(Analysis)
 add_subdirectory(AnalysisStructured)
 add_subdirectory(Conversion)
 add_subdirectory(Dialect)
-add_subdirectory(Sanitizer)
+
+if(TRITON_SHARED_BUILD_TRITON_SAN)
+  add_subdirectory(Sanitizer)
+endif(TRITON_SHARED_BUILD_TRITON_SAN)
+
 add_subdirectory(Transform)
 add_subdirectory(Utils)

scripts/SANITIZER.md

@@ -1,4 +1,5 @@
-; RUN: %toolsdir/opt -load-pass-plugin %shlibdir/libSanitizerAttributes.so -passes=sanitizer-attributes -sanitizer-type=asan -S %s | FileCheck %s 
+; REQUIRES: triton-san
+; RUN: opt -load-pass-plugin %sanitizer_dir/libSanitizerAttributes.so -passes=sanitizer-attributes -sanitizer-type=asan -S %s | FileCheck %s 
 
 ; ModuleID = 'LLVMDialectModule'
 source_filename = "LLVMDialectModule"

scripts/build_triton_shared_for_sanitizers.sh

@@ -1,4 +1,5 @@
-; RUN: %toolsdir/opt -load-pass-plugin %shlibdir/libSanitizerAttributes.so -passes=sanitizer-attributes -sanitizer-type=tsan -S %s | FileCheck %s 
+; REQUIRES: triton-san
+; RUN: opt -load-pass-plugin %sanitizer_dir/libSanitizerAttributes.so -passes=sanitizer-attributes -sanitizer-type=tsan -S %s | FileCheck %s 
 
 ; ModuleID = 'LLVMDialectModule'
 source_filename = "LLVMDialectModule"