From b36a576461d044349e4e7c79e130aa08bffe9fa6 Mon Sep 17 00:00:00 2001 From: bock Date: Mon, 22 Nov 2010 19:56:12 +0000 Subject: [PATCH] Update docs for Russian before 3.2.9 --- doc/help.ru.conf | 54 +++++++------- doc/unreal32docs.ru.html | 150 ++++++++++++++++++++++++++++----------- 2 files changed, 136 insertions(+), 68 deletions(-) diff --git a/doc/help.ru.conf b/doc/help.ru.conf index e3268f1a3..6e1143017 100644 --- a/doc/help.ru.conf +++ b/doc/help.ru.conf @@ -173,58 +173,60 @@ help Chmodes { " a = Даёт пользователю статус администратора канала"; " q = Даёт пользователю статус владельца канала"; " -"; + " A = В канал могут попасть только администраторы сети/сервера"; + " (устанавливается администраторами)"; " b = Накладывает 'бан' на nick!ident@host [h]"; " (подробнее о 'расширенных типах бана' /HELPOP EXTBANS)"; " c = Блокирует сообщения, содержащие управляющие коды mIRC для"; " задания цвета [o]"; + " C = Запрещает хождение CTCP пакетов в канале [o]"; " e = Накладывает маску исключения на 'бан' для"; " пользователей, попавших под заданную маску [h]"; " f <параметры> = Защита от флуда. (Для получения дополнительной"; " информации загляните в /HELPOP CHMODEF) [o]"; - " I <ник!пользователь@хост> = Накладывает маску исключения на режим +i"; + " G = Включает фильтрацию сообщений путём замены нецензурных слов на"; + " [o]"; " i = Для того, чтобы попасть на канал, пользователь должен быть"; " приглашён (Invite only) [h]"; + " I <ник!пользователь@хост> = Накладывает маску исключения на режим +i"; " j <вход:секунды> = Устанавливает ограничение на количество команд"; " join за задонное время"; " k <ключ> = Пользователи должны иметь <ключ>, чтобы попасть на"; " защищённый канал [h]"; - " l <число> = Задаёт максимальное <число> пользователей в канале [o]"; - " m = Модерируемый канал (только пользователи с установленными флагами"; - " +vhoaq могут говорить) [h]"; - " n = Пользователи, не присутствующие в канале, не могут"; - " посылать PRIVMSGs в канал [h]"; - " p = Включает режим 'ограниченного доступа' на канал (Private) [o]"; - " r = Показывает, что канал зарегистрирован (устанавливается только"; - " сервисами)"; - " s = Включает 'режим секретности' на канале (Secret)[o]"; - " t = Блокирует топик, так что только пользователи с флагами +hoaq"; - " могут его изменить [h]"; - " z = Только пользователи, подключенные к серверу через шифрованный"; - " канал (SSL), могут попасть в канал [o]"; - " A = В канал могут попасть только администраторы сети/сервера"; - " (устанавливается администраторами)"; - " C = Запрещает хождение CTCP пакетов в канале [o]"; - " G = Включает фильтрацию сообщений путём замены нецензурных слов на"; - " [o]"; - " M = Включает ограничение на возможность говорить в канале только"; - " зарегистрированным пользователям (+r), либо пользователям с"; - " 'Правом голоса' (+v). [o]"; " K = Запрещает использование команды /KNOCK [o]"; + " l <число> = Задаёт максимальное <число> пользователей в канале [o]"; " L <канал2> = Связывает каналы таким образом, что при достижении"; " параметра, заданного режимом +l, новые пользователи"; " будут перенаправляться на канал <канал2>) [q]"; + " m = Модерируемый канал (только пользователи с установленными флагами"; + " +vhoaq могут говорить) [h]"; + " M = Включает ограничение на возможность говорить в канале только"; + " зарегистрированным пользователям (+r), либо пользователям с"; + " 'Правом голоса' (+v). [o]"; + " n = Пользователи, не присутствующие в канале, не могут"; + " посылать PRIVMSGs в канал [h]"; " N = Запрещает пользователям канала изменять свой ник [o]"; " O = Канал только для IRC операторов (могут устанавливать только"; " IRC операторы)"; + " p = Включает режим 'ограниченного доступа' на канал (Private) [o]"; " Q = На канале запрещены 'кики' [o]"; + " r = Показывает, что канал зарегистрирован (устанавливается только"; + " сервисами)"; " R = В канал могут войти только зарегистрированные (+r) "; " пользователи [o]"; + " s = Включает 'режим секретности' на канале (Secret)[o]"; " S = Указывает, что на канале из сообщений вырезаются коды mIRC"; " для управления цветом [o]"; + " t = Блокирует топик, так что только пользователи с флагами +hoaq"; + " могут его изменить [h]"; " T = Указывает, что на канале запрещены уведомления (NOTICEs) [o]"; - " V = Указывает, что на канале нельзя использовать команду /INVITE [o]"; " u = Auditorium mode (команды /names и /who #channel показывают"; " только операторов канала) [q]"; + " V = Указывает, что на канале нельзя использовать команду /INVITE [o]"; + " z = Только пользователи, подключенные к серверу через шифрованный"; + " канал (SSL), могут попасть в канал [o]"; + " Z = Все пользователи на канале используют безопасное подключение SSL."; + " (Устанавливается/снимается сервером. Только если канал так же +z)"; " -"; " [h] - минимум требуются права halfop, [o] - минимум требуются права"; " chanop, [q] - требуются права владельца"; @@ -1006,12 +1008,14 @@ help Rehash { " Доступна для использования только IRC операторам."; " -"; " Синтаксис: REHASH <имя сервера> -<флаг>"; + " REHASH -global <флаг>"; " REHASH -<флаг>"; " -"; - " Если не указано имя сервера и флаги, сервер перечитает unrealircd.conf,"; + " Если не указано имя сервера и флаг, сервер перечитает unrealircd.conf,"; " а так же все файлы MOTD, BOTMOTD, OPERMOTD и RULES."; " Если указано имя сервера, команда подействует на указанный сервер."; - " Только администратор сети может указывать имя сервера."; + " Если указан -global, то все сервера в сети перечитают настройки"; + " Только администратор сети может указывать имя сервера и -global."; " -"; " Указание флагов позволяет перечитать другие конфигурационные файлы." ; " Список флагов:"; diff --git a/doc/unreal32docs.ru.html b/doc/unreal32docs.ru.html index 5b4a264d7..4f6e4f135 100644 --- a/doc/unreal32docs.ru.html +++ b/doc/unreal32docs.ru.html @@ -4,16 +4,16 @@ UnrealIRCd - 3.2 - Официальная документация + .block_name { font-size: 24; font-weight: bold; } + .block_required { color: red; font-weight: bold; } + .block_recommended { color: green; font-weight: bold; } + .block_optional { color: blue; font-weight: bold; } + .block_old { font-size: 14; } + .set { font-weight: bold; } + .desc { margin-left: 15px; } + .inline_pre { font-family: monospace; font-style: normal; background-color: #eeeeee;} + pre { font-family: monospace; font-style: normal; background-color: #eeeeee;} + @@ -124,7 +124,9 @@ ---8.8. Защита против эксплоитов
---8.9. Итоги
9. Часто - задаваемые вопросы (ЧАВО)
+ задаваемые вопросы (ЧАВО)
+ 10. Модули
+ ---10.1. m_nopost
A. Регулярные выражения
---A.1. Литералы
---A.2. Оператор Точка
@@ -197,7 +199,7 @@
  • Запустите программу установки новой версии Unreal.
  • - Скопируйте старые конфигурационные файлы в новую папку. + Скопируйте старые конфигурационные файлы в новую папку.

    • Пожалуйста, проверьте/прочитайте .RELEASE.NOTES чтобы увидеть, что изменилось. @@ -220,7 +222,7 @@

  • OpenBSD (3.7, 3.8, 3.9)
  • - Solaris (9, 10) + Solaris (9, 10)
  • @@ -231,7 +233,7 @@
  • Windows XP (Home, Pro)
  • - Windows 2003 + Windows 2003
  • @@ -244,7 +246,7 @@
  • amd64
  • - alpha + alpha

    • @@ -269,8 +271,8 @@
  • make
  • - Теперь создайте ваш unrealircd.conf и другие конфигурационные файлы так, как - описано в разделе 4. + Теперь создайте ваш unrealircd.conf и другие конфигурационные файлы так, как + описано в разделе 4.

    • Windows:
    @@ -278,8 +280,8 @@

  • Запустите программу установки Unreal
  • - Теперь создайте ваш unrealircd.conf и другие конфигурационные файлы так, как - описано в разделе 4. + Теперь создайте ваш unrealircd.conf и другие конфигурационные файлы так, как + описано в разделе 4.

    • @@ -316,21 +318,21 @@

    Эти ключи ДОЛЖНЫ быть одинаковыми на ВСЕХ СЕРВЕРАХ в сети. Также ключи должны храниться в секрете, потому что возможно получить реальный хост, зная эти ключи (что делает режим +x бесполезным).

    -

    Подсказка: Если вы используете *NIX, то у вас есть возможность создать - новые ключи: запустите './unreal gencloak' в шелле, результатом выполнения +

    Подсказка: Если вы используете *NIX, то у вас есть возможность создать + новые ключи: запустите './unreal gencloak' в шелле, результатом выполнения станет три строки сгенерированные случайно, которые вы сможете использовать в - качестве ключей.

    + качестве ключей.

    3.2 - Модули

    UnrealIRCd поддерживает модули, которые хороши тем, что:
    - - Вы можете загружать/перезагружать/выгружать их во время работы ircd(путём + - Вы можете загружать/перезагружать/выгружать их во время работы ircd (путём команды /rehash). Это позволяет исправлять некоторые ошибки или добавлять новые возможности без перезапуска сервера!
    - Сторонние люди могут создавать модули с новыми командами, режимами пользователей и каналов.
    - UnrealIRCd идёт только с некоторыми модулями. Следите на www.unrealircd.com - -> modules или используйте google.com для поиска сторонних модулей.
    + UnrealIRCd идёт только с некоторыми модулями. + Следите за модулями на www.unrealircd.com -> или используйте google.com для поиска сторонних модулей.

    Вам необходимо загрузить как минимум два модуля, иначе вы не сможете запустить UnrealIRCd:
    - модуль команд: commands.so (commands.dll в ОС Windows)
    @@ -857,6 +859,13 @@ set::spamfilter::virus-help-channel, отключает все команды кроме PONG, ADMIN, и сообщает/уведомляет об этом на set::spamfilter::virus-help-channel + + warn + посылает уведомление ирц-операторам (сномаска spamfilter) и уведомляет пользователя о том, + что его сообщение было перехвачено. Никаких действией с пользователем не происходит, + сообщение не блокируется. + + @@ -2426,9 +2435,13 @@ loadmodule "modules/cloak.dll"; };

    Блок except ban позволяет определить user@host в качестве исключения для бана. - Данный блок используется, если вы хотите забанить провайдера, но так же хотите, - чтобы определённые пользователи могли присоединится. Директива except::mask + Данный блок используется, если вы хотите забанить пользователей конкретного + провайдера (блоком ban { } или KLINE/ZLINE), но так же хотите, + чтобы определённые пользователи смогли подключиться. Директива except::mask определяет шаблон user@host для клиента, чтобы позволить ему присоединится.

    +

    Замечание: Если вы желаете стопроцентно исключить хост от всех возможных банов + (кроме спамфильтра), то вы должны указать оба блока: 'except ban' и 'except tkl'.

    +

    Пример:

    except ban {
     mask myident@my.isp.com;
@@ -2456,8 +2469,8 @@ loadmodule "modules/cloak.dll";
 							забанить провайдера, но так же хотите, чтобы определённые пользователи могли 
 							присоединится. Директива except::mask определяет маску user@host для клиента, 
 							чтобы позволить ему присоединится. except::type определяет, какой тип бана 
-							должен преодолеваться. Возможные типы: gline, gzline, qline, gqline и shun, что 
-							позволяет исключать из Glines, Global Zlines, Qlines, Global Qlines и shuns. 
+							должен преодолеваться. Возможные типы: gline, gzline, qline, gqline, shun и all, что 
+							позволяет исключать из Global Zlines, Qlines, Global Qlines, shuns и all баны (кроме KLINE/ZLINE). 
 							Если используется формат type {}, то можно определить несколько типов.
    
 						
    Пример:
    
 							
    except tkl {
@@ -2721,18 +2734,24 @@ deny channel {
 };
    
 					
    
 					
    Блок badword позволяет манипулировать вам списком, используемым для режима +G, 
-						установленного на пользователей и канал, чтобы вырезать матные слова. badword:: 
-						определяет тип, такой, как channel, message, quit и all. channel - это список 
-						+G на канале, message - это список +G пользователя, quit - для цензуры 
-						сообщения при выходе, all - добавляет всё в указанные выше 3 списка. 
-						badword::word может быть просто словом или же регулярным выражением. 
-						badword::replace - чем заменить совпадающее слово.Если badword::replace не 
-						указан, то слово будет заменено на <censored>. badword::action 
+						установленного на пользователей и канал, чтобы вырезать матные слова. 
+						badword:: определяет тип, по которому будет судится, где придётся вырезать слова.
+						Правильные типы:
+						
      
+							
    • channel применяется на каналах с установленным режимом +G.
      • 
+							
    • message применяется в личных сообщениях (не в канальных ), отправленных пользователем с режимом +G.
      • 
+							
    • quit применяется во всех сообщениях выхода из сети.
      • 
+						      	
    • all применяется во всех указанных выше ситуациях.
      • 
+
    
+
    
+						badword::word может быть просто словом или же регулярным выражением (которое мы заменяем). 
+						badword::replace - чем заменить совпадающее слово. Если badword::replace не 
+						указан, то слово будет заменено на <censored>. badword::action 
 						определяет, какое действие будет предпринято, если будет найден мат. Если вы 
 						определили replace, тогда мат будет заменен, если же вы определили block, то 
-						сообщение будет заблокировано целиком. Если вы не определили badword::action, 
+						сообщение будет заблокировано целиком. Если вы не определили badword::action, 
 						то будет назначен replace.
    
-					
    Пример:
    
+					
    Пример:
    
 						
    badword channel {
     word shit;
     replace shoot;
@@ -3168,9 +3187,9 @@ cgiirc {
    -

    4.37 - Set блок +

    4.37 - Set блок НЕОБХОДИМ (Ранее - известен как unrealircd.conf/networks) + известен как unrealircd.conf/networks)

    Данный блок содержит настройки вашей irc-сети, он может размещаться как в @@ -3356,9 +3375,27 @@ cgiirc { использование команды не-операторами отправляется сномаске EYES.

    set::options::allow-part-if-shunned;
    Позволяет пользователям, на которых установлен shun, использовать /part.

    -

    set::options::fail-oper-warn;
    +

    set::options::fail-oper-warn;
    При наличии этой опции пользователь будет уведомлён о том, что его неудачная попытка стать оператором (/oper) была зафиксирована.

    +

    set::options::allow-insane-bans;
    + Позволяет банить по указанной маске, например /GLINE *@*.xx. Позволяет легко и + непринуждённо забанить любого в вашей сети, поэтому используйте осторожно!

    +

    set::nopost::ban-action (требует модуля m_nopost)
    + Действие, применяемое к пользователю, если он пытается выполнить команду HTTP POST. + Допустимые значения: kill, gline, gzline, kline, zline, shun, tempshun. + Значение по умолчанию: kill. Если вы используете значения *line или shun, + просто запомните, что возможно легковерный пользователь посетил сайт, который осуществляет + спаммерскую атаку XPS IRC, и пользователя отключит от сети (прибьёт его существующие подключенния). + Значение по умолчанию (kill) как раз служит защитой против таких инцидентов, но жёсткие меры (*line, + а особенно gzline) иногда необходимы.

    +

    set::nopost::ban-reason (требует модуля m_nopost)
    + Указывается причина бана, если модуль m_nopost прибивает или банит пользователя.

    +

    set::nopost::ban-time (требует модуля m_nopost)
    + Длительность для shuns, glines, gzlines, klines и zlines, установленных by m_nopost. + По умолчанию 4h (4 часа).

    +

    set::nopost::except-hosts (требует модуля m_nopost)
    + Список маск хостов для исключения действия модуля m_nopost. Вы можете указать здесь любые хост маски.

    set::dns::timeout <интервал-времени>;
    Интервал времени, определяющий таймаут DNS-сервера. Это строка, где d означает дни, h - часы, m - минуты и s - секунды. К примеру, 1d2h3m означает 1 день, 2 @@ -3862,6 +3899,17 @@ files { Зайти на канал могут только клиенты с защищённым соединением (SSL) + + +

    Z
    + + Устанавливается сервером и сигнализирует о том, что все пользователи, + находящиеся на канале, используют безопасное подключение (SSL). + Будет активно, если указано +z. ULines (к примеру BotServ), игнорируются, + при подсчёте "небезопасных пользователей". По прежнему, озаботиться безопасностью + межсерверных линков должны администраторы (SSL, VPN, использование loopback интерфейсов + и прочая, прочая), потому что IRCd не может и не сможет определить безопасность. +

    @@ -4427,10 +4475,12 @@ files { Оператор - rehash <сервер> –<флаги> + rehash <сервер|global> –<флаги> Осуществляет рехэш (Rehash - перечитать) конфигурационных файлов сервера. Если указано имя сервера, то позволяет осуществить рехэш конфигурационного файла на - удалённом сервере. Доступны некоторые флаги:
    + удалённом сервере. Если указан -global, то будет произведён рехэш + ВСЕХ серверов в вашей сети (требует прав NetAdmin). + Доступны некоторые флаги:
    -motd - Осуществляет рехэш всех MOTD и RULES файлов (включая tld {})
    -opermotd - осуществляет рехэш только файла OPERMOTD
    -botmotd - осуществляет рехэш только файла BOTMOTD
    @@ -4926,6 +4976,20 @@ files { этому адресу.

    +

    10 – Modules

    +
    +

    Данная секция описывает модули, идущие в комплекте с UnrealIRCd. + К сожалению в настоящее время только один модуль, идущий вместе с + UnrealIRCd, документирован.

    +
    +

    10.1 m_nopost
    + Данный модуль автоматически банит любого пользователя, кто пытается использовать запрос в стиле HTTP. + Модуль был написан Syzop в ответ на использование Firefox XPS атак, которые позволяли AJAX-совместимым + браузерам выступать в роли спамботов в IRC. Выбрать, что будет делать модуль m_nopost, когда получит + подобный запрос, можно в секции set::nopost::ban-action и + set::nopost::ban-time.
    + Модуль появился в UnrealIRCd версии 3.2.9 и компилируется в commands.so, так что он загружается автоматически в + большинстве случаев.

    Регулярные выражения

    Регулярные выражения часто используются в Unreal (например, в badwords, spamfilter, и aliases), они являются отличным инструментом для поиска