Если вы попали сюда по моей статье в 2600 из выпуска SPRING 2016 issue,
продолжайте читать следующие разделы документации, потому что этот маленький Pig с тех пор развивался.

Как клонировать этот репозиторий?

Это очень просто:

Как собрать?

Для сборки pig нужно использовать Hefesto. После выполнения
шагов по установке Hefesto в вашей системе перейдите в подкаталог pig с именем src и выполните
следующую команду:

После этой команды вы должны найти бинарный файл pig по пути src/bin. Вы можете использовать бинарник относительно
src/bin или установить его.

Если по какой-то причине у вас возникли проблемы со сборкой, попробуйте прочитать некоторые замечания в BUILD.md.

Как установить?

Для установки нужно находиться внутри подкаталога src и выполнить:

Для удаления, находясь в подкаталоге src, выполните:

Файлы pigsty

Файлы Pigsty — это обычные текстовые файлы, в которых можно определить набор сигнатур пакетов. Существует определённый синтаксис,
который необходимо соблюдать. Вот пример файла pigsty:

В основном все данные сигнатуры должны находиться между квадратными скобками: [ ... ].

Внутри этой области информация задаётся по схеме поле = данные.

Если у вас есть опыт работы с компьютерными сетями, то большинство полей, перечисленных в Таблице 1,
вероятно, имеют для вас ясное значение. Вы должны использовать эти поля для создания своих сигнатур.

Таблица 1: Поля сигнатур pig.

При создании сигнатуры необязательно указывать все данные. Если указать только наиболее важные части пакета,
остальные части будут заполнены значениями по умолчанию. Контрольные суммы всегда пересчитываются.

Совет: загляните в подкаталог pigsty. Вы найдёте там множество файлов сигнатур и увидите, что
определять новые очень просто.

Указание IP-адресов по географическому признаку

Да, это возможно. Чтобы использовать эту возможность, просто укажите значения, перечисленные в Таблице 2,
в полях типа IP-адрес.

Таблица 2: IP-адреса по географическим зонам.

Указание собственных адресов

В любом поле типа IP-адрес следует использовать значение user-defined-ip. Обратите внимание, что в этом случае
нужно использовать параметр командной строки --targets. Подробнее см. в разделе Использование pig.

Внесите свой вклад, отправляя новые сигнатуры пакетов

Если вы создаёте файлы pigsty, которые, по вашему мнению, актуальны не только в вашем окружении, откройте pull request,
чтобы включить эти полезные файлы сюда. Заранее спасибо!

Использование pig

Использование Pig очень простое — необходимо указать четыре основных параметра:

• --signatures
• --gateway
• --net-mask
• --lo-iface

Хотите узнать больше о каждом параметре? Тогда поехали:

• Параметр --signatures принимает список путей к файлам pigsty.
• Параметр --gateway — это место, где вы указываете адрес вашего шлюза. Имейте в виду, что pig генерирует (или по крайней мере пытается сгенерировать) также кадры Ethernet. Из-за этого адрес шлюза довольно важен для правильного составления данных уровня-1.
• Параметр --net-mask для вопросов маршрутизации должен получить вашу маску сети.
• Параметр --lo-iface — это место, где следует указать имя локального сетевого интерфейса, который вы будете использовать для «слива» сгенерированных пакетов.
• Параметр --no-gateway указывает, что никакие пакеты не будут отправляться за пределы сети.

Предположим, мы хотим генерировать трафик на основе DDoS:

Теперь мы хотим всё перемешать:

Дополнительные параметры

Определение тайм-аутов между отправками сигнатур

Для этого используйте параметр --timeout=<мс>

Подавление эха

Используйте параметр --no-echo.

Определение целей

Используйте параметр --targets. Вы можете указать список на основе точных IP-адресов, масок IP и CIDR.

Взгляните:

Отказ от использования шлюза

Это полезно, когда загруженные сигнатуры не будут отправлять данные за пределы текущей сети. Чтобы указать это, нужно использовать
параметр --no-gateway. При использовании параметра --no-gateway не нужно указывать адрес шлюза,
потому что пакеты не будут выходить за пределы текущего сегмента. Соответственно, указывать маску сети также становится неактуально.

Например:

В приведённом выше примере кадр Ethernet больше не будет ответственностью pig. По этой причине pig не будет жаловаться
на отсутствие параметров --gateway и --net-mask.

Параметр --no-gateway очень удобен в случаях, когда нужно сгенерировать трафик ARP. Посмотрите другой
документ, объясняющий, как выполнить ARP-спуфинг с pig.

Отправка только одной сигнатуры и возврат

Возможно, вам нужно отправить только одну сигнатуру и затем вернуться к вызывающему коду, чтобы проверить, что произошло после. Такое
требование часто возникает, когда это приложение используется как поддержка для системных тестов или модульных тестов. Поэтому, если вам нужно
это сделать, попробуйте использовать параметр --single-test:

После выполнения этой команды pig выберет только одну сигнатуру из файла syn-scan.pigsty, попытается отправить её и завершит работу.
Если в процессе произойдёт ошибка, pig завершится с кодом выхода, равным 1, в противном случае pig завершится
с кодом выхода, равным 0.

Указание режима обхода pigsty

Основной режим работы pig — это бесконечный цикл, который выплевывает тонны пакетов в сеть с соблюдением ранее
заданного тайм-аута.

Вы можете определить, как pig перебирает загруженные пакеты для их отправки, используя параметр --loop=<mode>. На данный момент
доступны два режима: random (по умолчанию) и sequential.

Режим sequential будет повторять сигнатуры при достижении конца списка загруженных сигнатур пакетов.

Подзадачи

Подзадачи — это полезные небольшие задачи, связанные с созданием пакетов, которые встроены в pig для помощи вам
в сеансе создания. Эти задачи можно вызвать с помощью параметра --sub-task=<task-name>.

По сути, подзадачи являются подпрограммами, имеют свои собственные особенности, и поэтому
подробности о них приведены в их собственных руководствах. См. Таблицу 3 для перехода к ним.

Таблица 3: Подзадачи pig.

Трюки с Pig

От кадра Ethernet до самого верхнего уровня...

До сих пор вы можете собирать пакеты на основе IPv4 с UDP или TCP на транспортном уровне. Вы также можете собирать
пакеты ARP.

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

Например, даже несмотря на то, что pig пока не предлагает поддержку готовой сборки IPv6, вы всё равно можете собрать
его, используя сырой pigsty на основе Ethernet. Посмотрите:

Принимая во внимание, что включение MAC-адресов назначения и источника в «Ethernet pigsty» является
необязательным, мы можем выполнить задачу даже без использования каких-либо расширенных полей.

Это удобно, когда вам нужно тестировать новые протоколы в вашей среде и прочие аномальные забавные вещи. В таком сыром виде
pig может оставаться полезным для вас.

Тестирование pig с нуля

Сохраните следующие данные как "oink.pigsty":

На другом tty запустите netcat в UDP-режиме для прослушивания соединений на порту 1008:

Теперь запустите pig, используя "oink.pigsty", указав в качестве цели loopback:

netcat должен начать получать несколько oink, и... да, поздравляю!! pig запущен и работает в вашей системе! ;)

Попробуйте прослушать вашу сеть, чтобы получить больше информации об этих UDP-пакетах, которые циркулируют по вашим интерфейсам...

Получайте удовольствие!