Lista poleceń Internet Relay Chat — List of Internet Relay Chat commands
Jest to lista wszystkich poleceń programu Internet Relay Chat z RFC 1459, RFC 2812 oraz rozszerzeń dodanych do głównych demonów IRC. Większość klientów IRC wymaga, aby polecenia były poprzedzone ukośnikiem (" /
"). Niektóre komendy są faktycznie wysyłane do botów IRC ; są one traktowane przez protokół IRC jako zwykłe wiadomości, a nie jako /
-polecenia.
Stosowane tu konwencje: Nawiasy kątowe ("<" i ">") są tutaj używane do wskazania symbolu zastępczego dla pewnej wartości i nie są dosłowną częścią polecenia. Nawiasy kwadratowe („[” i „]”) są używane do wskazania, że wartość jest opcjonalna .
Polecenia użytkownika
ADMINISTRATOR
Składnia:
ADMIN [<target>]
Nakazuje serwerowi zwrócenie informacji o administratorach serwera określonego przez <cel>, gdzie <cel> jest serwerem lub użytkownikiem. Jeśli <cel> jest pominięty, serwer powinien zwrócić informacje o administratorach bieżącego serwera.
Z DALA
Składnia:
AWAY [<message>]
Udostępnia serwerowi wiadomość do automatycznego wysłania w odpowiedzi na PRIVMSG skierowane do użytkownika, ale nie do kanału, na którym się znajduje. Jeśli <wiadomość> zostanie pominięta, status nieobecny jest usuwany. Zdefiniowane w RFC 1459.
WSKAZÓWKA
Składnia:
CNOTICE <nickname> <channel> :<message>
Wysyła wiadomość NOTICE do kanału <nickname> na <kanał>, który omija ograniczenia ochrony przed zalaniem. Pseudonim docelowy musi znajdować się w tym samym kanale, co klient wydający komendę, a klient musi być operatorem kanału.
Zwykle serwer IRC ogranicza liczbę różnych celów, do których klient może wysyłać wiadomości w określonych ramach czasowych, aby uniemożliwić spamerom lub botom masowe przesyłanie wiadomości do użytkowników w sieci, jednak to polecenie może być używane przez operatorów kanałów, aby ominąć ten limit w ich kanał. Na przykład jest często używany przez operatorów pomocy, którzy mogą jednocześnie komunikować się z dużą liczbą użytkowników w kanale pomocy.
To polecenie nie jest formalnie zdefiniowane w RFC, ale jest używane przez niektóre sieci IRC. Wsparcie jest wskazywane w odpowiedzi RPL_ISUPPORT (numer 005) ze słowem kluczowym CNOTICE
CPRIVMSG
Składnia:
CPRIVMSG <nickname> <channel> :<message>
Wysyła prywatną wiadomość do <nickname> na <channel>, która omija ograniczenia ochrony przed zalaniem. Pseudonim docelowy musi znajdować się w tym samym kanale, co klient wydający komendę, a klient musi być operatorem kanału.
Zwykle serwer IRC ogranicza liczbę różnych celów, do których klient może wysyłać wiadomości w określonych ramach czasowych, aby uniemożliwić spamerom lub botom masowe przesyłanie wiadomości do użytkowników w sieci, jednak to polecenie może być używane przez operatorów kanałów, aby ominąć ten limit w ich kanał. Na przykład jest często używany przez operatorów pomocy, którzy mogą jednocześnie komunikować się z dużą liczbą użytkowników w kanale pomocy.
To polecenie nie jest formalnie zdefiniowane w RFC, ale jest używane przez niektóre sieci IRC. Wsparcie jest wskazywane w odpowiedzi RPL_ISUPPORT (liczba 005) ze słowem kluczowym CPRIMSG
ŁĄCZYĆ
Składnia:
-
CONNECT <target server> [<port> [<remote server>]]
(RFC 1459) -
CONNECT <target server> <port> [<remote server>]
(RFC 2812)
Instruuje serwer <serwer zdalny> (lub bieżący serwer, jeśli <serwer zdalny> jest pominięty), aby połączyć się z <serwerem docelowym> na porcie <port>. To polecenie powinno być dostępne tylko dla operatorów IRC . Zdefiniowane w RFC 1459; parametr <port> stał się obowiązkowy w RFC 2812.
UMIERAĆ
Składnia:
DIE
Nakazuje serwerowi zamknięcie. To polecenie może wydać tylko operatorzy serwerów IRC. Zdefiniowane w RFC 2812.
ENCAP
Składnia:
:<source> ENCAP <destination> <subcommand> <parameters>
To polecenie jest używane przez serwery do hermetyzowania poleceń, tak aby były one propagowane na serwerach centralnych, które nie zostały jeszcze zaktualizowane do ich obsługi, i wskazuje, że podpolecenie i jego parametry powinny być przekazywane w niezmienionej postaci do miejsca docelowego, gdzie zostaną one zdekapsułowane i przeanalizowane. Ułatwia to wdrażanie nowych funkcji bez konieczności ponownego uruchamiania wszystkich serwerów, zanim będą one dostępne w sieci.
BŁĄD
Składnia:
ERROR <error message>
To polecenie jest używane przez serwery do zgłaszania błędów innym serwerom. Jest również używany przed zakończeniem połączeń klientów. Zdefiniowane w RFC 1459.
WSPARCIE
Składnia:
HELP
Żąda od serwera wyświetlenia pliku pomocy. To polecenie nie jest formalnie zdefiniowane w RFC, ale jest używane przez większość głównych demonów IRC.
INFORMACJE
Składnia:
INFO [<target>]
Zwraca informacje o serwerze <target> lub o bieżącym serwerze, jeśli <target> jest pominięty. Zwracane informacje obejmują wersję serwera, czas jego kompilacji , poziom poprawek , datę uruchomienia oraz wszelkie inne informacje, które można uznać za istotne. Zdefiniowane w RFC 1459.
ZAPRASZAĆ
Składnia:
INVITE <nickname> <channel>
Zaprasza <nick> na kanał <kanał>. <kanał> nie musi istnieć, ale jeśli tak, tylko członkowie kanału mogą zapraszać innych klientów. Jeśli i
ustawiony jest tryb kanału , tylko operatorzy kanałów mogą zapraszać innych klientów. Zdefiniowane w RFC 1459.
ISON
Składnia:
ISON <nicknames>
Wysyła zapytanie do serwera, aby sprawdzić, czy klienci na rozdzielonej spacjami liście <nicknames> są aktualnie w sieci. Serwer zwraca tylko pseudonimy znajdujące się w sieci na liście oddzielonej spacjami. Jeśli żaden z klientów nie znajduje się w sieci, serwer zwraca pustą listę. Zdefiniowane w RFC 1459.
PRZYSTĄP
Składnia:
JOIN <channels> [<keys>]
Sprawia, że klient dołącza do kanałów na liście rozdzielanej przecinkami <kanały>, określając hasła, jeśli to konieczne, na liście rozdzielanej przecinkami <klucze>. Jeśli kanał(y) nie istnieją, zostaną utworzone. Zdefiniowane w RFC 1459.
KOPNIĘCIE
Składnia:
KICK <channel> <client> :[<message>]
Przymusowo usuwa <klienta> z <kanału>. Ta komenda może być wydana tylko przez operatorów kanałów. Zdefiniowane w RFC 1459.
ZABIĆ
Składnia:
KILL <client> <comment>
Wymusza usunięcie <klienta> z sieci. Ta komenda może być wydana tylko przez operatorów IRC. Zdefiniowane w RFC 1459.
PUKANIE
Składnia:
KNOCK <channel> [<message>]
Wysyła POWIADOMIENIE do <kanału> tylko na zaproszenie z opcjonalnym <wiadomością> z prośbą o zaproszenie. To polecenie nie jest formalnie zdefiniowane przez RFC, ale jest obsługiwane przez większość głównych demonów IRC. Wsparcie jest wskazywane w odpowiedzi RPL_ISUPPORT (liczba 005) ze słowem kluczowym KNOCK.
SPINKI DO MANKIETÓW
Składnia:
LINKS [<remote server> [<server mask>]]
Wyświetla listę wszystkich łączy serwera pasujących do <maski serwera>, jeśli podano, na <serwer zdalny> lub na bieżącym serwerze, jeśli został pominięty. Zdefiniowane w RFC 1459.
LISTA
Składnia:
LIST [<channels> [<server>]]
Wyświetla wszystkie kanały na serwerze. Jeśli podano rozdzieloną przecinkami listę <kanały>, zwróci ona tematy kanałów. Jeśli podano <serwer>, polecenie zostanie przekazane do <serwera> w celu oceny. Zdefiniowane w RFC 1459.
LUSERS
Składnia:
LUSERS [<mask> [<server>]]
Zwraca statystyki dotyczące rozmiaru sieci. W przypadku wywołania bez argumentów statystyki będą odzwierciedlać całą sieć. Jeśli podano <maska>, zwróci tylko statystyki odzwierciedlające zamaskowany podzbiór sieci. Jeśli podano <cel>, polecenie zostanie przekazane do <serwera> w celu oceny. Zdefiniowane w RFC 2812.
TRYB
Składnia:
MODE <nickname> <flags> (user)
MODE <channel> <flags> [<args>]
Polecenie MODE jest dwufunkcyjne. Może być używany do ustawiania zarówno trybu użytkownika, jak i kanału. Zdefiniowane w RFC 1459.
MOTD
Składnia:
MOTD [<server>]
Zwraca wiadomość dnia na <serwer> lub na bieżącym serwerze, jeśli jest pominięty. Zdefiniowane w RFC 2812.
NAZWY
Składnia:
-
NAMES [<channels>]
(RFC 1459) -
NAMES [<channels> [<server>]]
(RFC 2812)
Zwraca listę osób znajdujących się na rozdzielonej przecinkami liście <kanałów> według nazwy kanału. Jeśli <kanały> jest pominięte, wszyscy użytkownicy są pokazani, pogrupowani według nazwy kanału, przy czym wszyscy użytkownicy, którzy nie są na kanale, są pokazywani jako część kanału "*". Jeśli określono <serwer>, polecenie jest wysyłane do <serwera> w celu oceny. Zdefiniowane w RFC 1459; opcjonalny parametr <serwer> został dodany w RFC 2812.
Odpowiedź zawiera wszystkie pseudonimy w kanale poprzedzone najwyższym prefiksem statusu kanału tego użytkownika, na przykład w ten sposób (przy czym @ jest najwyższym prefiksem statusu)
:irc.server.net 353 Phyre = #SomeChannel :@WiZ
Jeśli klient chce otrzymywać wszystkie prefiksy statusu kanału użytkownika, a nie tylko jego aktualny najwyższy prefiks, można włączyć rozszerzenie wieloprefiksowe IRCv3 (@ to prefiks operatora kanału, a + niższy prefiks statusu głosu):
:irc.server.net 353 Phyre = #SomeChannel :@+WiZ
Zobacz także NAMESX poniżej, aby uzyskać alternatywne, starsze podejście do osiągnięcia tego samego efektu. Jednak obecnie większość klientów i serwerów obsługuje nowy standard IRCv3.
NAZWYX
Składnia:
PROTOCTL NAMESX
Nakazuje serwerowi wysyłanie nazw w odpowiedzi RPL_NAMES poprzedzonych wszystkimi odpowiednimi statusami kanałów zamiast tylko najwyższym (podobnie jak w przypadku multiprefiksu IRCv3).
Na przykład:
Z NAMESX
:irc.server.net 353 Phyre = #SomeChannel :@+WiZ
Bez NAMESX
:irc.server.net 353 Phyre = #SomeChannel :@WiZ
Ta komenda może być użyta TYLKO, jeśli w odpowiedzi RPL_ISUPPORT (liczba 005) zostanie zwrócone słowo kluczowe NAMESX. Może być również łączony z poleceniem UHNAMES.
To polecenie nie jest formalnie zdefiniowane w RFC, ale jest rozpoznawane przez większość głównych demonów IRC. Nowszym nowoczesnym podejściem jest użycie rozszerzeń protokołu IRCv3 do aktywowania rozszerzenia wieloprefiksowego dla zwykłego polecenia NAMES.
NACIĘCIE
Składnia:
-
NICK <nickname> [<hopcount>]
(RFC 1459) -
NICK <nickname>
(RFC 2812)
Umożliwia klientowi zmianę pseudonimu IRC. Hopcount jest używany między serwerami, aby określić odległość pseudonimu od jego serwera macierzystego. Zdefiniowane w RFC 1459; opcjonalny parametr <hopcount> został usunięty w RFC 2812.
ZAUWAŻYĆ
Składnia:
NOTICE <msgtarget> <message>
To polecenie działa podobnie do PRIVMSG, z wyjątkiem tego, że automatyczne odpowiedzi nie mogą być wysyłane w odpowiedzi na wiadomości NOTICE. Zdefiniowane w RFC 1459.
OPER
Składnia:
OPER <username> <password>
Uwierzytelnia użytkownika jako operatora IRC na tym serwerze/sieci. Zdefiniowane w RFC 1459.
CZĘŚĆ
Składnia:
PART <channels> [<message>]
Powoduje, że użytkownik opuszcza kanały na liście rozdzielanej przecinkami <kanały>. Zdefiniowane w RFC 1459.
PRZECHODZIĆ
Składnia:
PASS <password>
Ustawia hasło połączenia. To polecenie musi zostać wysłane przed kombinacją rejestracji NICK/USER. Zdefiniowane w RFC 1459.
ŚWIST
Składnia:
PING <server1> [<server2>]
Sprawdza obecność połączenia. Wiadomość PING skutkuje odpowiedzią PONG. Jeśli określono <serwer2>, wiadomość zostanie do niego przekazana. Zdefiniowane w RFC 1459.
PONG
Składnia:
PONG <server1> [<server2>]
To polecenie jest odpowiedzią na polecenie PING i działa w bardzo podobny sposób. Zdefiniowane w RFC 1459.
PRYWMSG
Składnia:
PRIVMSG <msgtarget> :<message>
Wysyła <message> do <msgtarget>, którym zwykle jest użytkownik lub kanał. Zdefiniowane w RFC 1459.
ZREZYGNOWAĆ
Składnia:
QUIT [<message>]
Odłącza użytkownika od serwera. Zdefiniowane w RFC 1459.
REHASZ
Składnia:
REHASH
Powoduje, że serwer ponownie odczytuje i ponownie przetwarza swoje pliki konfiguracyjne. Ta komenda może być wysłana tylko przez operatorów IRC. Zdefiniowane w RFC 1459.
ZASADY
Składnia:
RULES
Żąda reguł serwera. To polecenie nie jest formalnie zdefiniowane w RFC, ale jest używane przez większość głównych demonów IRC.
SERWER
Składnia:
SERVER <servername> <hopcount> <info>
Komunikat serwera służy do poinformowania serwera, że drugim końcem nowego połączenia jest serwer. Ta wiadomość służy również do przekazywania danych serwera w całej sieci. <hopcount> określa, ile przeskoków (połączeń z serwerem) dzieli <nazwa_serwera>. <info> zawiera dodatkowe czytelne dla człowieka informacje o serwerze.
Zdefiniowane w RFC 1459.
USŁUGA
Składnia:
LISTA SERWIS
SQUERY
Składnia:
SQUERY <servicename> <text>
Identyczny z PRIVMSG, z wyjątkiem tego, że odbiorca musi być usługą. Zdefiniowane w RFC 2812.
SQUIT
Składnia:
SQUIT <server> <comment>
Powoduje, że <serwer> zamyka sieć. Zdefiniowane w RFC 1459.
SETNAME
Składnia:
SETNAME <new real name>
Umożliwia klientowi zmianę „prawdziwego nazwiska” określonego podczas rejestrowania połączenia.
To polecenie nie jest formalnie zdefiniowane przez RFC, ale jest używane przez niektóre demony IRC. Wsparcie jest wskazane w odpowiedzi RPL_ISUPPORT (numer 005) ze słowem kluczowym SETNAME
CISZA
Składnia:
SILENCE [+/-<hostmask>]
Dodaje lub usuwa maskę hosta do listy ignorowanych po stronie serwera, która uniemożliwia pasującym użytkownikom wysyłanie wiadomości klienta. Na liście oddzielonej spacjami można określić więcej niż jedną maskę, przy czym każdy element jest poprzedzony znakiem „+” lub „-” w celu określenia, czy jest dodawany lub usuwany. Wysłanie polecenia bez parametrów zwraca wpisy na liście ignorowanych klienta.
To polecenie nie jest formalnie zdefiniowane w RFC, ale jest obsługiwane przez większość głównych demonów IRC. Wsparcie jest wskazywane w odpowiedzi RPL_ISUPPORT (liczba 005) ze słowem kluczowym SILENCE i maksymalną liczbą wpisów, które klient może mieć na swojej liście ignorowanych. Na przykład:
:irc.server.net 005 WiZ WALLCHOPS WATCH=128 SILENCE=15 MODES=12 CHANTYPES=#
STATYSTYKI
Składnia:
STATS <query> [<server>]
Zwraca statystyki dotyczące bieżącego serwera lub <serwer>, jeśli jest określony. Zdefiniowane w RFC 1459.
WEZWAĆ
Składnia:
-
SUMMON <user> [<server>]
(RFC 1459) -
SUMMON <user> [<server> [<channel>]]
(RFC 2812)
Daje użytkownikom, którzy są na tym samym hoście co <serwer> wiadomość z prośbą o dołączenie do IRC. Zdefiniowane w RFC 1459; opcjonalny parametr <kanał> został dodany w RFC 2812.
CZAS
Składnia:
TIME [<server>]
Zwraca czas lokalny na bieżącym serwerze lub <serwer>, jeśli jest określony. Zdefiniowane w RFC 1459.
TEMAT
Składnia:
TOPIC <channel> [<topic>]
Umożliwia klientowi wysyłanie zapytań lub ustawianie tematu kanału na <kanał>. Jeśli podano <topic>, ustawia temat kanału na <topic>. Jeśli ustawiony jest tryb kanału +t, tylko operator kanału może ustawić temat. Zdefiniowane w RFC 1459.
NAMIERZAĆ
Składnia:
TRACE [<target>]
Śledź ścieżkę w sieci IRC do określonego serwera lub klienta w sposób podobny do traceroute . Zdefiniowane w RFC 1459.
UHNAMES
Składnia:
PROTOCTL UHNAMES
Instruuje serwer, aby wysłał nazwy w odpowiedzi RPL_NAMES w długim formacie:
Z UHNAMES
:irc.server.net 353 Phyre = #SomeChannel :WiZ!user@somehost
Bez UHNAMES
:irc.server.net 353 Phyre = #SomeChannel :WiZ
To polecenie może być użyte TYLKO, jeśli w odpowiedzi RPL_ISUPPORT (liczba 005) zostanie zwrócone słowo kluczowe UHNAMES. Może być również połączony z poleceniem NAMESX.
To polecenie nie jest formalnie zdefiniowane w RFC, ale jest rozpoznawane przez większość głównych demonów IRC.
UŻYTKOWNIK
Składnia:
-
USER <username> <hostname> <servername> <realname>
(RFC 1459) -
USER <user> <mode> <unused> <realname>
(RFC 2812)
To polecenie jest używane na początku połączenia, aby określić nazwę użytkownika, nazwę hosta, prawdziwe imię i początkowe tryby użytkownika łączącego się klienta. <rzeczywista> może zawierać spacje i dlatego musi być poprzedzona dwukropkiem. Zdefiniowane w RFC 1459, zmodyfikowane w RFC 2812.
UŻYTKOWNIK
Składnia:
USERHOST <nickname> [<nickname> <nickname> ...]
Zwraca listę informacji o podanych pseudonimach. Zdefiniowane w RFC 1459.
USERIP
Składnia:
USERIP <nickname>
Żąda bezpośredniego adresu IP użytkownika o określonym pseudonimie. To polecenie jest często używane do uzyskania adresu IP nadużywającego użytkownika, aby skuteczniej przeprowadzić ban. Nie jest jasne, czy i jakie uprawnienia są wymagane do wykonania tego polecenia na serwerze.
To polecenie nie jest formalnie zdefiniowane przez RFC, ale jest używane przez niektóre demony IRC. Wsparcie jest wskazywane w odpowiedzi RPL_ISUPPORT (liczba 005) ze słowem kluczowym USERIP.
UŻYTKOWNICY
Składnia:
USERS [<server>]
Zwraca listę użytkowników i informacje o tych użytkownikach w formacie podobnym do poleceń systemu UNIX who , rusers i finger . Zdefiniowane w RFC 1459.
WERSJA
Składnia:
VERSION [<server>]
Zwraca wersję <serwer> lub bieżący serwer, jeśli został pominięty. Zdefiniowane w RFC 1459.
WALLOPS
Składnia:
WALLOPS <message>
Wysyła <wiadomość> do wszystkich operatorów podłączonych do serwera (RFC 1459) lub wszystkich użytkowników z ustawionym trybem użytkownika 'w' (RFC 2812). Zdefiniowane w RFC 1459.
ZEGAREK
Składnia:
WATCH [+/-<nicknames>]
Dodaje lub usuwa użytkownika do listy znajomych klienta po stronie serwera. Na liście oddzielonej spacjami można podać więcej niż jeden pseudonim, każdy element poprzedzony znakiem „+” lub „-” oznaczającym, czy jest dodawany lub usuwany. Wysłanie polecenia bez parametrów zwraca wpisy na liście znajomych klienta.
To polecenie nie jest formalnie zdefiniowane w RFC, ale jest obsługiwane przez większość głównych demonów IRC. Wsparcie jest wskazywane w odpowiedzi RPL_ISUPPORT (liczba 005) ze słowem kluczowym WATCH i maksymalną liczbą wpisów, które klient może mieć na swojej liście znajomych. Na przykład:
:irc.server.net 005 WiZ WALLCHOPS WATCH=128 SILENCE=15 MODES=12 CHANTYPES=#
KTÓRY
Składnia:
WHO [<name> ["o"]]
Zwraca listę użytkowników pasujących do <nazwa>. Jeśli zostanie podana flaga "o", serwer zwróci tylko informacje o operatorach IRC. Zdefiniowane w RFC 1459.
KTO JEST
Składnia:
WHOIS [<server>] <nicknames>
Zwraca informacje o rozdzielonej przecinkami liście masek pseudonimów <pseudonimy>. Jeśli podano <serwer>, polecenie jest przekazywane do niego w celu przetworzenia. Zdefiniowane w RFC 1459.
KTO BYŁ
Składnia:
WHOWAS <nickname> [<count> [<server>]]
Służy do zwracania informacji o pseudonimie, który nie jest już używany (z powodu rozłączenia klienta lub zmiany pseudonimu). Jeśli zostanie podany, serwer zwróci informacje z ostatnich <count> razy użyty przez pseudonim. Jeśli podano <serwer>, polecenie jest przekazywane do niego w celu przetworzenia. W RFC 2812 <pseudonim> może być listą rozdzielonych przecinkami pseudonimów.
Zdefiniowane w RFC 1459.
Zobacz też
Bibliografia
Bibliografia
- Oikarinen, Jarkko ; Reed, Darren (maj 1993). Protokół czatu Internet Relay . IETF . doi : 10.17487/RFC1459 . RFC 1459 . Źródło 30 października 2009 .
- Kalt, Christophe (kwiecień 2000). Internet Relay Chat: Protokół klienta . IETF . doi : 10.17487/RFC2812 . RFC 2812 . Źródło 30 października 2009 .
Dalsza lektura
- Reed, Darren (maj 1992). Dyskusja na temat konferencji sieci komputerowych . IETF . doi : 10.17487/RFC1324 . RFC 1324 . Źródło 30 października 2009 .
- Kalt, Christophe (kwiecień 2000). Internet Relay Chat: Architektura . IETF . doi : 10.17487/RFC2810 . RFC 2810 . Źródło 30 października 2009 .
- Kalt, Christophe (kwiecień 2000). Internet Relay Chat: Zarządzanie kanałami . IETF . doi : 10.17487/RFC2811 . RFC 2811 . Źródło 30 października 2009 .
- Kalt, Christophe (kwiecień 2000). Internet Relay Chat: Protokół serwera . IETF . doi : 10.17487/RFC2813 . RFC 2813 . Źródło 30 października 2009 .