Lista komend


Opis

Komendy to polecenia wysyłane do IRC. Zwykle w programach do IRC poprzedzane są znakiem /, np. /join #help, czy /list. Poniższy dokument zawiera listę wszystkich poleceń obsługiwanych przez nasz serwer, wraz z przykładami zastosowania. Komendy nie muszą być pisane dużymi literami. Komendy zostały ułożone w kolejności od najczęściej do najrzadziej używanych.

Wiele programów ma swoje zestawy komend, np. w irssi /kb to odpowiednik polecenia KICK, a potem MODE +b maska – typowe komendy wbudowane w oprogramowanie do IRC zostaną opisane oddzielnie. Dodatkowo, niektóre programy (np. irssi) nie rozumieją innych komend niż te wbudowane - wtedy takie komendy należy poprzedzić poleceniem /quote, lub /raw, np. /quote CYCLE #help.

Tekst podkreślony to parametr, który zastępujemy własnymi danymi, np. nick zamieniamy na futrzak (jeśli nasz nick na IRC to "futrzak"). Parametry w [kwadratowych nawiasach] nie są wymagane do prawidłowego działania komendy – oczywiście gdy je wpisujemy, należy zrobić to bez nawiasów.

JOIN

Składnia: /JOIN kanał1[,kanał2,kanał3...] [klucz1,klucz2,klucz3...]

Wchodzi na podany kanał. Pierwszy, wymagany parametr to nazwa przynajmniej jednego kanału na który chcemy wejść. Możemy podać więcej kanałów oddzielając je przecinkami. Drugi, opcjonalny parametr, to klucz (hasło) do kanału (jeśli kanał posiada tryb +k). Możemy również podać więcej kluczy oddzielając je przecinkami. Podanie liczby 0 jako parametr kanał powoduje opuszczenie wszystkich kanałów.

Przykład zastosowania: /join #help

QUIT

Składnia: QUIT [powód]

Rozłącza Cię z siecią IRC. Użytkownicy będący na tych samych kanałach co Ty dostaną informację o tym, że wyszedłeś. Podanie powodu sprawi, że obok wiadomości o Twoim wyjściu pojawi się komunikat.

Przykład zastosowania: /quit Na razie!

NICK

Składnia: /NICK nowy_nick

Zmienia nasz nick na sieci na nick podany w parametrze.

Przykład zastosowania: /nick futrzakowa

NAMES

Składnia: /NAMES kanał

Wyświetla listę użytkowników na podanym kanale. Użyteczne w programach, które nie wyświetlają stale listy z boku okna.

Przykład zastosowania: /names #help

MODE

Składnia: /MODE kanał/nick tryb

Zmienia ustawienia nicku/kanału. Listę możliwych ustawień (flag) możesz znaleźć na podstronie kanały i użytkownicy

Przykład zastosowania: /mode #help +s

Jest możliwe ustawienie wielu trybów jednocześnie. Przykładowe polecenie /mode #help +ohls nick1 nick2 12 spowoduje jednoczesne ustawienie trybu +o dla nick1, +h dla nick2, limitu użytkowników na kanale na 12, oraz trybu +s.

AWAY

Składnia: /AWAY [powód]

Ustawia Twój status na IRC (dostępny/zaraz wracam). Podanie parametru powód powoduje ustawienie dodatkowego opisu do naszego statusu. Brak podania tego parametru wyłącza status "zaraz wracam".

Przykład zastosowania: /away Nie ma mnie teraz przy komputerze

WHOIS

Składnia: /WHOIS nick

Wyświetla informacje o podanym nicku, np. ident, host, realname, kanały, serwer do którego jest podłączony, informacje o tym czy jest zalogowany do serwisów, serwer do którego użytkownik jest podłączony, kiedy użytkownik ostatnio był aktywny i czy ma status AWAY.

Przykład zastosowania: /whois futrzak

LIST

Składnia: /LIST [warunek]

Bez parametru warunek wyświetla pełną listę kanałów na sieci - nie jest to mądre, ponieważ w przypadku dużej ilości kanałów do użytkownika mogą zostać przesłane olbrzymie ilości danych, co może spowolnić łącze (a nawet rozłączyć użytkownika z sieci). W przypadku podania parametru warunek, wyniki wyszukiwania są zawężone do tych, które pasują do podanego warunku.

Warunki mogą być następujące:

Przykład zastosowania: /list *help*

TOPIC

Składnia: /TOPIC kanał [temat]

Pokazuje temat na kanale podanym w pierwszym parametrze, lub zmienia go, jeśli podamy drugi parametr.

Przykład zastosowania: /topic #help Kanał pomocy PIRC.PL.

PART

Składnia: /PART kanał1[,kanał2,kanał3...] [powód]

Opuszcza podany kanał (lub kanały). Opcjonalnie możemy podać powód, który zostanie wyświetlony obok komunikatu o tym, że opuściliśmy kanał.

Przykład zastosowania: /part #help Dzięki za pomoc ;)

KICK

Składnia: /KICK kanał nick [powód]

Wyrzuca użytkownika z podanego kanału. Parametr powód jest opcjonalny - jest to wiadomość wyświetlana w nawiasie obok komunikatu o tym, że użytkownik został wykopany, widoczny przez wszystkich użytkowników będących akurat na kanale.

Przykład zastosowania: /kick #help futrzak Naruszenie regulaminu kanału.

CYCLE

Składnia: /CYCLE kanał1[,kanał2,kanał3,...]

Wychodzi i wchodzi na podany kanał. To polecenie to odpowiednik wysłania PART a potem JOIN. Możemy podać więcej niż jeden kanał, oddzielając go przecinkiem.

Przykład zastosowania: /cycle #help

INVITE

Składnia: /INVITE [nick kanał]

Zaprasza użytkownika na podany kanał. Jeśli kanał na który zapraszamy użytkownika ma status +i, musimy posiadać na nim uprawnienia operatora aby zapraszać na niego użytkowników. Bez parametrów, komenda INVITE wyświetla listę wszystkich kanałów na które otrzymałeś zaproszenia.

Przykład zastosowania: /invite futrzak #help

NOTICE

Składnia: /NOTICE [prefiks]nick/kanał wiadomość

Wysyła komunikat do podanego nicku, lub kanału. Jako parametr prefiks możemy zastąpić którymś z symboli uprawnień, co sprawi że wiadomość otrzymają tylko osoby posiadające minimum podane uprawnienia na kanale. Aby wysłać komunikat do +,%,@ musimy posiadać uprawnienia voice (+v), zaś aby wysłać komunikat do @,& musimy posiadać uprawnienia operatora (+o).

Przykład zastosowania: /notice +#help Tę wiadomość dostaną użytkownicy posiadający przynajmniej flagę voice (+v) na kanale #help.

WHO

Składnia: /WHO [kanał/+/-flagi argument]

Wyświetla informacje o użytkownikach.

Flagi podawane są tak samo, jak ustawienia kanału - flagi cgmnsu mają arugmenty. Możemy łączyć flagi, a znak + lub - oznacza istnienie, lub brak określonego warunku. Lista flag:

Możemy zobaczyć różne flagi w wiadomości którą zobaczymy po wpisaniu tej komendy:

Przykład zastosowania: /who +m o

KNOCK

Składnia: /KNOCK kanał wiadomość

Jeśli kanał ma flagę +i (invote only, kanał wymagający zaproszenia) możemy "zapukać" (z ang. KNOCK) do kanału, prosząc o zaproszenie.

Przykład zastosowania: /knock #help Jestem operatorem, wpuśćcie mnie!

LUSERS

Składnia: /LUSERS [serwer]

Wyświetla liczbę użytkowników na serwerze do którego jesteśmy podłączeni, lub na serwerze podanym w parametrze.

Przykład zastosowania: /lusers samu.pirc.pl

MOTD

Składnia: /MOTD [serwer]

Wyświetla wiadomość powitalną na serwerze do którego jesteśmy podłączeni, lub na serwerze podanym w parametrze.

Przykład zastosowania: /motd

WHOWAS

Składnia: /WHOWAS nick [ilość_odpowiedzi]

Wyświetla poprzednie informacje o podanym nicku, z jego poprzednich połączeń do sieci IRC.

Przykład zastosowania: /WHOWAS futrzak 3

ADMIN

Składnia: /ADMIN [serwer]

Pokazuje informacje o administracji serwera, do którego jesteśmy aktualnie podłączeni. Opcjonalny parametr serwer pokaże nam informacje o administracji innego serwera IRC niż ten, do którego jesteśmy akurat podłączeni.

Przykład zastosowania: /admin insomnia.pirc.pl

ISON

Składnia: /ISON nick1 [nick2 nick3...]

Sprawdza czy podane nicki są podłączone do sieci IRC. Możemy podać więcej niż jeden nick oddzielając go spacją.

Przykład zastosowania: /ISON futrzak

WATCH

Składnia: /WATCH [+/-nick1 nick2 nick3...]

System powiadamiania o połączeniu się do sieci naszych znajomych. Możemy dodać (+nick1 nick2 nick3...) lub usunąć (-nick1 nick2 nick3) znajomych do listy, lub wyświetlić ją nie podając żadnego parametru. Dostaniemy komunikat gdy któryś z nicków na naszej liście podłączy się do sieci. Lista watch nie zostaje zachowana pomiędzy sesjami - jeśli się rozłączymy, przy ponownym podłączeniu do sieci będziemy musieli ustawić listę od nowa.

Przykład zastosowania: /watch +futrzak

SILENCE

Składnia: /SILENCE [+/-nick]

Blokuje wiadomości od podanego nicka już na poziomie naszego serwera. Podanie jako parametr +nick doda nick do listy ignorowanych, zaś -nick go usunie. Brak parametru wyświetli listę wszystkich blokowanych nicków.

Przykład zastosowania: /silence +futrzak

SETNAME

Składnia: /SETNAME nowy_gecos

Pozwala zmienić nasze realname (GECOS) bez konieczności rozłączania się z siecią IRC.

Przykład zastosowania: /setname Jan Kowalski

MAP

Składnia: /MAP

Pokazuje graficzną mapę sieci.

Przykład zastosowania: /map

LINKS

Składnia: /LINKS

Wyświetla listę serwerów aktualnie połączonych do sieci w formacie: nazwa odległość opis, gdzie odległość liczona jest w serwerach od tego serwera, do którego jesteśmy aktualnie podłączeni (ma on odległość 0).

Przykład zastosowania: /links

TIME

Składnia: /TIME [serwer]

Wyświetla datę i godzinę na serwerze, który podamy, lub na serwerze do którego jesteśmy podłączeni.

Przykład zastosowania: /time samu.pirc.pl

USERHOST

Zwraca host użytkownika podanego w parametrze. Zwykle używane przez skrypty, lub boty.

Przykład zastosowania: /userhost futrzak

USERIP

Zwraca adres IP użytkownika podanego w parametrze. Zwykle używane przez skrypty, lub boty. Zwraca zamaskowany adres, jeśli użytkownik posiada vhosta/cloak.

Przykład zastosowania: /userip futrzak

Komendy wbudowane w programy do IRC

Niemal wszystkie używane obecnie programy do IRC modyfikują niektóre z wymienionych powyżej poleceń, w celu ułatwienia i przyśpieszenia ich użycia. Przykładowo, zazwyczaj można użyć polecenia /PART [powód] – a więc nie podając kanału. Program sam dopisze nazwę tego kanału, który obecnie widać na ekranie. Ponieważ zachowanie to zależy od użytego programu, nie będziemy tutaj szczegółowo opisywać tej funkcjonalności.

Oprócz modyfikacji istniejących komend serwera, większość klientów posiada także własne polecenia, które albo upraszczają wykonywanie pewnych czynności na IRC, albo wpływają na zachowanie samego programu. Poniżej wymienione zostało kilka popularnych komend realizujących to pierwsze z zadań. Nie ma gwarancji, że wszystkie te polecenia zadziałają w każdym programie – autor klienta mógł niektóre rzeczy zrealizować w inny sposób, bądź też całkiem pominąć.

MSG

Składnia: /MSG kanał/nick wiadomość

Powoduje wysłanie wiadomości na wybrany kanał, lub też wiadomości prywatnej do wybranej osoby.

Przykład zastosowania: /msg futrzak Cześć!

QUERY

Składnia: /QUERY nick

Powoduje otwarcie okna prywatnej rozmowy z użytkownikiem.

Przykład zastosowania: /query futrzak

ME

Składnia: /ME wiadomość

Powoduje wysłanie wiadomości do bieżącego kanału lub użytkownika, informującej o wykonywanej właśnie przez Ciebie czynności.

Przykład zastosowania: /me idzie spać.

Efekt: * futrzak idzie spać.

CTCP

Składnia: /CTCP kanał/nick polecenie

Powoduje wysłanie komunikatu CTCP (Client To Client Protocol) do wybranego użytkownika lub kanału. Niektóre z dostępnych poleceń:

Przykład zastosowania: /ctcp futrzak version

BAN

Składnia: /BAN nick/ident@host

Odpowiednik MODE +b. Powoduje ustawienie tzw bana, czyli zabrania wejścia użytkownika na kanał.

Przykład zastosowania: /ban Spamer

KB

Składnia: /KB nick [powód]

Odpowiednik MODE +b a następnie KICK. Powoduje ustawienie bana, a następnie wyrzuca użytkownika z kanału.

Przykład zastosowania: /kb Spamer idź i nie wracaj!

SAY

Składnia: /SAY tekst

Powoduje wysłanie wiadomości w bieżącej rozmowie. Przydatne, gdy chcemy wysłać wiadomość zaczynającą się od znaku /, ale nie chcemy, aby została potraktowana jako polecenie.

Przykład zastosowania: /say /nick nowy_nick - zobacz, takie polecenie zmieni twój nick.

OP, DEOP, VOICE, DEVOICE...

Składnia: /OP [kanał] nick

Wiele podobnych poleceń, pozwalających na uproszczenie użycia komendy MODE. Pozwalają na ustawienie (OP) lub zabranie (DEOP) statusu operatora na bieżącym kanale, podobnie z VOICE/DEVOICE i innymi. Szczegółów szukaj w dokumentacji swojego programu.

Przykład zastosowania: /voice futrzak

Strona główna

Strona główna - Krótki opis sieci i podstawowe informacje na jej temat.

Bramka

Bramka - Specjalny interfejs WWW umożliwiająca ircowanie z przeglądarki, bez konieczności instalowania dodatkowego oprogramowania.

Informacje

Regulamin - zbiór zasad których użytkownicy PIRC.PL są zobowiązani przestrzegać.

Prace - informacje na temat prac, które administratorzy sieci aktualnie wykonują. W tym miejscu będą również zamieszczane wszelkie ważniejsze ogłoszenia.

I:Line - informacje dla administratorów serwerów shell, akademików, sieci osiedlowych i każdego innego miejsca, które wymaga połączenia do naszej sieci więcej osób z jednego adresu IP.

SSL - informacje dla osób chcących połączyć się z naszą siecią korzystając z bezpiecznego połączenia SSL.

Tor i proxy - informacje dla osób próbujących połączyć się z naszą siecią z serwerów TOR i PROXY.

Pomoc administracji - dodatkowa pomoc w pilnowaniu porządku na naszym kanale.

API - opis naszego modułu do wyświetlania statystyk kanału na własnej stronie WWW.

Bannery - generowane przez naszą stronę banery z informacjami o kanałach.

Logo - informacje na temat naszego logo

O nas - nieco więcej informacji na temat sieci i nas, administratorów, oraz krótka historia powstania tego miejsca.

Polecane - mała reklama - strony które sieć PIRC.PL poleca użytkownikom.

Serwisy

NickServ - rejestracja nicków.

ChanServ - rejestracja kanałów.

BotServ - postawienie na swoim kanale bota.

HostServ - ukrywanie swojego adresu IP.

MemoServ - wiadomości do niezalogowanych użytkowników.

Pomoc

Podstawy - miejsce od którego każdy początkujący powinien zacząć. Zbiór podstawowych pojęć i informacji które powinieneś posiadać.

Kanały - informacje na temat zarządzania kanałami i opis ich ustawień,

Użytkownicy - informacje na temat interakcji serwera z użytkownikiem i opis ustawień, które każdy może sobie nałożyć,

Konwersja kodowania - opis naszego autorskiego modułu do konwersji kodowania.

Częste problemy - czyli FAQ, odpowiedzi na często zadawane przez użytkowników pytania.

Statystyki

Podsumowanie - generalne informacje na temat wykorzystania sieci.

Wykresy - graficzna reprezentacja ilości użytkowników i kanałów w przedziale czasu.

Lista kanałów - lista największych kanałów na sieci.

Statystyki kanałów - strona pozwalająca obejrzeć informacje dotyczące poszczególnych kanałów.

Kontakt

Kontakt - alternatywna droga kontaktu z administracją.