Просмотр Исходного

{toc}

h1. Описание хуков

Многие скрипты Carbon Reductor поддерживают использование пользовательских хуков.

Хуки позволяют дополнить действия выполняемые скриптами Carbon Reductor или переопределять их.

{color:#000000}{*}Скрипты, часто подвергаемые хукам{*}{color}

* rkn_download.sh
* diagnostic.sh
* start.sh
* stop.sh
* rkn_info.sh
* show_stat.sh
* prepare_lists.sh
* firewall.sh

h1. Расположение хуков

Хуки располагаются в директории /usr/local/Reductor/userinfo/hooks/, должны быть исполняемыми (chmod \+x путь_до_хука) и именоваться одинаково со скриптом, который они модифицируют.



h1. Как, когда и зачем писать хуки

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

Самое главное - проверяйте, что с использованием вашего хука всё работает как надо.

Писать их надо в случае. если необходимо модифицировать один из стандартных скриптов Carbon Reductor на постоянной основе.

Все функции, кроме client_post_hook и client_pre_hook могут исчезнуть в одной из будущих версий.

Мы стараемся сообщать о глобальных изменениях в кодовой базе за неделю до выпуска новой версии в [официальном твиттер-аккаунте проекта|https://twitter.com/carbon_reductor], так что при использовании важных хуков рекомендуется следить за ним, а также время от времени самостоятельно проверять их работоспособность.

Примеры хуков вы можете просмотреть во вложенных страницах.