Update C# example (#65)

Co-authored-by: Maksim <popov.md@star.intra.ispras.ru>

Author: sadpepefeelsbad

Examples/Crusher/Linux/csharp/README.md

@@ -2,14 +2,8 @@
 
 Этот пример показывает фаззинг dll библиотек, написанных на C#.
 
-# Создание проекта - обертки
+## Создание проекта - обертки
 
-В системе должен быть установлен пакет SDK и среда выполнения ASP.NET Core. Ссылка на инструкцию по их установке для
-всех поддерживаемых операционных систем - https://docs.microsoft.com/ru-ru/dotnet/core/install/.
-Необходимо выбрать свою ОС, её версию и последовательно выполнить все шаги установки.
-
-Если у Вас Ubuntu, то перейдите по данной ссылке (https://docs.microsoft.com/ru-ru/dotnet/core/install/linux-ubuntu) и выполните установку
-пакета и среды выполнения для нужной версии ОС.
 Для фаззинга dll библиотеки необходимо создать проект-обертку.
 
 ### Этапы создания:
@@ -78,18 +72,40 @@ namespace AngleSharp.Fuzz
 
 В проект-обертку `AngleSharp.Fuzz*` в качестве зависимости также добавлена библиотека `SharpFuzz.dll` версии 1.6.2 (необходимые строки прописаны в файле `*.csproj`). В ней находится функция для запуска нашего проекта-обертки `AngleSharp.Fuzz*` и он собирается как dll файл.
 
-# Фаззинг
+## Подготовка к фаззингу
+
+В системе должен быть установлен пакет SDK и среда выполнения ASP.NET Core. Ссылка на инструкцию по их установке для
+всех поддерживаемых операционных систем - https://docs.microsoft.com/ru-ru/dotnet/core/install/.
+
+Используйте предварительно собранный образ `csharp-fuzz:latest`, который содержит готовую среду для фаззинга с необходимыми предустановленные компонентами, .NET 6 SDK и Runtime
+
+Фаззинг будет проводиться в докер-контейнере, собранного следующей командой:
+```shell
+$ ./docker/docker_build.sh
+```
+
+Создать контейнер (укажите актуальный путь до директории `crusher`):
+```shell
+$ /docker/docker_run.sh <crusher_dir> [hasp_ip]
+```
+где:
+- `crusher_dir` - директория `crusher/` (обязательная опция)
+- `hasp_ip` - IP сервера лицензий (необязательная опция)
+
+## Фаззинг
 
 1. Произведите инструментацию библиотеки `AngleSharp.dll` для фаззинга. Соберите проект-обертку `target/AngleSharp.Fuzz*`. Для этого запустите скрипт `./instrument.sh`, который принимает один аргумент - путь до `dotnet`.
 
 2. Находясь в данной директории, запустите скрипт `./fuzz-stdin.sh` для фаззинга библиотеки через **stdin** и `./fuzz-file.sh` для фаззинга через **файл**;
-они принимают два аргумента - путь до `fuzz_manager` и до исполняемого файла`dotnet`, установленного в Вашей системе. `dotnet` обычно находится здесь (точнее, символическая
-ссылка на исполняемый файл dotnet): /usr/bin/dotnet.
+они принимают два аргумента - путь до `fuzz_manager` и до исполняемого файла`dotnet`, установленного в Вашей системе. 
+
+*Примечание*:  
+Внутри контейнера Crusher располагается по пути `/opt/crusher/`, а dotnet - `/usr/bin/dotnet`
 
 3. Запустите в другом терминале `UI` фаззера (укажите актуальные пути):
 
 ```shell
-/path/to/crusher/bin_x86-64/ui --outdir /path/to/out
+sudo /path/to/crusher/bin_x86-64/ui --outdir /path/to/out
 ```
 
 Как только будут найдены аварийные завершения, значение поля `unique_crashes` (в окне `UI` - наверху справа) станет ненулевым.

Examples/Crusher/Linux/csharp/docker/Dockerfile

@@ -0,0 +1,26 @@
+FROM ubuntu:22.04
+
+RUN apt update \
+    && apt upgrade -y \
+    && apt install -y wget libffi-dev liblz4-dev libcurl4-openssl-dev gnupg2 git \
+       gcc gcc-multilib g++ g++-multilib clang nano
+
+RUN cd /tmp && wget http://archive.ubuntu.com/ubuntu/pool/main/libf/libffi/libffi6_3.2.1-8_amd64.deb && dpkg -i libffi6_3.2.1-8_amd64.deb && rm -rf libffi6_3.2.1-8_amd64.deb
+
+# .NET 6 installing
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+        dotnet-sdk-6.0 \
+        aspnetcore-runtime-6.0
+
+# Set Timezone or get hang during the docker build...
+ENV TZ=Europe/Moscow
+RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
+
+# Setup license
+RUN echo 'deb https://repo.ispras.ru/apt /' | tee /etc/apt/sources.list.d/ispras.list \
+    && wget -q -O - https://repo.ispras.ru/apt/key.asc | apt-key add - \
+    && apt update -y \
+    && apt install -y aksusbd
+COPY setup_license.sh /opt/setup_license.sh
+RUN echo "/opt/setup_license.sh 101213 36343" >> ~/.bashrc

Examples/Crusher/Linux/csharp/docker/docker_build.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+work_dir=$(dirname $(readlink -e $0))
+docker build -f $work_dir/Dockerfile -t csharp-fuzz:latest $work_dir/

Examples/Crusher/Linux/csharp/docker/docker_run.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+
+script_file=$(readlink -e $0)
+test_dir=$(dirname $(dirname $script_file))
+
+if [ "$#" -lt 1 ]; then
+    echo "Usage: $script_file <crusher_dir> [hasp_ip]" >&2
+    exit 1
+fi
+
+crusher_dir=$(readlink -e $1)
+echo "crusher - $crusher_dir"
+
+hasp_ip=""
+if [ ! -z "$2" ]; then
+    hasp_ip_env="-e HASP_IP=$2"
+fi
+
+cmd="docker run --rm --privileged --network host -e LANG=C.UTF-8 -e LC_ALL=C.UTF-8 -v $crusher_dir:/opt/crusher -v $test_dir:$test_dir $hasp_ip_env -ti csharp-fuzz:latest /bin/bash"
+echo "$cmd"
+$cmd

Examples/Crusher/Linux/csharp/docker/setup_license.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+if [ -z "$HASP_IP" ]; then
+    echo "hasp ip - not set"
+    hasplmd -s
+    exit 0
+fi
+
+echo "hasp ip - $HASP_IP"
+
+mkdir -p /root/.hasplm
+for vendor_id in "$@"; do
+    hasp_ini_file=/root/.hasplm/hasp_${vendor_id}.ini
+
+    if [ ! -f "$hasp_ini_file" ] || ! grep -q '^serveraddr = ' "$hasp_ini_file"; then
+        echo "[REMOTE]" >> $hasp_ini_file
+        echo "serveraddr = $HASP_IP" >> $hasp_ini_file
+        echo "set hasp addr: serveraddr = $HASP_IP"
+    else
+        echo "already set hasp addr: serveraddr = $HASP_IP"
+    fi
+done
+
+hasplmd -s