IRC-komennot: täydellinen luettelo (RFC 1459 & 2812)
IRC-komennot: täydellinen luettelo (RFC 1459 & 2812) — kaikki IRC-käskyt selkeästi, syntaksi, valinnaiset parametrit ja esimerkit yhdestä paikasta.
Tämä on luettelo kaikista Internet Relay Chat -komennoista IETF RFC:stä 1459 ja 2812. Useimmat IRC-ohjelmat tarvitsevat komentojen eteen vinoviivan ("/"). Kulmasulkeet ("<" ja ">") tarkoittavat sitä, mitä toissijaiseen kenttään sijoitetaan, eivät kirjaimellista osaa komennosta. Hakasulkeisiin ("[" ja "]") koteloidut asetukset ovat valinnaisia ja kumoavat komennon oletusasetukset.
Käyttötavat ja syntaksi
IRC-komentojen syntaksi noudattaa RFC 1459/2812 -määrittelyjä: komento voi koostua yhdestä tai useammasta kentästä erotettuna välilyönneillä. Usein näet dokumentaatiossa merkittynä <parameter> tai <target> — korvaa nämä sopivalla arvolla. Kulmasulkeet merkitsevät paikanvaraajia, hakasulkeet valinnaisuutta. Asiakasohjelmat lisäävät käyttäjän syöttämien komentojen eteen yleensä "/"-merkin; protokollatasolla käskyt lähetetään ilman etuviivaa.
Yleiskomennot (yhteys ja tunnistautuminen)
- PASS <password>: salasana palvelimelle (jos tarpeen).
- NICK <nickname>: asettaa tai muuttaa käyttäjänimimerkin.
- USER <username> <mode> <unused> <realname>: ilmoittaa käyttäjän tiedot palvelimelle (pakollinen kirjautumisessa RFC 1459:ssa).
- QUIT [<message>]: katkaisee yhteyden; valinnainen syy viestinä.
- PING <server_or_token> / PONG <token>: yhteyden tarkastus ja vastaus.
Kanava- ja yksityisviestit
- JOIN <channel> [,<channel> ...] [<key>]: liittyy kanavalle (esim. /join #kanava).
- PART <channel> [<message>]: poistuu kanavalta.
- PRIVMSG <target> <message>: lähettää yksityis- tai kanavaviestin (asiakasohjelmissa usein /msg tai /privmsg).
- NOTICE <target> <message>: samanlainen kuin PRIVMSG, mutta ei odota automaattivastausta.
- TOPIC <channel> [<topic>]: näyttää tai asettaa kanavan aiheen.
- KICK <channel> <user> [<comment>]: potkii käyttäjän kanavalta (vain operaattoreilla oikeus).
- INVITE <nickname> <channel>: kutsuu käyttäjän kanavalle.
- NAMES [<channel>]: listaa kanavalla olevat käyttäjät.
- LIST [<channel>]: näyttää kanavat ja lyhyet kuvaukset.
Tarkastus-, haku- ja informaatio-komennot
- WHO [<name>] [<o|u>]: hakee tietoja käyttäjistä tai kanavasta.
- WHOIS <nick> [<server>]: näyttää tietoja käyttäjästä (rekisteröinti, palvelin, kanavat).
- WHOWAS <nick> [<count>] [<server>]: näyttää tiedot aiemmista nimimerkeistä.
- USERHOST <nick> [<nick2> ...]: näyttää käyttäjän host-tiedot lyhyesti.
- ISON <nick> [<nick2> ...]: kertoo, onko nimimerkki online.
- STATS <query> [<server>]: palvelintilastot (käyttötavat vaihtelevat).
- VERSION <server>: pyytää palvelimen/asiakasohjelman version.
- TIME <server>: kysyy palvelimen kellonaikaa.
- ADMIN <server> / INFO <server>: palvelimen ylläpitäjä- ja informaatiosisältö.
- MOTD [<server>]: näyttää palvelimen "Message of the Day".
Operaattori- ja palvelin-komennot
- OPER <user> <password>: nostaa käyttäjän operaattoriksi (vaatii oikeudet).
- SQUIT <server> [<comment>]: eristää/kytkee pois palvelimen (vain operaattorit).
- KILL <nick> <comment>: katkaisee toisen käyttäjän yhteyden (operaattori).
- CONNECT <server> <port>: pyytää palvelinta luomaan yhteyden toiseen palvelimeen.
- TRACE <server_or_user>: jäljittää reititystä palvelimelle tai käyttäjälle.
Kanavien ja käyttäjien tilamuutokset
- MODE <nickname|channel> [<mode> [<params>]]: muuttaa käyttäjän tai kanavan tiloja (esim. ops, yksityisyys, lukitus).
- AWAY [<message>]: asettaa tai poistaa poissaoloviestin.
- REHASH: lataa palvelimen konfiguraation uudelleen (operaattori).
Erityismääritykset ja laajennukset
- CTCP (Client-to-Client Protocol) ja DCC (Direct Client-to-Client) eivät ole suoraan RFC 1459/2812 -osissa, mutta ne ovat laajasti käytettyjä laajennuksia viestien ja tiedostojen välitykseen. CTCP-komennot näkyvät usein erikoismerkeillä ja ne käsitellään asiakasohjelmissa erikseen.
- Monet nykyaikaiset IRC-ohjelmat tukevat myös lisäkomentoja ja alias-määrityksiä (esim. /query, /me, /away) — nämä vaihtelevat asiakkaan mukaan.
Numerokoodit ja palvelinvastaukset
Palvelin vastaa usein numeerisin koodein (esim. 001 = tervetuliaistervehdys, 332 = TOPIC, 353 = NAMES-lista). Nämä koodit löytyvät RFC:stä ja palvelin-lokista. Asiakasohjelma näyttää yleensä ihmisluettavamman version tai kääntää numerot ymmärrettäväksi tekstiksi.
Esimerkkejä käytöstä
- Liittyminen ja viesti kanavalle: /join #esimerkki -> /privmsg #esimerkki Hei kaikki!
- Nimenvaihto: /nick UusiNimi
- Kutsuminen: /invite Ystävä #kanava
- Kanavalta poistuminen: /part #kanava Kiitos!
- Näytä kanavan käyttäjät: /names #kanava
Vinkkejä ja huomioita
- Usein asiakasohjelmat sallivat viestin, joka alkaa "/", lähettää sen komennoksi. Jos haluat viestin alkavan todellisella "/"-merkillä, monet asiakkaat tukevat "escape"-järjestelyä, esim. kirjoittamalla "//hei" lähettää tekstin "/hei".
- Kanavat tunnistaa tavallisesti etuliitteistä kuten "#" tai "&"; jotkin verkot käyttävät myös "+"-etuliitettä rajoitetuille kanaville.
- Operaattoritoiminnot (KILL, SQUIT, OPER) ovat voimakkaita ja vaativat varovaisuutta sekä oikeudet.
- IRC-protokolla ei itsessään tarjoa vahvaa salausta; käytä tarvittaessa TLS/SSL-yhteyksiä ja varmista palvelimen luotettavuus.
Lisätietoja
Tämä luettelo kattaa RFC 1459:n ja 2812:n määrittämät peruskomennot ja yleisimmin käytetyt laajennukset. Erilaiset IRC-verkot ja -asiakkaat saattavat lisätä omia käskyjään tai käyttäytymistapojaan — tarkista oman verkon tai asiakkaan dokumentaatio yksityiskohdista ja laajennuksista.
Aiheeseen liittyvät sivut
Etsiä