Strict Standards: Declaration of action_plugin_importoldindex::register() should be compatible with DokuWiki_Action_Plugin::register($controller) in /var/www/html/lib/plugins/importoldindex/action.php on line 8

Strict Standards: Declaration of action_plugin_popularity::register() should be compatible with DokuWiki_Action_Plugin::register($controller) in /var/www/html/lib/plugins/popularity/action.php on line 57

Strict Standards: Declaration of action_plugin_safefnrecode::register() should be compatible with DokuWiki_Action_Plugin::register($controller) in /var/www/html/lib/plugins/safefnrecode/action.php on line 66

Strict Standards: Declaration of action_plugin_importoldchangelog::register() should be compatible with DokuWiki_Action_Plugin::register($controller) in /var/www/html/lib/plugins/importoldchangelog/action.php on line 182

Warning: Cannot modify header information - headers already sent by (output started at /var/www/html/lib/plugins/importoldindex/action.php:8) in /var/www/html/inc/actions.php on line 607

Warning: Cannot modify header information - headers already sent by (output started at /var/www/html/lib/plugins/importoldindex/action.php:8) in /var/www/html/inc/actions.php on line 607

Warning: Cannot modify header information - headers already sent by (output started at /var/www/html/lib/plugins/importoldindex/action.php:8) in /var/www/html/inc/actions.php on line 607
====== Cor4 szerver kapcsolat ====== A kapcsolat titkosítására [[http://en.wikipedia.org/wiki/RC6_cipher|RC6]] kódot használunk, melynek legfontosabb tulajdonsága, hogy szimmetrikus, azaz mindössze egy kódra van szükség, ami ráadásul tetszőleges jelsorozat lehet (nem kell prímnek lennie). Az alapötlet szerint ez a kód a jelszó [[http://en.wikipedia.org/wiki/MD5|MD5]] kódja, így a kliensen nincs szükség sem a jelszó sem a kód tárolására valamint a jelszó ismerete nélkül az esetleges elkapott üzenet is értelmezhetetlen marad. A kommunikáció bináris csomagokat alkalmaz a nagy adatmennyiségek hatékony átvitele céljából. Minden csomag egy négy bájtos hosszal kezdődik, amely a teljes csomag (a négy bájtos hosszon kívüli) méretét adja meg. A csomag hossza kódolt üzenet esetén is kódolatlan. Ezután egy bájton a csomag tipusa következik, majd az egyes csomagokra jellemző adatok. A következőkben az egyes üzenetek formátumát foglalom össze. Az egyes tipusokról [[tipusok|itt]] olvashat bővebben. ===== Általános csomagok ===== ==== OK ==== ^ Megnevezés ^ Tipus ^ Érték ^ | Csomag hossz | integer | | | Csomag tipus | byte | 00| | Megválaszolt csomag tipusa | byte | | | Véletlen adat | string | | ==== ERROR ==== ^ Megnevezés ^ Tipus ^ Érték ^ | Csomag hossz | integer | | | Csomag tipus | byte | 255 | | Megválaszolt csomag tipusa | byte | | | Hibakód | integer | | | Hiba szövege | string | | | Véletlen adat | string | | ===== Kapcsolatfelvétel, bontás ===== ==== LOGIN ==== A kliens küldi a szervernek. Az egyetlen kódolatlan üzenet, mely egyelőre csak a felhasználó nevét és a kliensverzió számát tartalmazza. A válasz már kódolt. Amennyiben a megadott felhasználó létezik, akkor a válasz egy **OK** üzenet, amely a felhasználó jelszavának MD5 kódjával kódolt. Amennyiben a megadott felhasználó nem létezik, akkor a válasz egy **ERROR** üzenet véletlenszerű kóddal kódolva. ^ Megnevezés ^ Tipus ^ Érték ^ | Csomag hossz | integer | | | Csomag tipus | byte | 01 | | Felhasználó neve | string | | | Kliens verzió | 4 byte | 1.2.3.4 | ==== DISCONNECT ==== A kliens küldi a szervernek, melynek hatására a szerver egyszerűen megszakítja a kapcsolatot. ^ Megnevezés ^ Tipus ^ Érték ^ | Csomag hossz | integer | | | Csomag tipus | byte | 02 | ===== Adminisztráció ===== ==== CHPASS ==== A kliens küldi a szervernek a jelszó megváltoztatása céljából. A szerver ennek hatására egy **OK** vagy egy **ERROR** üzenetet küld. Nyilvánvalóan a jelszó csak az **OK** üzenet visszajelzése esetén valósul meg. A kódolás a következő bejelentkezésig nem változik. ^ Megnevezés ^ Tipus ^ Érték ^ | Csomag hossz | integer | | | Csomag tipus | byte | 03 | | Új jelszó MD5 kódja [[http://en.wikipedia.org/wiki/Base64|base64]] kódolva | string | | ===== Adatbázis műveletek ===== ==== QUERY ==== A kliens által küldött lekérdezést tartalmazza. Mivel a szerver mögött tetszőleges adatbáziskezelő lehet, érdemes odafigyelni arra, hogy a küldött lekérdezés minden adatbáziskezelő által emészthető legyen. Amennyiben a lekérdezés hibát okoz a szerver **ERROR** üzenettel válaszol. Amennyiben a lekérdezés egy SELECT SQL utasítás, akkor a visszaadott csomag **RESULT** tipusú. Minden egyéb esetben (UPDATE, INSERT stb.) egy **OK** üzenetet kapunk. ^ Megnevezés ^ Tipus ^ Érték ^ | Csomag hossz | integer | | | Csomag tipus | byte | 04 | | Lekérdezés | string | | ==== RESULT_HEAD ==== A szerver által adott válasz a **QUERY** üzenetre. ^ Megnevezés ^ Tipus ^ Érték ^ | Csomag hossz | integer | | | Csomag tipus | byte | 05 | | Mezőnevek | stringlist | | | Mezőtipusok | n db byte | az egyes bájtok a megfelelő oszlop tipusát adják meg a lentebbi táblázat szerint | | Sorok száma | integer | | Ezután az üzenet után //Sorok száma// számú RESULT_ROW üzenet következik. Az alábbi táblázat adja meg a //Mezőtipusok// mezőben definiált tipusok jelentését. A tárolás a [[tipusok|tipusnak]] megfelelően történik. ^ Érték ^ Megnevezés ^ Értékkészlet ^ | 1 | integer | -232...232-1 | | 2 | string | | | 3 | boolean | true/false | | 4 | numeric | tetszőleges szám ((a PostgreSQL numeric tipusa //gyakorlatilag// tetszőleges szám tárolására alkalmas; a kliens által maximum 16-17 értékes jegy kerül tárolásra)) | | 5 | date | | ==== RESULT_ROW ==== A lekérdezés eredményének egyes sorai. ^ Megnevezés ^ Tipus ^ Érték ^ | Csomag hossz | integer | | | Csomag tipus | byte | 06 | | Sorszám | integer | a csomag lekérdezésbeli sorszáma | | Adat | raw | a fejléc által definiált mezők elválasztójel nélkül | ==== Példa ==== Példaként álljon itt egy két oszlopos lekérdezés eredménye (SELECT id,nev FROM varos LIMIT 5), ahol az //id// **integer** tipusú, a //nev// pedig természetesen **string**. A számok decimális számok. ^ Megnevezés ^ Érték ^ | Csomag hossz | 18 0 0 0 | | Csomag tipus | 5 | | Mezőnevek | 2 0 0 0 2 0 105 100 3 0 110 101 118 | | Mezőtipusok | 1 2 | | Sorok száma | 5 0 0 0 | ^ Megnevezés ^ Érték ^ | Csomag hossz | 21 | | Csomag tipus | 6 | | Sorszám | 1 0 0 0 | | Adatok | 1 0 0 0 8 0 98 117 100 97 112 101 115 116 5 | ^ Megnevezés ^ Érték ^ | Csomag hossz | 16 | | Csomag tipus | 6 | | Sorszám | 2 0 0 0 | | Adatok | 1 0 0 0 5 0 122 111 109 98 97 | ^ Megnevezés ^ Érték ^ | Csomag hossz | 18 | | Csomag tipus | 6 | | Sorszám | 3 0 0 0 | | Adatok | 1 0 0 0 7 0 114 97 107 97 109 97 122 | ^ Megnevezés ^ Érték ^ | Csomag hossz | 14 | | Csomag tipus | 6 | | Sorszám | 4 0 0 0 | | Adatok | 1 0 0 0 3 0 97 98 97 | ^ Megnevezés ^ Érték ^ | Csomag hossz | 19 | | Csomag tipus | 6 | | Sorszám | 5 0 0 0 | | Adatok | 1 0 0 0 8 0 97 98 97 108 105 103 101 116 |