https://github.com/purseclab/fuzzusb

https://github.com/purseclab/fuzzusb

Last synced: 4 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/purseclab/fuzzusb
• Owner: purseclab
• Created: 2022-03-18T03:37:45.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-05-11T04:50:08.000Z (about 2 years ago)
• Last Synced: 2024-01-17T02:06:03.993Z (6 months ago)
• Language: C
• Size: 1.72 MB
• Stars: 29
• Watchers: 4
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Lists

• awesome-fuzz - https://github.com/purseclab/fuzzusb

README

        
# FuzzUSB #

USB gadget fuzzing framework for the Linux kernel.

Please see for the paper and working of the fuzzing:

([FuzzUSB: Hybrid Stateful Fuzzing of USB Gadget Stacks](https://github.com/purseclab/fuzzusb/blob/main/paper/fuzzusb.pdf)).

### Setup

#### initial setup

* https://github.com/google/syzkaller/blob/master/docs/linux/setup.md

* https://github.com/google/syzkaller/blob/master/docs/linux/external_fuzzing_usb.md

#### syzkaller setup

* syzkaller checkout: `d5696d51924aeb6957c19b616c888f58fe9a3740`

* apply syzkaller patch: `patch/syzkaller/README`

* syzkaller rebuild

```

$ ./scripts/build_syz.sh

```

#### Linux kernel setup

* kernel symlink setup

```

$ cd kernel

$ ln -s [target_kernel_dir] target

```

* apply kernel patch: `patch/kernel/README`

* kernel build with gadget enabled config (e.g., `kernel/config`)

```

$ ./scripts/build_kern.sh

```

#### disk image setup

* disk image symlink setup

```

$ cd disk

$ ln -s [target_disk_image] disk.img

```

* additional setup within the image

```

$ apt install python3 usbutils alsa-utils net-tools rsync

```

* copy files to the image: `to_disk/state_mgr.py` 

### Run 

```

$ ./run.sh 

```

NOTE: We will be pushing more soon.