Project

General

Profile

Getting started » History » Revision 2

Revision 1 (Egor Zheliba, 02/10/2025 02:35 AM) → Revision 2/9 (Egor Zheliba, 02/10/2025 02:43 AM)

h1. Getting started 

 1. Установка Чтобы начать работу с FuzzRV, вам понадобится только установленный Docker 

 Скачайте и свободное место на диске (примерно 5–10 ГБ).  

 Скачать Docker и выполните начальную настройку. Подробная "инструкция":https://docs.docker.com/engine/install/ можно по инструкции с официального сайта: 
 https://docs.docker.com/engine/install/ 

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

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

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

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

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

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

 2. Базовые --- 

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

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

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

 <pre> 
 docker image rmi IMAGE_ID 
 </pre> 
 <IMAGE_ID> 
  - Удаляет образ, указываемый по идентификатору. образ с указанным <IMAGE_ID>. 

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

 3. Очистка неиспользуемых ресурсов 

 Можно задать алиас для быстрой очистки всех остановленных контейнеров, «висящих» образов и неиспользуемых томов: 

 <pre> 
 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 {}' 
 </pre> 
  - Упрощённая команда, которая удаляет все остановленные контейнеры, "висящие" образы и неиспользуемые тома. 

 4. --- 

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

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

 5. --- 

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

 Готовые сценарии запуска фаззинга: 
 * [[Fuzzing Spike]] 
 * — пример запуска фаззинга для Spike.   
 [[Fuzzing ibex64]] 
 * — в процессе написания.   
 [[Fuzzing picorv32]] 
 — в процессе написания.