Rename librasan, make crates publishable (#3307)

Author: WorksButNotTested

.github/workflows/librasan-prepare/action.yml renamed to .github/workflows/asan-prepare/action.yml

@@ -1,5 +1,5 @@
-name: Setup QEMU librasan environment
-description: Sets up the QEMU librasan environment
+name: Setup Asan environment
+description: Sets up the Asan environment
 runs:
   using: composite
   steps:

.github/workflows/build_and_test.yml

@@ -164,6 +164,7 @@ jobs:
     strategy:
       matrix:
         instance_idx: [ "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17" ]
+      fail-fast: false
     steps:
       - uses: actions/checkout@v4
       - uses: ./.github/workflows/ubuntu-prepare
@@ -368,10 +369,10 @@ jobs:
           # We want to include the commit hash to ensure the cache is replaced
           # on each new commit.
           key: ${{ github.sha }}
-          # We will only save the cache for one of the builds. Though we could 
+          # We will only save the cache for one of the builds. Though we could
           # just omit this filter and the jobs race to push to the cache, since
-          # they would all share the same key (combining the `shared-key` and 
-          # `key`) our build would generate a load of warnings. Why this 
+          # they would all share the same key (combining the `shared-key` and
+          # `key`) our build would generate a load of warnings. Why this
           # particular fuzzer? No real reason, but we had to choose one.
           save-if: ${{ matrix.fuzzer == 'binary_only/frida_libpng' }}
           cache-all-crates: true
@@ -392,7 +393,7 @@ jobs:
             fuzzers/${{ matrix.fuzzer }}
 
   # This job checks whether any changes have been made to the QEMU code to avoid
-  # rebuilding and testing the QEMU related fuzzers unnecessarily as they are 
+  # rebuilding and testing the QEMU related fuzzers unnecessarily as they are
   # more expensive to build
   qemu-changes:
     runs-on: ubuntu-24.04
@@ -620,22 +621,8 @@ jobs:
         shell: bash
         run: just -d utils/${{ matrix.util }} --justfile utils/${{ matrix.util }}/Justfile test
 
-  # Build and test librasan. The setup is common, so we use a matrix build and
-  # use the task name at the end to select which target to build
-  librasan:
-    name: 🔧 librasan - ${{ matrix.task }}
-    strategy:
-      matrix:
-        task:
-          - build
-          - test
-      # If one task fails, then don't abandon the other
-      fail-fast: false
-    # Only build this if the QEMU code changes for now. Though agnostic, nobody
-    # else has integrated librasan with other fuzzers for now.
-    needs:
-        - qemu-changes
-    if: ${{ needs.qemu-changes.outputs.qemu == 'true' }}
+  libafl_asan:
+    name: 🔧 libafl_asan
     runs-on: ubuntu-24.04
     steps:
       - name: Checkout
@@ -644,44 +631,69 @@ jobs:
           submodules: true
           fetch-depth: 0
       - name: Prepare
-        uses: ./.github/workflows/librasan-prepare
+        uses: ./.github/workflows/asan-prepare
       - name: Configure Cache
         uses: Swatinem/rust-cache@v2
         with:
-          # Use the task name to build the cache key. We will have a separate 
+          # Use the task name to build the cache key. We will have a separate
           # cache for each since they are both expensive to build and one builds
           # for many different architectures.
-          shared-key: librasan-${{ matrix.task }}
+          shared-key: libafl_asan
           # We want to include the commit hash to ensure the cache is replaced
           # on each new commit.
           key: ${{ github.sha }}
           cache-all-crates: true
           # Again the artefacts aren't built in the target root directory.
           workspaces: |
-            libafl_qemu/librasan
-        # Run only for the build task
-      - name: Build
-        if: ${{ matrix.task == 'build' }}
+            libafl_asan
+      - name: Test
         shell: bash
         run: |
           RUN_ON_CI=1 \
           RUSTC_BOOTSTRAP=1 \
           LLVM_CONFIG=llvm-config-${{env.MAIN_LLVM_VERSION}} \
           just \
-            -f ./libafl_qemu/librasan/Justfile \
-            build_everything_dev \
-            build_x86_64_release
-        # Run only for the test task
-      - name: Test
-        if: ${{ matrix.task == 'test' }}
+            -f ./libafl_asan/Justfile \
+            test_everything
+
+  libafl_qemu_asan:
+    name: 🔧 libafl_qemu_asan
+    needs:
+        - qemu-changes
+    if: ${{ needs.qemu-changes.outputs.qemu == 'true' }}
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: true
+          fetch-depth: 0
+      - name: Prepare
+        uses: ./.github/workflows/asan-prepare
+      - name: Configure Cache
+        uses: Swatinem/rust-cache@v2
+        with:
+          # Use the task name to build the cache key. We will have a separate
+          # cache for each since they are both expensive to build and one builds
+          # for many different architectures.
+          shared-key: libafl_qemu_asan
+          # We want to include the commit hash to ensure the cache is replaced
+          # on each new commit.
+          key: ${{ github.sha }}
+          cache-all-crates: true
+          # Again the artefacts aren't built in the target root directory.
+          workspaces: |
+            libafl_qemu/libafl_qemu_asan
+      - name: Build
         shell: bash
         run: |
           RUN_ON_CI=1 \
           RUSTC_BOOTSTRAP=1 \
           LLVM_CONFIG=llvm-config-${{env.MAIN_LLVM_VERSION}} \
           just \
-            -f ./libafl_qemu/librasan/Justfile \
-            test_everything
+            -f ./libafl_qemu/libafl_qemu_asan/Justfile \
+            build_everything_dev \
+            build_x86_64_release
 
   nostd-build:
     runs-on: ubuntu-24.04
@@ -785,7 +797,7 @@ jobs:
           file: ./Dockerfile
           push: ${{ github.ref == 'refs/heads/main' }}
           load: ${{ github.ref != 'refs/heads/main' }}
-          tags: 
+          tags:
             ghcr.io/aflplusplus/libafl:latest
           cache-from: |
             type=registry,ref=ghcr.io/aflplusplus/libafl:cache
@@ -840,7 +852,7 @@ jobs:
       - name: Configure Cache
         uses: Swatinem/rust-cache@v2
         with:
-          # There aren't too many of these fuzzers, so lets just give them a 
+          # There aren't too many of these fuzzers, so lets just give them a
           # separate cache each for now.
           shared-key: fuzzers-windows-${{ steps.fuzzer_name.outputs.fuzzer_name }}-x86_64
           # We want to include the commit hash to ensure the cache is replaced
@@ -919,7 +931,7 @@ jobs:
         run: cargo install cargo-ndk
       - name: cargo android targets
         run: |
-          rustup target add x86_64-linux-android 
+          rustup target add x86_64-linux-android
       - name: Build Android
         env:
           ANDROID_NDK_HOME: ${{ steps.setup-ndk.outputs.ndk-path }}

Cargo.toml

@@ -2,6 +2,9 @@
 resolver = "2"
 members = [
   "libafl",
+  "libafl_asan",
+  "libafl_asan/libafl_asan_fuzz",
+  "libafl_asan/libafl_asan_libc",
   "libafl_bolts",
   "libafl_cc",
   "libafl_concolic/symcc_runtime",
@@ -16,6 +19,7 @@ members = [
   "libafl_tinyinst",
   "libafl_qemu",
   "libafl_qemu/libafl_qemu_build",
+  "libafl_qemu/libafl_qemu_runner",
   "libafl_qemu/libafl_qemu_sys",
   "libafl_sugar",
   "libafl_concolic/test/dump_constraints",
@@ -55,6 +59,8 @@ exclude = [
 [workspace.package]
 version = "0.15.3"
 license = "MIT OR Apache-2.0"
+repository = "https://github.com/AFLplusplus/LibAFL/"
+readme = "./README.md"
 
 [workspace.dependencies]
 # Internal deps

fuzzers/binary_only/qemu_launcher/Cargo.lock

@@ -49,7 +49,7 @@ libafl_bolts = { path = "../../../libafl_bolts", features = [
 ] }
 libafl_qemu = { path = "../../../libafl_qemu", features = [
   "usermode",
-  "rasan",
+  "asan_rust",
 ] }
 libafl_targets = { path = "../../../libafl_targets" }
 log = { version = "0.4.22", features = ["release_max_level_info"] }