**Byteman README**

Byteman поддерживает внедрение побочных эффектов в программы на Java с целью отслеживания и тестирования поведения приложения.

Установка
------------

Когда вы разархивируете скачанный релиз, он будет распакован в один целевой каталог установки, содержащий всё необходимое для использования Byteman. Вы должны установить переменную среды BYTEMAN_HOME так, чтобы она указывала на этот целевой каталог установки.

Каталог установки двоичного релиза содержит следующие подкаталоги:

* bin — содержит скрипты Unix для упрощения: использования Byteman (bmjava.sh); проверки типов сценариев правил Byteman (bytemancheck.sh); взаимодействия со слушателем агента Byteman (bmsubmit.sh); и установки агента в работающую JVM (bminstall.sh). Вам нужно будет изменить разрешения этих файлов, чтобы выполнить их непосредственно из командной строки.

* docs — содержит руководство программиста Byteman и информацию о лицензии для Byteman плюс стороннее программное обеспечение, которое оно использует.

* lib — содержит агент и механизм правил Byteman (byteman.jar); часть этого кода необходима для компиляции/запуска клиента отправки (byteman-submit.jar); часть этого кода нужна для компиляции/запуска клиентского установщика (byteman-install.jar).

* sample/scripts — содержит примеры сценариев правил, показывающих, как использовать Byteman

* sample/lib — содержит вспомогательный код для примеров сценариев

* contrib — содержит программное обеспечение, предоставленное другими пользователями Byteman, см. файл README в каждом подкаталоге contrib для получения подробной информации о том, как использовать пакет.

В каталоге установки полного исходного релиза есть все вышеперечисленные каталоги плюс следующие дополнительные каталоги:

* sources — содержит исходные jar-файлы для каждого из компонентов jar в lib, sample/lib, contrib/dtest и contrib/bmunit

* javadoc — содержит документацию в формате javadoc для каждого из jar-файлов компонентов в lib, sample/lib, contrib/dtest и contrib/bmunit.

Использование Byteman
-------------
Доступ к загрузкам проекта Byteman, документации, форумам пользователей и разработчиков и исходному коду доступен на домашней странице проекта по адресу http://www.jboss.org/byteman

Пожалуйста, обратитесь к Руководству программиста за подробностями о том, как работает Byteman, как писать сценарии правил Byteman и как запустить программу Java с агентом Byteman на месте.

Взгляните на каталог примеров сценариев, чтобы увидеть несколько примеров того, как вы можете использовать Byteman для отслеживания выполнения приложения и JVM или для сбора и представления статистики, подробно описывающей работу кода JVM или приложения. (Примечание: эти примеры всё ещё нуждаются в расширении, чтобы показать, как использовать Byteman для тестирования на основе внедрения ошибок).

Компиляция Byteman
-----------------

Для компиляции исходного кода используйте команду Maven `mvn clean install`. Byteman будет скомпилирован, команда генерирует документацию, а артефакты распространения можно найти в `download/target`.

Чтобы ускорить компиляцию, вы можете пропустить тесты и генерацию документации с помощью команды `mvn clean install -DskipITs -DskipTests -DskipDocs`.

Авторские права
---------
См. файл авторских прав в каталоге docs для получения информации об открытой лицензии, по которой выпущен этот код. Обратите внимание, что в этом коде используется пакет ObjectWeb ASM для манипуляции байт-кодом и генераторы токенизатора JFlex и парсера JavaCUP для генерации и обеспечения поддержки во время выполнения для анализатора правил, которые также выпущены под лицензиями с открытым исходным кодом.