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.

Tekijä: Leandro Alegsa

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ä
AlegsaOnline.com - 2020 / 2025 - License CC3