Psotnic 0.2.x HOWTO [HU]

Ez a fájl tartalmazza az alapjait annak, hogy hogyan állítsd be (és használd) a psotnic irc botot.
Légyszíves olvasd el ezt a fájlt mielőtt butaságokat kérdeznél.

Kellemes olvasást.

***

please note that all translated howtos are based upon english version and they might be outdated
if you cannot find something in this document please check english version. --pks

***



1. Config fájl opciók


Kötelező választások az összes bothoz
nick a bot nickje
realname a bot valódi neve
nickappend egy pár jellemző amivel majd kiegészíti a nicket, ha azt elveszik (pl. -|`^, ezt a beállítást veszi figyelembe ha az `altuidnick' 0)
myipv4 a bot ip címe (pl. 88.45.56.15, 0.0.0.0, ez bármilyen címet jelent)
Kötelező választások a fő bothoz
listen a port amelyiken a fő figyeli az alárendelt/slave-k és tulajdonosok kapcsolatait (pl. 12345)
owenrpass a tulajdonos jelszava md5sum (fő jelszó) az osztott vonalon (ahhoz hogy egy md5hash.t csinálj, futtasd .psotnic- p -t)
Kötelező választások a fő slave-hez/alárendelt
listen a port, amelyiken a slave/alárendelt figyel a végcsúcsok kapcsolatait (pl. 12345)
hub a fő bot ipje, portja, jelszava (pl. 123.123.123.123 9000 some_password)
Kötelező választások a végcsúcsoknak
hub ip, port, jelszó és alárendelt változó név (pl. 111.111.111.111 8000 some_password slave1 )
További lehetőségek a végcsúcsnak
alt az alternatív slave ipje, portja (pl. 1111.111.222.222 9000, többször is be lehet állítani)
További opciók az összes bothoz
ident a bot felahsználóneve (alapból: ugyanaz mint a fiók név)
handle a bot változója, ami látható az osztott vonalon (alapból: ugyanaz mint a nick)
vhost ipv4 vagy ipv6 cím (pl: 217.2.3.54 vagy 3ffe:2f4:56:35:0:0:0:23), domain neveket nem támogatnak (alapból: az operációs rendszer határozza meg)
logfile fájl ahova bot loggolja az akciókat (alapból: dev/null :)
userlist felhasználólista (aka. felhasználói fájl) tárolja ott (alapból: $nick.ul)
altuidnick ki/bekapcsolja a nick 0 -ra változtatását ha a nicket elveszik (alapból ez be van kapcsolva)
ctcptype ctcp változat (alapból: találomra). Lehetséges választások: 0 = egyik sem, 1 = psotnic, 2 = irssi, 3 = epic, 4 = lice, 5 = bitch, 6 = dzony loker, 7 = luzik, 8 = mirc 6.14
keepnick nick tartás (alapból: 0)
kickreason kirúgás oka
limitreason akkor használt kirúgási ok amikor valaki átírja a csatorna limitjét
partreason lelépés oka
quitreason kilépés oka
cyclereason ciklus oka:)
További választások az összes botnak, azokat többször is be lehet állítani
server az irc szerver ipv4 (vagy ipv6 a 0.2.3 esetében) címe és portja (pl. 218.234.456.123 6667)
server6 az irc szerver ipv6 címe és portja (pl: 3ffe:2f4:56:35:0:0:0:23 6667) (ez az opció nincs jelen a 0.2.3 változatban)
Jegyezd meg, mivel a 0.2.3 config fájlt szerkesztheted osztott vonalon/partyline-ban, légyszíves olvasd el a 7. részt a részletekért.

2. A botnet beállítása


* A fő bot beállítása

Mindenek előtt másold a hub.conf-ot a cfg-examples dir-ből abba a könyvtárba, ahol a psotinic bináris van. Aztán szerkeszd :). Azután a következő amit tenned kell, hogy titkosítod a config fájlt, s ahhoz hogy ezt megtedd, futtasd a `psotnic -c config.file'-t. Ez vagy egy halom hibát ír ki vagy egyszerűen megmondja, hogy minden rendben ment. Most, hogy titkosítottad a config fájl, futtathatod a botot, hogy így tégy, futtasd a `psotnic config.file'-t, tanácsos azonban a config fájlt biztos helyre tenni, nyilvánvaló okokból.
Most hogy fut a bot és fut hozzá a telnet (telnet ip port) és beírod a tulajdonosodat jelszódat (nem az md5 hasht), ha jelszó jó, a bot kéri a logint és jelszót. Miután létrehozza a fiókot, a bot bontja a kapcsolatodat, így telnetelj vissza és add meg a tulajdonosi jelszódat, loginod és jelszódat. Most, mikor beléptél az osztott vonalra/ partyline-ra először írd be hogy `.help', ez az elérhető parancsok listáját hozza be, játssz ezekkel, nem fog fájni. ;p

* A slave beállítása

Alapvetően ugyanaz mint fentebb, de három különbséggel, első különbség, hogy conf.slave helyett conf.hub-ot használsz, második, hogy nem állítod be a tulajdonosi jelszót, harmadik, hogy nem telnetelsz a slave-be. A többi ugyanaz.
Miután elindítod a slave-t, új üzeneteket kell látnod partyline-ban az osztott kommunikációs vonalon, ha nem látsz kapcsolódási kísérletet, az azt jelenti, hogy az ip-k a slave config fájljában rosszak.
Most legfőbb ideje, hogy értesítsd a főt, hogy új slave-ünk lesz, hogy így tégy, írd be azokat parancsokat a partyline-ban:
.+bot handle IP
.+host handle nick*!ident@vhost (csak mikor a slave az ircen van)
.chattr handle s
.chpass handle some_password (a jelszó ugyanaz mint a slave/ alárendelt config - hub vonalban)

* A leaf beállítása

Ugyanaz mint a slave beállítása, de két különbséggel, először a conf.leaf helyett a conf.slave-t használod, második, ha te a `.chattr bot l' helyett `.chattr bot s' teszel.
Egy észrevétel: a leaf -et csak a slave-hez linkelheted, a fő bothoz nem.

3. Beállítások


Beállítások melyeket a .set parancs által irányíthatsz
cycle-delay ciklus késleltetés
rejoin-delay késleltetés miután a bot belép a csatornára ha kirúgták onnan
rejoin-fail-delay késleltetés miután a bot belép a csatornára ha az utolsó belépés sikertelen volt
hub-conn-delay késleltetés miután a bot megpróbál kapcsolódni a hubra
irc-conn-delay késleltetés miután a bot megpróbál újra kapcsolódni az ircre
auth-time ezután az idő után minden jogosulatlan kapcsolatot lezár
private-ctcp ki/bekapcsolja az egyéni ctcp választ az összes botnak
ops-per-mode ha ellenségek vannak a csatornán, az opok száma egy vonalban
ask-for-op-mode ez után az idő után ha még nem opolták, a bot opot kér
getop-op-check ki/bekapcsolja az ellenőrzést, ha a bot,ami opot kér, már kapott opot
conn-timeout az idő, miután minden jogosult inaktiv kapcsolatot lezár
keep-nick-check-delay ez a beállítás megmondja a botnak, hogymilyen gyakran ellenőrizzék, hogy szabad-e egy nick
remember-old-keys ki/bekapcsolja hogy emlékezzen a régi csatorna kulcsokra
telnet-owners ha 0 a tulajdonosok nem kapcsolódhatnak telnettel, ha 1 akkor az össze tulajdonos, akinek +pt flagje van, kapcsolódhat telnettel; ha 2, akkor csak azok a tulajdonosok, akiknek +pt flaget állítottak be és ipjüket hozzáadták a hostlistához, azok kapcsolódhatnak.
max-matches a .match -ben mutatott találatok max. száma
perip-max-shown-consaz egy IPről jövő kapcsolódási kísérletek max száma
perip-burst-size az egy IPről jövő jogosulatlan kapcsolódások max. száma
perip-ignore-time mennyi időre mellőzzön egy ipt, ami elérte a legnagyobb számú jogosulatlan kapcsolatot
synflood-max-conns az összes regisztrálatlan kapcsolat max. száma
synflood-ignore-time mennyi ideig mellőzzön minden ipt
bIe-mode-bounce-time ez után az idő után a botok eltávolítják a b/e/l csatorna módokat
wasop-cache-time ez a beállítás irányítja, hogy meddig tartson meg a bot információt az opról netsplit alatt
away-time az az idő, míg a botok távol vannak
chat-time az az idő, amikor a botok jelen vannak
between-msg-delay késleltetési idő az üzenetek elküldése között, amikor a botok jelen vannak (antiidle)
randomness az antidile/away véletlenszerűsége
public-away a nyilvános away-ek/back-ek ki/bekapcsolása
ident-clones az azonos identű emberek max száma egy adott csatornán
host-clnoes az azonos hostnevű/C alosztályú emberek max- száma egy adott csatornán
proxy-clones a hasonló domain és nem identtel rendelkező emberek ma. száma egy adott csatornán
clone-life-time idő, miután a klónokat törlik a klónlistáról
critical-bots ha minimális számú bot egy adott csatornán eléri ezt a számot, a botok bezárják a csatornát (+i)
quarantine-time irányítja a késleltetést aközött hogy egy hostot egy bothoz ad és belép a csatornára (bot hozzáadott host nélkül nem lép be csatornákra)

4. Helyi/csatorna beállítások


Csatorna beállítások, melyeket a .chset #csatorna parancs irányít
aop-bots bizonyos számú bot, melyet kijelöltek opolásra, mikor +ao emberek lépnek be
bot-aop-bots belépő botok opolására kijelölt botok száma
punish-bots vmi rosszat tevő emberek kirúgására kijelölt botok száma
getop-bots opot kérő botok száma
invite-bots meghívást kérső botok száma
guardian-bots azon botok száma, amelyek védik a csatorna módokat
channel-ctcp ki/bekapcsolja a channel ctcp kérésekre adott választ
enforce-bans ki/bekapcsolja a kitiltást kierőszakolást (=kirúgja azokat az embereket, akiknél feltett bant talált)
enforce-limits ki/bekapcsolja a limit kierőszakolást, ha valaki +n flaggel alacsonyabb határt állít be, akkor számos felhasználói bot `remove' /eltávolítja/ a felesleget
stop-nethack ki/bekapcsolja a -f emberek kirúgását, akik az irc szervertől opot kapnak
limit ki/bekapcsolja az autolimit funkciót
limit-time autolimit újraellenőrzési idő
limit-offset autolimit offset (új limit = number_of_users/a felhasználók száma + ez az érték)
limit-bots bizonyos számú limit bot hogy autolimiteljen
limit-tolerance a limit türelme (= limit offset* ezaz érték), ez a beállítás megakadályozza, hogy túl gyakran váltsanak limitet
owner-limit-time a tulajdonos erre az időre megváltoztathatja a limitet
takeover ki/bekapcsolja az átvételi módot
bitch ki/bekapcsolja a bitch módot
wasoptest ki/bekapcsolja azt, hogy emlékezzen az összes opra, amelyik splitelt/szakadt
clonecheck ki/bekapcsolja a klón ellenőrzést
dynamic-bans ki/bekapcsolja a régi feltett banok eltávolítását
dynamic-invites ki/bekapcsolja a régi feltett meghívások eltávolítását
dynamic-exempt ki/bekapcsolja a régi feltett kivételek eltávolítását
lockdown ki/bekapcsolja a csatorna lezárását, ha a botok száma eléri a csatornán a kritikus szintet
lockdown-time nem használt -)
backup-mode-delay ...

5. Flagek/Jelzők


globális flagek
x fő tulajdonos (teljes irányítás)
s szuper tulajdonos (partyline belépés, bot módosítás, -s változó módosítás)
n normál tulajdonos (partyline belépés, -n változó módosítás)
t telnet kiváltság (még mindig szükséges +p a kapcsolódáshoz)
p partyline belépés flag
m mester (hiányzik a partyline belépés, mód által tud opolni egy személyt, nem tud csatorna módokat módosítani)
f barát (nem tud opolni, de kaphat opot az irc szerverektől, nem alkalmazhatóak shits/szarok ? rá)
o op (csak simán @)
v hang
a auto-mode (kombinálva +o-val, +a autoop-ot ad vagy auto-voice-t illetőleg)
d deop (a felhasználót kirúgja ha opot kap)
q csend (a felhasználótól elveszi a v-t, mikor hangot kap)
k kirúgás (a felhasználó kirúgja belépéskor)
c klón (a felhasználót nem veszi figyelembe a klónellenőrző algoritmus)
i meghívás (automeghívás kirúgás után mikor a csatorna tele van vagy zárt (+i))
r újraopolás(auto-reop deop esetén)
helyi zászlók
n csatorna tulajdonos (teljes csatorna irányítás, felhasználó nem tud deopolni/kirúgni/bannolni botot és kapcsolódni partyline-ba- hacsak nem kap globális +pt-t, aztán tud majd módosítani az egész csatorna változóin)
x|s|t|p flagek nem engedélyezetettek, más flagek úgy viselkednek, mint a globális zászlók ;)
bot flagek
h
s slave/ alárendelt
l leaf
y tölthetnek be modulokat
p értesíthetik a botnetet a hostja változásairól


6. Modulok/ elemek

Sok embernek van problémája velük, tehát itt egy rövid info hogyan töltsük be őket.

Mindenekelőtt szükséged van egy nem statikus változatú psotnic irc botra (igen, ez azt jelenti hogy nem tud betölteni modulokat a statikus változat).A psotnic csomag kicsomagolása után, lépj be a keret könyvtárba, a bot változatától függően sok fájlt kell látnod (0.2.2. esetében) vagy néhány fájl és két könyvtárat (0.2.3 esetében). Ha a 0.2.2 használod, egyszerűen futtasd a make clean && malke all -t, ennek az összes modult fel kell építenie, ha kapsz egy hibát az azt jelenti, hogy valami rossz történt és most egymagad vagy. Ha 0.2.3 felhasználó vagy, akkor gépeld be a make op && make spam (csak ezt a két modult tartalmazza, ha akarod a többit is ).Ha leforgattad a modulokat (module_name.so <- ez a module, nem module_name.cpp) szerkesztened kell a config fájlt. Mindkét esetben (0.2.2 és 0.2.3) hozzá kell adnod a következő sort a confighoz, hogy betölthesd a modult.

load /path/to/home/psotnic/framework/module_name.so

és egyszerűen kódold a configot és indítsd el a botot. Ez minden.

7. Config fájl szerkesztés partylineban (0.2.3rc1 óta)

Minden 0.2.3 botnak van egy partyline-on keresztüli szerkesztési opciója, hogy eljussunk a jelenlegi configba, ezt kell tennünk:
.bc botname cfg

Ez valami ilyesmit mutat hogy:
(botname) cfg: nick botname
(botname) cfg: realname Psotnic C++ Edition
és így tovább..

MEgváltoztathatod az adott opciót ezzel:
.bc botname cfg <option name> <new value>

Például:
.bc botname cfg kickreason blah blah
(15:08) #you# bc botname cfg kickreason blah blah
(botname) cfg: kickreason blah blah ra állítottam

Ahhoz, hogy mentsd a változásokat, ezt kell tenned:
.bc botname cfg-save

Néhány config opciónak egynél több esete is lehet, például szerver vagy alt opció.

Hogy addolj 3 szervert, csak írd ezt:
.bc botname cfg serverl 1.1.1.1 1111
.bc botname cfg server 2.2.2.2 2222
.bc botname cfg server 3.3.3.3 3333

Hogy eltávolítsd a másodikat:
.bc botname cfg server 2.2.2.2 2222

Ez minden, ne felejtsd el elmenteni cfg-t :)

8. Belépéskor host feloldó (csak linux)

Minden 0.2.3 változat psotnic hoz tartozik egy aszinkron feloldó, sajnos csak rc9 dolgozik megfelelően, tehát ha egy régebbi botod van, frissítsd azt.
Ahhoz, hogy engedélyezzük a feloldót be kell állítani a feloldó-szál config opcióját valami ésszerű értékre (pl. 4), minél nagyobb az érték, annál egyidejűbb feloldást fog produkálni, jegyezd meg, hogy linux alatt minden szál új folyamatot alkot. Ennek az opciónak a beállítása után indítsd újra a botot.

Ha látni akarod a feloldási statisztikát, csak írd be:
.status botname

9.Vége

Ezt az általános leírás annak, ami sok embert zavarba ejt, ha felfedezel benne valamilyen hibát, légyszíves tudasd velem, megpróbálom kijavítani őket minél hamarabb.

--
clone (clon{at}netcore.hu)

Copyright (c) 2003-2005 Grzegorz Rusin. All rights reserved.