SolarNet Irc Network logo  
Твое место под солнцем!

Литература => Основные команды сервера ircd-RU 1.0.7-2:


Основано на http://bahamut.dal.net/documentation/command.php.

Содержание

 1. Соглашения и обозначения
2. Команды пользователя 3. Команды оператора

Соглашения и обозначения

Первая строка каждой секции содержит синтаксис вызова команды. Слова, которые надо вводить в точности как они указаны, приведены в ВЕРХНЕМ регистре. Вводимые пользователем параметры указаны словами в нижнем регистре и внутри угловых скобок "<>". Необязательные параметры указаны врутри квадратных скобок "[]". Многоточия "..." обозначают параметр, который возможно может повторяться, а следующее за ними число в круглых скобках означает наибольшее количество раз, которое он может повторяться. Если число не указано, параметр может повторяться столько раз, сколько это необходимо. Скобки, которые сами по себе включены в команды, выделены одинарными кавычками "'". Из параметров, разделенных знаком "|", может быть выбран только один (например, "+|-" означает, что в команде может быть указан либо "+", либо "-").

Пример:
PRIVMSG <nick>[@<servername>][,<nick>[@<servername>] ...(18)] :<message>

PRIVMSG в первой части команды должно быть указано в точности таким образом. Список целей состоит из одного или более ника, разделенных запятыми. Необязательная привязка ника к серверу состоит из значка '@' и следующего за ним имени сервера. Всего может быть указано 20 целей (2 из них показаны, плюс еще 18, на что указывает "...(18)"). Тело сообщения идет последним, после двоеточия.

Пример правильной команды:
PRIVMSG bob@server.some.net,bob2 :привет, бобры!

Эта команда посылает сообщение "привет, бобры!" пользователю "bob" (если он находится на сервере server.some.net) и "bob2".

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

Итак, команды!

Команды пользователя

ADMIN [<dest>]

Возвращает информацию об администраторе сервера. Если указан параметр <dest>, ответ приходит от соответствующего ему сервера. <dest> может быть маской ника или сервера.


AWAY [<message>]

Указание параметра <message> помечает вас на сервере как away, иначе -- снимает этот флаг.


CHANSERV :<data>

Безопасно отправляет указанные данные на ChanServ@services.some.net.


CODEPAGE <name>

Меняет вашу кодовую страницу на сервере на указанную. <name> может быть именем кодовой страницы или одним из его алиасов.


CODEPAGES [<dest>]

Возвращает список кодовых страниц, поддерживаемых серверов. Информация о кодовой странице содержит ее имя и алиасы имени, если таковые имеются. Если указан параметр <dest>, ответ приходит от соответствующего ему сервера. <dest> может быть маской ника или сервера.


Команда CS является коротким синонимом для CHANSERV.


DCCALLOW [+|-<nick>[,+|-<nick> ...]] [list] [help]

Добавляет или удаляет пользователей из вашего dccallow списка. Пользователи из этого списка могут посылать вам посредством DCC файлы тех типов, которые в другом случае блокировались бы сервером. Если указан параметр list, возвращается текущий dccallow список. При указании параметра help показывается информация, аналогичная этой.


DNS [l]

Возвращает статистику кода DNS resolve. Если указано 'l', возвращаются все записи из DNS кэша.


HELP

Возвращает список доступных команд, по одной на строку.

HELPSERV :<data>

Безопасно отправляет указанные данные на HelpServ@services.some.net.


Команда HS является коротким синонимом для HELPSERV.


IDENTIFY [<nick>] <password>

Безопасно производит авторизацию вашего ника или другого, если он указан, на NickServ'е.

IDENTIFY <channel> <password>

Безопасно производит авторизацию для указанного канала на ChanServ'е.


INFO [<dest>]

Возвращает информацию о сервере, к которому вы соединены, или об удаленном сервере, если он указан. <dest> может быть маской ника или сервера.


INVITE <nick> <channel>

Приглашает пользователя на указанный канал.


ISON <nick>[ <nick> ...]

Возвращает список пользователей, с указанными ники, находящихся в онлайне.


JOIN <channel>[,<channel> ...] [<key>[,<key> ...]]

Делает попытку зайти на каналы, используя при необходимости ключи. Каждый ключ соответствует каналу в соответствующей позиции списка; например, будет неправильно делать "JOIN #c1,#c2,#c3 k2,k3", если ключи k2 и k3 соответствуют каналам #k2 и #k3. При этом "JOIN #c1,#c2,#c3 k1,k2" будет правильным, если первые два канала требуют ключи k1 и k2 для захода на них. Указание канала 0 приведет к выходу со всех каналов.


KICK <channel>[,<channel> ...] <nick>[,<nick> ...(2)] [:<reason>]

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


LINKS [<mask>]

Возвращает список серверов в сети на данный момент времени. Если указана маска, возврощаются только соответствующие ей линки.

LINKS <dest> <mask>

То же, что и выше, но запрос посылается другому серверу. <dest> может быть маской ника или сервера.


LIST [<options>]

Возвращает список каналов и их топиков на текущий момент. Возможные опции:

  • '>'<users> - показать каналы с количеством пользователей больше указанного
  • '<'<users> - показать каналы с количеством пользователей меньше указанного
  • C'>'<mins> - показать каналы, созданные позже, чем указанное количество минут назад
  • C'<'<mins> - показать каналы, созданные раньше, чем указанное количество минут назад
  • T'>'<mins> - показать каналы, топик которых был установлен позже, чем указанное количество минут назад
  • T'<'<mins> - показать каналы, топик которых был установлен раньше, чем указанное количество минут назад
  • <mask> - показать каналы, имена которых соответствуют указанной маске
  • !<mask> - показать каналы, имена которых не соответствуют указанной маске
  • <channel> - показать указанный канал


LUSERS [* <dest>]

Возвращает статистику использования сервера. Если указан параметр <dest>, то ответ приходит от определенного им сервера. <dest> может быть маской ника или сервера. Второй параметр сейчас незначимый, он необходим для обратной совместимости.


MAP [<server>]

Синоним для STATSERV MAP [<server>], который выводит карту серверов, используя указанный сервер в качестве корня выводимого дерева. Если параметр не указан, корнем дерева будет сервер, к которому подключен пользователь.


MEMOSERV :<data>

Безопасно отправляет указанный данные на MemoServ@services.some.net.


MODE <nick> [<+-modes>]

Устанавливает для пользователя указанные моды и возвращает набор его модов на текущий момент. <nick> должен быть вашим ником. Предшествующий режиму '+' включает этот режим, а '-' -- выключает. Моды могут быть объединены, например "MODE mynick +i-wg+s" (включает моды 'i' и 's', и выключает 'w' и 'g'). Резрешено не более 6 модов в одной команде. Допустимые моды:

  • i - невидимый пользователь (другие пользователи должны знать ваш ник, чтобы найти вас)
  • R - только выполнившие авторизацию пользователи с зарегистрированными никами могут отправлять вам PRIVMSG и NOTICE.
  • s - получать уведомления сервера

MODE <channel> [<+-modes> [<parameters>]]

Синтаксис такой же, как и для модов пользователя, но устанавливает моды для каналов. Некоторые моды каналов требуют наличия параметров, разделенных пробелами. Возможные моды каналов:

  • с - запрещены коды цветов в стиле mIRC
  • h - не показывать списки доступа (баны, исключения) в ответ на запросы о них извне (от не зашедших на канал пользователей)
  • i - пользователи должны получить приглашение, чтобы зайти
  • m - модерируется (только операторы и имеющие статус голоса пользователи могут говорить на канале)
  • n - запрещены внешние сообщение (пользователи должны зайти на канал, чтобы говорить)
  • O - только операторы могут заходить на канал
  • p - частный (не виден в ответе на LIST)
  • R - на канал могут зайти только выполнившие авторизацию пользователи с зарегистрированными никами
  • M - на канале могут разговаривать только выполнившие авторизацию пользователи с зарегистрированными никами
  • s - секретный (не виден в ответе на LIST и в WHOIS информации пользователей)
  • t - топик могут устанавливать только операторы
  • 7 - разрешены только 7-битные ники
  • x - запрещены ники, состоящие из символов разных алфавитов
  • w - запрещены ники, содержащие слова, состоящие из символов разных алфавитов
  • k <key> - установить/снять ключ, требуемый для захода на канал
  • l [<limit>] - ограничить количество пользователей на канале
  • o <nick> - дать/забрать статус оператора на канале
  • v <nick> - дать/забрать статус голоса на канале
  • b <mask> - установить/снять бан для указанной nick!user@host маски
  • e <mask> - установить/снять исключение из банов для указанной nick!user@host маски
  • B <mask> - установить/снять расширенный бан для указанной маски nick!user@host:server (здесь и далее соответсвие пользователя такой маске определяется с учетов имени сервера пользователя).
  • E <mask> - установить/снять расширенное исключение из банов для указанной маски nick!user@host:server.
  • X <mask> - установить/снять эксклюзивный доступ для указанной маски nick!user@host:server; при наличии списка +X канал доступен только тем пользователям, которые соответствуют маскам из этого списка.


MOTD [<dest>]

Возвращает сообщения дня (Message Of The Day). Если указан параметр <dest>, то ответ приходит от удаленного сервера. <dest> может быть маской ника или сервера.


Команда MS является коротким синонимом для MEMOSERV.


NAMES <channel>

Возвращает список пользователей на канале в данный момент времени, включая статус оператора и голоса, если есть. Имена пользователей для +s канала возвращаются только если вы находитесь на этом канале в данный момент; то же самое относится к +i пользователям.


NICK <nickname>

Меняет ваш ник на указанный.


NICKSERV :<data>

Безопасно отправляет указанные данные на NickServ@services.some.net.


Синтаксис команды NOTICE идентичен синтаксису PRIVMSG.


Команда NS является коротким синонимом для NICKSERV.


OPERSERV :<data>

Безопасно отправляет указанные данные на OperServ@services.some.net.


Команда OS является коротким синонимом для OPERSERV.


PART <channel>[,<channel> ...] [:<message>]

Выход c указанных каналов с необязательным сообщением.


PASS :<password>

Используется на этапе подключения к серверу. Если сервер не требует пароль при подключении, то указанный пароль будет отправлен на NickServ (посредством SIDENTIFY).


PING :<arbitrary data>

Запрашивает ответ PONG с указанными произвольными данными от сервера к которому вы подключены.

PING <nick> <dest>

Запрашивает ответ PONG с единственным параметром <nick> от сервера <dest>. <nick> должен быть вашим ником, иначе ответ не придет.


PONG :<arbitrary data>

Должно отсылаться в ответ на запрос сервера "PING :<arbitrary data>".


PRIVMSG <nick>[@<servername>][,<nick>[@<servername>] ...(18)] :<message>

Используется для доставки текстового сообщения указанным пользователям. Если для имени пользователя указан сервер, то сообщение будет доставлено только в том случае, если пользователь подключен именно к этому серверу. Это гарантирует безопасность доставки, особенно для сервисов.

PRIVMSG [@][+]<channel>[,[@][+]<channel> ...(18)] :<message>

Используется для доставки текстового сообщения на указанные каналы. Если перед именем канала указан префикс '@', то сообщение посылается всем операторам канала. Также, наличие префикса '+' направляет сообщение всем, кто имеет статус голоса на канале, или и тем и другим, если присутствуют оба префикса.


QUIT [:<comment>]

Отсоединяет вас от сервера, с необязательным сообщением.


ROOTSERV :<data>

Безопасно отправляет указанные данные на RootServ@services.some.net.


Команда RS является коротким синонимом для ROOTSERV.


SERVICES :<data>

Безопасно отправляет указанные данные на ChanServ или NickServ, в зависимости от того, куда они предназначаются, судя по их содержимому.


SILENCE [+|-<mask>]

Добавляет или удаляет указанную маску nick!user@host в вашем silence списке. Пользователи, соответствующие маскам в вашем silence списке не могут отправлять вам сообщения PRIVMSG и NOTICE. Если маска не указана, возвращается имющийся на данный момент список. Количество масок, которое может содержать этот список, сообщается сервером в значении парамерта SILENCE при подключении.


Команда SS является коротким синонимом для STATSERV.


STATS <specifier> [<parameters>]

Возвращает статистику сервера. Доступные спецификаторы:

  • G|g - показать G:lines из конфигурации сервера
  • M|m - показать статистику использования команд
  • N|n - показать статистику подключений пользователей
  • p - показать доступных для оказания помощи операторов на данный момент и их время молчания в секундах
  • Q|q - показать Q:lines из конфигурации сервера
  • r - показать R:lines из конфигурации сервера
  • u [<dest>] - показать время работы сервера

Если указан параметр <dest>, то ответ приходит от удаленного сервера. <dest> может быть маской ника или сервера.


STATSERV :<data>

Безопасно отправляет указанные данные на StatServ@services.some.net.


TIME [<dest>]

Возвращает локальное время сервера на данный момент. Если указан параметр <dest>, то ответ приходит от удаленного сервера. <dest> может быть маской ника или сервера.


TOPIC <channel> [:<topic>]

Возвращает топик для указанного канала; или устанавливает его, при наличии параметра <topic>.


TRACE <dest>

Возвращает пошаговый маршрут к цели. Если <dest> является ником, также возвращается информация о текущих правах доступа пользователя, имени пользователя, хосте и классе соединения. <dest> может быть маской ника или сервера.


USER <username> * * :<real name>

Используется при регистрации во время подключения.


USERS

Возвращает количество локальных и глобальных пользователей (на данный момент и максимальное).


USERHOST <nick>[ <nick> ...(3)]

Возвращает информацию об указанных пользователях в компактном виде. Сначала идет ник, потом -- '*' если пользователь оператор, '=', '-' если пользователь выставил флажок отсутствия (иначе -- '+'), имя пользователя, '@', хост. Информация о нескольких пользователях разделена пробелами.


VERSION [<dest>]

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


WATCH [+|-<nick>][ +|-<nick> ...]

Добавляет или удаляет указанные ники для вашего watch списка. Сервер будет уведомлять вас когда кто-нибудь из вашего watch списка появится в онлайне или уйдет в оффлайн. Если не указан ни один ник, возвращаются те ники из вашего watch списка, которые находятся в онлайне на данный момент.

WATCH [flag]

Возвразает информацию о вашем watch списке. Флами могут быть следующими:

  • c|C - очистить список
  • s|S - показать общее состояние
  • l - показать информацию об онлайн никах в списке
  • L - показать информацию о всех никах в списке


WHO <nick>

Возвращает информацию об указанном пользователе: ник, имя пользователя, хост, канал, сервер, количество хопов, флаги статуса, настоящее имя.

WHO <channel>

Возвращает информацию о всех пользователях на указанном канале.

WHO <wildcard mask>

Если маска содержит ',', она сравнивается с хостами всех видимых (у которых нет мода +i) пользователей; иначе, маска сравнивается с никами всех видимых пользователей. Возвращается информация обо всех пользователях, соответствующих маске.

WHO <+-flags> [<parameters>]

Флаги указываются как для модов канала -- например, "-a+c" означает "не отсутствует" и "на указанном канале". Флаги могут быть следующими:

  • a - пользователь отсутствует
  • C - показать первый видимый канал, на котором находится пользователь
  • M - искать пользователей на одних каналах со мной
  • c <channel> - пользователь находится на указанном канале (маски не разрешены)
  • h <mask> - хост пользователя соответствует указанной маске
  • m <umodes> - у пользователя установлены указанные моды (из 'o', 'A' и 'a')
  • n <mask> - ник соответвствует указанной маске
  • s <server> - пользователь поключен к указанному серверу (маски не разрешены)
  • u <mask> - имя пользователя соответствует указанной маске


WHOIS [<dest>] <nick>[,<nick> ...]

Возвращает информацию об указанном пользователях: ник, имя пользователя, хост, настоящее имя, каналы, имя и информация сервера, статус идентификации ника, статус отсутствия, статус IRC оператора. Если сервер возвращает информацию о своем пользователе, он также сообщает время молчания пользователя и его кодовую страницу на сервере. Если указан параметр <dest>, запрос отправляется указанному серверу. <dest> может быть маской ника или сервера.


WHOWAS <nick>[,<nick> ...] [<max> [<dest>]]

Возвращает для указанных пользователей информацию, сохраненную когда они были в онлайне: ник, имя пользователя, хост, настоящее имя, сервер, время выхода из сети (UTC). Если указан параметр <max>, возвращается не более чем max записей; по умолчанию возвращаются все. Если указан параметр <dest>, запрос посылается указанному серверу (с удаленного сервера приходит не более 20 записей). <dest> может быть маской ника или сервера.

Команды оператора

CHATOPS :<message>

Отправляет указанное сообщение всем операторам с модом +b.


CLOSE

Закрывает все неизвестные соединения (которые еще не прошли регистрацию, или на стадии создания линка или в процессе разрыва соединения).


CONNECT <server>

Производит попытку линковки к серверу с указанным сервером. <server> может быть маской сервера.

CONNECT <server> <port> <dest>

Дает указание <dest> сделать попытку линковки к <server> на указанный порт. <server> и <dest> могут быть масками сервера.


DIE [<password>]

Завершает работу сервера. Возможно, для этого потребуется пароль.


FORCECP <nick> <name>

Меняет указанному пользователю кодовую страницу на сервере на определенную параметром <name>. <name> может быть именем кодовой страницы или одним из его алиасов.


GLOBOPS :<message>

Отправляет указанное сообщение всем операторам с модом +g.


HELP

Выдает справку по командам оператора, (по умолчанию находится в файле doc/opers.txt после установки сервера).


HTM [option]

Устанавливает или показывает установки High Traffic Mode. Если никаких опций не указано, возвращаются установки на данный момент. Доступные опции:

  • ON - включает HTM
  • OFF - выключает HTM
  • QUIET - отключает уведомления об автоматическом переходе в HTM
  • NOISY - включает уведомления об автоматическом переходе в HTM
  • TO <max> - устанавливает порог HTM в <max> килобайт/сек


KILL <nick>[,<nick> ...(18)] :<reason>

Принудительно отсоединяет указанных пользователей от IRC сети, с указанным сообщением.


KLINE [<minutes>] <mask> :<reason>

Добавляет бан для указанной user@host маски на сервере. Бан потеряет силу после заданного количества минут; или, если параметр <minutes> не указан -- через время по умолчанию, если оно было задано при конфигурировании сервера, в противном случае бан будет постоянным. Для установки постоянного бана при установленном по умолчанию времени бана укажите в параметре <minutes> 0.

Параметр <mask> может быть ником, в этом случае маска будет сгенерирована сервером. Также, поддерживаются маски адресов в стиле CIDR (например, 204.127.54.112/28).

Маска вида *@ip добавляет баны, аналогичные бывшим Z-lines.


LOCOPS :<message>

Отправляет указанное сообщение всем локальным операторам на сервере.


MODE <nick> [<+-modes>]

Дополнительные моды пользователя:

  • A - администратор сервера
  • a - администратор сервисов
  • b - получать CHATOPS сообщения
  • c - видеть соединения/отсоединения клиентов
  • d - получать отладочные сообщения сервера
  • e - видеть DCCALLOW трафик
  • F - не подвергаться recvq throttling
  • f - получать сообщения сервера о флуде
  • g - получать GLOBOPS сообщения
  • h - присутствовать в ответе на /stats p
  • j - получать сообщения о drones
  • K - получать сообщения о принудительных отсоединениях клиентов сервисами
  • k - получать сообщения о принудительных отсоединениях клиентов серверами
  • m - получать предупреждения о спамботах
  • n - получать сообщения маршрутизации
  • o - глобальный оператор
  • O - локальный оператор
  • w - получать WALLOPS сообщения
  • y - видеть запросы на данные о сервере и сети


Синтаксис команды NOTICE идентичен синтаксису PRIVMSG.


OPER <username> <password>

Получить права оператора.


PRIVMSG #<mask> :<message>

Отправляет указанное сообщение всем пользователям, хост которых соответствует указанной маске.

PRIVMSG $<mask> :<message>

Отправляет указанное сообщение всем пользователям на всех серверах, имя которых соответствует указанной маске сервера.


REHASH [option]

Если не указано никаких опций, сервер перечитывает свой файл конфигурации. Возможные опции:

  • DNS - сбросить кэш DNS и перечитать /etc/resolv.conf
  • TKLINES - очистить все временные K:lines
  • GC - выполнить сбор мусора в куче
  • MOTD - перечитать message of the day файл
  • IP - перестроить хэш IP
  • AKILLS - перестроить autokill хэш
  • THROTTLES - очистить throttles
  • DRONES - перегрузить модуль drone


RESTART [<password>]

Делает рестарт сервера. Возможно, потребуется пароль.


SAMODE <channel> <modes>

Администраторы сервисов могут использовать эту команду, чтобы устанавливать моды на любых каналах, не имея статус операторов на них. Синтакс такой же, как и для команды MODE.


SET <option> [<number>]

Показывает или изменяет настройки сервера. Возможные опции:

  • MAX - максимальное количество пользователей
  • SPLITDELAY - время восстановления из сплита
  • FLUDNUM - количество сообщений, при которых срабатывает flud тревога
  • FLUDTIME - количество секунд, в течение которых должно быть FLUDNUM сообщений для срабатывания защиты от flud
  • FLUDBLOCK - количество секунд, в течение которых будет блокироваться flud
  • SPAMNUM - количество заходов на каналы, при которых срабатывает spambot защита
  • SPAMTIME - время на каналах, при котором срабатывает spambot защита

Сервер не будет принимать клиентов больше максимального их количества. Время восстановления из сплита используется для определения того, когда можно давать статус оператора канала при заходе на пустой канал, в течение сплита. CTCP флуд обнаруживается по количеству CTCP за определенное время и блокируется на указанный промежуток. Возможные spambot'ы определяются количеством циклов join/part за определенное время.


SQUIT <mask>

Отсоединяет первый найденный сервер, соответсвующий указанной маске, от его аплинка.


STATS <flag> [<dest>]

Возвращает статистику сервера. Если указан параметр <dest>, ответ приходит от удаленного сервера. <dest> может быть маской ника или сервера. Возможные флаги:

  • a - показать сетевые баны
  • b|B - показать статистику кодовых страниц
  • c|C - показать C:lines и N:lines из конфигурации сервера
  • e|E - показать E:lines из конфигурации сервера
  • f|F - показать F:lines из конфигурации сервера
  • h|H - показать H:lines из конфигурации сервера
  • I|i - показать I:lines из конфигурации сервера
  • k - показать временные локальные баны
  • K - показать постоянные локальные баны
  • l [<dest>] - показать статистику соединения серверов или пользователя
  • L - показать статистику DNSBL
  • O|o - показать O:lines из конфигурации сервера
  • P - показать P:lines из конфигурации сервера
  • s|S - показать снимок серверного кэша
  • t|T - показать статистику траффика
  • U - показать U:lines из конфигурации сервера
  • V|v - показать присоединенные сервера
  • Y|y - показать Y:lines из конфигурации сервера
  • z|Z - показать статистику использования памяти
  • ? [<dest>] - показать статистику сервера


UNKLINE <mask>

Удалить указанную user@host маску из списка банов сервера.


WALLOPS :<message>

Отправляет указанное сообщение всем операторам с модом +w.



Оригинал взят с сраницы разработчика - http://www.ircd.ru/ru/commands.shtml




Рейтинг@Mail.ru