Getting started¶

Чтобы начать работу с FuzzRV, вам понадобится только установленный Docker и свободное место на диске (примерно 5–10 ГБ).

Скачать Docker можно по инструкции с официального сайта:
https://docs.docker.com/engine/install/

Для пользователей Linux (Ubuntu/Debian) установка может выглядеть так:

sudo apt update
- Обновляет локальный индекс пакетов.

sudo apt install -y docker.io
- Устанавливает Docker.

sudo systemctl enable docker --now
- Запускает Docker и делает так, чтобы он запускался автоматически при старте системы.

sudo usermod -aG docker <your_username>
- Добавляет пользователя в группу Docker (чтобы можно было работать без sudo).

После этого необходимо перелогиниться или перезайти в систему, чтобы изменения вступили в силу.

---

Основные команды Docker¶

docker images
- Показывает список локально установленных образов.

docker ps -a
- Показывает список контейнеров (включая остановленные).

docker image rmi <IMAGE_ID>
- Удаляет образ с указанным <IMAGE_ID>.

docker rm <CONTAINER_ID>
- Удаляет контейнер с указанным <CONTAINER_ID>.

alias docker-cleanup='docker ps -a -q | xargs -I {} docker rm {}; docker images -q -f dangling=true | xargs -I {} docker rmi -f {}; docker volume ls -qf dangling=true | xargs -I {} docker volume rm {}'
- Упрощённая команда, которая удаляет все остановленные контейнеры, "висящие" образы и неиспользуемые тома.

---

Необходимые образы¶

Для запуска любого фаззера FuzzRV обычно нужно два Docker-образа:
1. gcr.io/oss-fuzz/project_name — конкретный образ с собранным проектом.
2. gcr.io/oss-fuzz-base/base-runner — базовый образ, необходимый для запуска процесса фаззинга. Его можно использовать многократно и не пересобирать лишний раз.

---

Следующие шаги¶

Fuzzing Spike — пример запуска фаззинга для Spike.
Fuzzing ibex64 — в процессе написания.
Fuzzing picorv32 — в процессе написания.