Справочник команд

Основано на 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>]

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


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 модов в одной команде. Допустимые моды:

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

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


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>]

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

Если указан параметр <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 списке. Флами могут быть следующими:


WHO <nick>

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

WHO <channel>

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

WHO <wildcard mask>

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

WHO <+-flags> [<parameters>]

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


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. Если никаких опций не указано, возвращаются установки на данный момент. Доступные опции:


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>]

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


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


OPER <username> <password>

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


PRIVMSG #<mask> :<message>

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

PRIVMSG $<mask> :<message>

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


REHASH [option]

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


RESTART [<password>]

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


SAMODE <channel> <modes>

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


SET <option> [<number>]

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

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


SQUIT <mask>

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


STATS <flag> [<dest>]

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


UNKLINE <mask>

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


WALLOPS :<message>

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


(C) rzhe@WeNet, 2001-2003

Hosted by firstvds SourceForge