FuzzRV

h1. 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).

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

---

h2. Основные команды 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 {}'

 - Упрощённая команда, которая удаляет все остановленные контейнеры, "висящие" образы и неиспользуемые тома.

---

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

Для запуска любого фаззера FuzzRV обычно нужно два Docker-образа:

1. *gcr.io/oss-fuzz/project_name* — конкретный образ с собранным проектом.

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

---

h2. Следующие шаги

[[Fuzzing Spike]] — пример запуска фаззинга для Spike.  

[[Fuzzing ibex64]] — в процессе написания.  

[[Fuzzing picorv32]] — в процессе написания.