File: libtlen.html

package info (click to toggle)
libtlen 20041113-3
links: PTS
area: main
in suites: etch, etch-m68k, sarge
size: 832 kB
ctags: 1,514
sloc: ansic: 13,713; sh: 214; makefile: 156
file content (4652 lines) | stat: -rw-r--r-- 75,768 bytes
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML
><HEAD
><TITLE
>libtlen</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="libtlen.css"><META
NAME="description"
CONTENT="taki sobie
	 tecik"><META
HTTP-EQUIV="content-type"
content="text/html; charset=ISO-8859-2"></HEAD
><BODY
CLASS="BOOK"
BGCOLOR="#FFFFFF"
TEXT="#000000"
><DIV
CLASS="BOOK"
><A
NAME="AEN1"
></A
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>libtlen</A
></H1
><H2
CLASS="SUBTITLE"
>Dokumentacja biblioteki libtlen</H2
><H3
CLASS="AUTHOR"
><A
NAME="AEN6"
></A
>Mateusz Papiernik</H3
><H3
CLASS="AUTHOR"
><A
NAME="AEN9"
></A
>Hubert Sokoowski</H3
><H3
CLASS="AUTHOR"
><A
NAME="AEN12"
></A
>Piotr Pawow</H3
><P
CLASS="COPYRIGHT"
>Copyright &copy; 2002 libtlen-dev Team</P
><HR></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Spis tre&#347;ci</B
></DT
><DT
>1. <A
HREF="#AEN18"
>API biblioteki.</A
></DT
><DD
><DL
><DT
>1.1. <A
HREF="#AEN20"
>Zaczynamy.</A
></DT
><DT
>1.2. <A
HREF="#AEN29"
>Zdarzenia.</A
></DT
><DD
><DL
><DT
>1.2.1. <A
HREF="#AEN32"
>Zdarzenia obsugiwane jeden raz na pocztku sesji.</A
></DT
><DT
>1.2.2. <A
HREF="#AEN37"
>Pozostae zdarzenia.</A
></DT
><DT
>1.2.3. <A
HREF="#AEN49"
>Zawarto struktury tlen_event</A
></DT
></DL
></DD
><DT
>1.3. <A
HREF="#AEN52"
>Poczmy si.</A
></DT
><DD
><DL
><DT
>1.3.1. <A
HREF="#AEN63"
>Funkcje.</A
></DT
></DL
></DD
></DL
></DD
><DT
>2. <A
HREF="#AEN93"
>Specyfikacja katalogu publicznego</A
></DT
><DD
><DL
><DT
>2.1. <A
HREF="#AEN95"
>Tagi z parametrami katalogu publicznego</A
></DT
><DT
>2.2. <A
HREF="#AEN136"
>Odczyt danych z katalogu publicznego</A
></DT
><DT
>2.3. <A
HREF="#AEN144"
>Zmiana naszych danych w katalogu publicznym</A
></DT
><DT
>2.4. <A
HREF="#AEN151"
>Wyszukiwanie</A
></DT
><DD
><DL
><DT
>2.4.1. <A
HREF="#AEN153"
>Zapytanie</A
></DT
><DT
>2.4.2. <A
HREF="#AEN160"
>Odpowied od serwera</A
></DT
></DL
></DD
></DL
></DD
><DT
>3. <A
HREF="#AEN173"
>Dokumentacja funkcji biblioteki</A
></DT
><DD
><DL
><DT
>3.1. <A
HREF="#AEN176"
>auth.c</A
></DT
><DD
><DL
><DT
>3.1.1. <A
HREF="#AEN179"
>tlen_hash()</A
></DT
><DT
>3.1.2. <A
HREF="#AEN187"
>tlen_getid()</A
></DT
><DT
>3.1.3. <A
HREF="#AEN195"
>tlen_authorize()</A
></DT
></DL
></DD
><DT
>3.2. <A
HREF="#AEN203"
>events.c</A
></DT
><DD
><DL
><DT
>3.2.1. <A
HREF="#AEN206"
>tlen_starttag_handler()</A
></DT
><DT
>3.2.2. <A
HREF="#AEN214"
>tlen_endtag_handler()</A
></DT
><DT
>3.2.3. <A
HREF="#AEN222"
>tlen_char_handler()</A
></DT
><DT
>3.2.4. <A
HREF="#AEN230"
>tlen_parsebuffer()</A
></DT
><DT
>3.2.5. <A
HREF="#AEN238"
>tlen_addevent()</A
></DT
><DT
>3.2.6. <A
HREF="#AEN246"
>tlen_getevent()</A
></DT
><DT
>3.2.7. <A
HREF="#AEN254"
>tlen_newevent()</A
></DT
><DT
>3.2.8. <A
HREF="#AEN262"
>tlen_freeevent()</A
></DT
><DT
>3.2.9. <A
HREF="#AEN270"
>tlen_watch_fd()</A
></DT
></DL
></DD
><DT
>3.3. <A
HREF="#AEN278"
>expat.c</A
></DT
><DT
>3.4. <A
HREF="#AEN281"
>groupchat.c</A
></DT
><DD
><DL
><DT
>3.4.1. <A
HREF="#AEN284"
>tlen_groupchat_init()</A
></DT
><DT
>3.4.2. <A
HREF="#AEN292"
>tlen_get_second()</A
></DT
></DL
></DD
><DT
>3.5. <A
HREF="#AEN300"
>hashtable.c</A
></DT
><DT
>3.6. <A
HREF="#AEN303"
>hub.c</A
></DT
><DD
><DL
><DT
>3.6.1. <A
HREF="#AEN306"
>tlen_connect_server()</A
></DT
><DT
>3.6.2. <A
HREF="#AEN314"
>tlen_hub_query()</A
></DT
><DT
>3.6.3. <A
HREF="#AEN322"
>tlen_find_server()</A
></DT
><DT
>3.6.4. <A
HREF="#AEN330"
>tlen_connect_hub_process()</A
></DT
><DT
>3.6.5. <A
HREF="#AEN338"
>tlen_connect_hub()</A
></DT
></DL
></DD
><DT
>3.7. <A
HREF="#AEN346"
>libtlen.c</A
></DT
><DD
><DL
><DT
>3.7.1. <A
HREF="#AEN349"
>tlen_init()</A
></DT
><DT
>3.7.2. <A
HREF="#AEN357"
>tlen_set_hub_blocking()</A
></DT
><DT
>3.7.3. <A
HREF="#AEN365"
>tlen_set_auth()</A
></DT
><DT
>3.7.4. <A
HREF="#AEN373"
>tlen_set_proxy()</A
></DT
><DT
>3.7.5. <A
HREF="#AEN381"
>tlen_login()</A
></DT
><DT
>3.7.6. <A
HREF="#AEN389"
>tlen_freesession()</A
></DT
></DL
></DD
><DT
>3.8. <A
HREF="#AEN397"
>message.c</A
></DT
><DD
><DL
><DT
>3.8.1. <A
HREF="#AEN400"
>tlen_sendmsg()</A
></DT
></DL
></DD
><DT
>3.9. <A
HREF="#AEN408"
>pool.c</A
></DT
><DT
>3.10. <A
HREF="#AEN411"
>pubdir.c</A
></DT
><DD
><DL
><DT
>3.10.1. <A
HREF="#AEN414"
>tlen_search()</A
></DT
><DT
>3.10.2. <A
HREF="#AEN422"
>tlen_get_pubdir()</A
></DT
><DT
>3.10.3. <A
HREF="#AEN430"
>tlen_change_pubdir()</A
></DT
><DT
>3.10.4. <A
HREF="#AEN438"
>tlen_new_pubdir()</A
></DT
><DT
>3.10.5. <A
HREF="#AEN446"
>tlen_free_pubdir()</A
></DT
></DL
></DD
><DT
>3.11. <A
HREF="#AEN454"
>rate.c</A
></DT
><DT
>3.12. <A
HREF="#AEN457"
>roster.c</A
></DT
><DD
><DL
><DT
>3.12.1. <A
HREF="#AEN460"
>tlen_presence()</A
></DT
><DT
>3.12.2. <A
HREF="#AEN468"
>tlen_presence_disconnect()</A
></DT
><DT
>3.12.3. <A
HREF="#AEN476"
>tlen_getroster()</A
></DT
><DT
>3.12.4. <A
HREF="#AEN484"
>tlen_addcontact()</A
></DT
><DT
>3.12.5. <A
HREF="#AEN492"
>tlen_removecontact()</A
></DT
></DL
></DD
><DT
>3.13. <A
HREF="#AEN500"
>snprintf.c</A
></DT
><DT
>3.14. <A
HREF="#AEN503"
>sockets.c</A
></DT
><DD
><DL
><DT
>3.14.1. <A
HREF="#AEN506"
>tlen_socket_create()</A
></DT
><DT
>3.14.2. <A
HREF="#AEN514"
>tlen_socket_write()</A
></DT
><DT
>3.14.3. <A
HREF="#AEN522"
>tlen_socket_write_string()</A
></DT
><DT
>3.14.4. <A
HREF="#AEN530"
>tlen_socket_destroy()</A
></DT
></DL
></DD
><DT
>3.15. <A
HREF="#AEN538"
>str.c</A
></DT
><DT
>3.16. <A
HREF="#AEN541"
>testclient.c</A
></DT
><DT
>3.17. <A
HREF="#AEN544"
>utils.c</A
></DT
><DD
><DL
><DT
>3.17.1. <A
HREF="#AEN547"
>tlen_ping()</A
></DT
><DT
>3.17.2. <A
HREF="#AEN555"
>tlen_encode()</A
></DT
><DT
>3.17.3. <A
HREF="#AEN563"
>tlen_decode()</A
></DT
><DT
>3.17.4. <A
HREF="#AEN571"
>tlen_debug_raw()</A
></DT
><DT
>3.17.5. <A
HREF="#AEN579"
>tlen_stripresource()</A
></DT
><DT
>3.17.6. <A
HREF="#AEN587"
>tlen_base64_encode()</A
></DT
><DT
>3.17.7. <A
HREF="#AEN595"
>tlen_base64_decode()</A
></DT
></DL
></DD
><DT
>3.18. <A
HREF="#AEN603"
>xmlnode.c</A
></DT
><DT
>3.19. <A
HREF="#AEN606"
>xmlparse.c</A
></DT
><DT
>3.20. <A
HREF="#AEN609"
>xmlrole.c</A
></DT
><DT
>3.21. <A
HREF="#AEN612"
>xmltok.c</A
></DT
><DT
>3.22. <A
HREF="#AEN615"
>xmltok_impl.c</A
></DT
><DT
>3.23. <A
HREF="#AEN618"
>xmltok_ns.c</A
></DT
></DL
></DD
><DT
>4. <A
HREF="#AEN621"
>Omwienie programw przykadowych</A
></DT
><DD
><DL
><DT
>4.1. <A
HREF="#AEN624"
>examples/sendmsg.c</A
></DT
><DT
>4.2. <A
HREF="#AEN677"
>lib/testclient.c</A
></DT
></DL
></DD
></DL
></DIV
><DIV
CLASS="CHAPTER"
><HR><H1
><A
NAME="AEN18"
></A
>Rozdzia&#322; 1. API biblioteki.</H1
><DIV
CLASS="SECT1"
><H2
CLASS="SECT1"
><A
NAME="AEN20"
>1.1. Zaczynamy.</A
></H2
><P
>    Bibliotek libtlen mona wykorzysta w programach pisanych w C oraz C++.
    Naley tylko docza plik nagwkowy biblioteki jak na przykadzie poniej
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    #include &lt;libtlen/libtlen.h&gt;
    </PRE
></TD
></TR
></TABLE
><P
>    oraz linkowa z bibliotek tlen, np:
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    gcc -g -Wall -O2 -ltlen main.c -o main
    </PRE
></TD
></TR
></TABLE
><P
>    Wszystkie funkcje oraz nazwy struktur z biblioteki dostpne dla
    programisty maj przedrostek tlen_, natomiast stae zdefiniowane
    przedrostek TLEN_.
    Przed poczeniem z serwerem naley zadeklarowa wskanik na struktur
    tlen_session. W tej strukturze przechowywane s informacje o danej sesji.
    Jeli chcemy, aby biblioteka wypisywaa informacje o wykonywanych
    operacjach (np. czenie z serwerem, autoryzacja) uruchamiamy funkcj
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    tlen_setdebug(1);
    </PRE
></TD
></TR
></TABLE
><P
>    Teraz mona przej do logowania. Dostpne s dwie funkcje: tlen_login
    oraz tlen_login_nb. Obie wymagaj podania dwch parametrw, odpowiednio
    loginu i hasa w postaci 'const char *'. Rni si tym, e pierwsza
    z nich blokuje program zanim poczy si z serwerem, druga natomiast
    czy si z serwerem w oddzielnym procesie,  dziki czemu program nie jest
    blokowany i przechodzi do obsugi zdarze (o tym pniej). Obie funkcj
    zwracaj wskanik na struktur tlen_session, ktry naley zachowa
    (bdzie potrzebny we wszystkich dalej opisanych funkcjach), lub NULL jeli
    logowanie nie powiodo si. Po wywoaniu jednej z tych funkcji przechodzimy
    do obsugi zdarze.
    </P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN29"
>1.2. Zdarzenia.</A
></H2
><P
>    O wszystkich zdarzeniach (nowa wiadomo, zmiana statusu kogo z listy
    uytkownikw, itp) program jest powiadamiany za pomoc eventw, ktrych
    nazwy maj przedrostek TLEN_EVENT_. Poniej opisz poszczeglne eventy, a
    potem poka przykadow ptl obsugujc je.
    </P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN32"
>1.2.1. Zdarzenia obsugiwane jeden raz na pocztku sesji.</A
></H3
><P
>    Pierwszym zdarzeniem jest TLEN_EVENT_NOWGETID. Mwi nam ono o gotowoci
    serwera, teraz mona wysa danie o identyfikator sesji. Suy do tego
    funkcja tlen_getid, ktrej jako jedyny parametr przekazujemy wskanik
    do sesji. W rezultacie otrzymujemy event TLEN_EVENT_GOTID, a wic mamy ju
    id sesji, czas na autoryzacj. W tym celu wywoujemy funkcj tlen_authorize
    z tym samym parametrem co poprzednio. Jeli ta operacja si powiedzie
    program otrzyma zdarzenie TLEN_EVENT_AUTHORIZED, w ktrego obsudze mona
    wysa danie o ksik adresow, tlen_getroster (wywoanie rwnie z
    jednym parametrem). O niepowodzeniu autoryzacji jestemy informowani
    zdarzeniem TLEN_EVENT_UNAUTHORIZED, w tym przypadku naley zakoczy
    dziaanie programu lub sprbowa zalogowa sie ponownie. Zdarzenie
    TLEN_EVENT_GOTROSTERITEM to pojedynczy wpis w naszej ksice adresowej. Aby
    dosta si do tych informacji odwoujemy si do pola roster w strukturze
    tlen_event (o niej poniej w opisie ptli). Pole te jest struktur o nazwie
    tlen_user, zawiera nazw osoby (name), identyfikator (jid) w postaci
    login@tlen.pl, nazw grupy (group), rodzaj subskrypcji (subscription) oraz
    pole ask, ktre jeli zawiera napis "subscribe", to znaczy, e czekamy na
    pozwolenie o subskrypcj u danej osoby. W przeciwnym razie pole ask
    zawiera NULL. Jeli chcemy doda kogo do naszej listy, to musimy j
    poprosi o subskrypcj, inaczej dana osoba nie bdzie widoczna. Pole
    subscription natomiast okrela poziom subskrypcji, jeli zawiera napis
    "none"
    to oznacza brak subskrypcji u obu stron, "from" oznacza subskrypcj danej
    osoby w naszej ksice (np. gdy czekamy na pozwolenie na subskrypcj), "to"
    oznacza, e jestemy zapisani u danej osoby ale ta osoba nie jest zapisana
    u nas (np. gdy zrezygnowalimy z kontaktu). Najwyszy poziom subskrypcji to
    "both", oznacza, e obie strony s zapisane w ksice partnera. O kocu
    ksiki adresowej jestemy powiadamiani zdarzeniem TLEN_EVENT_ENDROSTER. Na
    tym koczy si obsuga tej czci zdarze, teraz wywoujemy funkcj
    tlen_presence jak na przykadzie:
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    tlen_presence(sesja,TLEN_STATUS_AVAILABLE,"Dostpny");
    </PRE
></TD
></TR
></TABLE
><P
>    gdzie pierwszy parametr jest wskanikiem na sesj, drugi oznacza status
    (w tym przypadku dostpny), w trzecim za podajemy wasny opis.
    </P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN37"
>1.2.2. Pozostae zdarzenia.</A
></H3
><P
>    Gdy kto dodaje nas do swojej listy kontaktw, jego program wysya do nas
    prob o subskrypcj, wtedy otrzymujemy event SUBSCRIBE (dokadnie
    TLEN_EVENT_SUBSCRIBE). Aby subskrypcja przebiega prawidowo, naley
    najpierw zaakceptowa nowy kontakt, nawet jeli chcemy odrzuci prob.
    Inaczej druga strona nie dowie si o naszej decyzji. Jeli dodatkowo nie
    mamy tej osoby na licie kontaktw, to naley j doda. Su do tego
    funkcje odpowiednio "tlen_accept_subscribe" oraz "tlen_addcontact". Teraz
    naley zapyta uytkownika czy chce subskrybowa dan osob. Jeli nie, to
    wywoujemy funkcje "tlen_removecontact" oraz "tlen_accept_unsubscribe".
    </P
><P
>    Event SUBSCRIBED powiadamia nas o tym, e otrzymalimy pozwolenie na
    subskrypcj u danej osoby. Teraz moemy odwiey list kontaktw.
    </P
><P
>    Event UNSUBSCRIBE otrzymujemy, gdy kto usunie nas ze swojej listy
    kontaktw. Nie mamy wyboru, musimy ten fakt zaakceptowa, wywoujc funkcj
    "tlen_accept_unsubscribe". Zmieniamy pole "subscribe" na "none", odwieamy
    list i damy tego samego, czyli "tlen_request_unsubscribe". W rezultacie
    powinnimy otrzyma event UNSUBSCRIBED.
    </P
><P
>    Przechodzimy do ciekawszych rzeczy, czyli wiadomoci. MESSAGE powiadamia nas
    o nowej wiadomoci, ktra moe by w postaci rozmowy (TLEN_CHAT) lub
    pojedynczej wiadomoci.
    </P
><P
>    Kiedy osoba zapisana na naszej licie zmienia swj status lub opis
    otrzymujemy event PRESENCE.
    </P
><P
>    Event NEWMAIL to powiadomienie o nowej poczcie na skrzynce tlen.pl
    </P
><P
>    Event GOTPUBDIRDATA informuje nas o nadejciu naszych danych z katalogu
    publicznego. Jest rezultatem wywoania funkcji "tlen_get_pubdir".
    </P
><P
>    Aby zmieni nasze dane publiczne wywoujemy funkcj "tlen_change_pubdir".
    Jeli ta operacja si powiedzie otrzymujemy event GOTPUBDIRUPDATEOK.
    </P
><P
>    Funkcja "tlen_search" suy do przeszukiwania katalogu publicznego. O
    znalezionych pozycjach informuje nas event GOTSEARCHITEM. Event ENDSEARCH
    oznacza koniec znalezionych rekordw.
    </P
><P
>    Kade zdarzenie uzupenia odpowiednio struktur tlen_event. Np. event
    MESSAGE musi gdzie zapisywa informacje od kogo jest wiadomo i jak ma
    tre. O tym mwi nastpna sekcja.
    </P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN49"
>1.2.3. Zawarto struktury tlen_event</A
></H3
><P
>    Poniewa mamy kilka rodzaji zdarze, struktura musi zawiera pole
    okrelajce typ, jest nim "type", ktre przyjmuje wartoci TLEN_EVENT_*
    (dokadny opis znajduje si w pliku nagwkowym biblioteki). Poza tym,
    znajdziemy wskaniki do struktur odpowiednich typw. Dla danego zdarzenia
    alokowana jest pamie dla struktury odpowiadajcej temu zdarzeniu, na ktr
    wskazuje odpowiedni wskanik. Dokladny opis tej struktury, jak i innych dla
    konkretnych zdarze, znajduje si w samym pliku nagwkowym.
    </P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN52"
>1.3. Poczmy si.</A
></H2
><P
>  Zamy, e mamy ju zadeklarowany w programie wskanik na struktur
  tlen_session, czyli "struct tlen_session *sesja". Aby pobra z kolejki
  zdarzenie potrzebujemy nastpujcych zmiennych:
  </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>  fd_set rd, wr;            // obserwowane deskryptory socketw
  struct tlen_event *event; // wskanik na zdarzenie
  struct timeval tv;        // czas blokowania programu przez select
  </PRE
></TD
></TR
></TABLE
><P
>  Inicjalizujemy te zmienne:
  </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>  tv.tv_sec = 0;
  tv.tv_usec = 1; // jeli brak danych to funkcja select nie blokuje programu
  FD_ZERO (&amp;rd);
  FD_ZERO (&amp;wr);
  if ((sesja-&#62;check &amp; TLEN_CHECK_READ)) // jeli czytamy dane
    FD_SET (sesja-&#62;fd, &amp;rd);
  if ((sesja-&#62;check &amp; TLEN_CHECK_WRITE)) // jeli wysyamy dane
    FD_SET (sesja-&#62;fd, &amp;wr);
  </PRE
></TD
></TR
></TABLE
><P
>  Sprawdzamy obecno danych:
  </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>  if (select (sesja-&#62;fd + 1, &amp;rd, &amp;wr, NULL, &amp;tv) == -1)
  {
    perror("select"); // bd z deskryptorem?
    exit(1); //wychodzimy z programu
  }
  </PRE
></TD
></TR
></TABLE
><P
>  Pobieramy zdarzenie:
  </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>  if (sesja &amp;&amp; (FD_ISSET (sesja-&#62;fd, &amp;rd) || FD_ISSET (sesja-&#62;fd,
  &amp;wr)))
  {
    tlen_watch_fd (sesja);
    while ((event=tlen_getevent(sesja))!=NULL)
    {
      switch (event-&#62;type)
      {
        case TLEN_EVENT_NOWGETID:
        //...
      }
      tlen_freeevent(event); //zwalniamy pami
    }
  </PRE
></TD
></TR
></TABLE
><P
>  Tu zaczyna si obsuga zdarze, o ktrej bya mowa wczeniej. Powyszy kod
  naley umiecic w funkcji, ktr wywoujemy np. co sekund. Ponadto aby serwer
  nie zerwa poczenia naley co jedn minut wywoywa funkcj
  "tlen_ping(sesja)". Podczas dziaania programu sprawdzamy pole "error" w
  strukturze tlen_session, jeli jest rne od zera, ponownie czymy si z
  serwerem.
  </P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN63"
>1.3.1. Funkcje.</A
></H3
><P
>    <UL
><LI
><P
>    tlen_addcontact - dodanie osoby do ksizki adresowej lub aktualizacja
    danych, oprcz loginu moemy poda nazw dla danej osoby i nazw grupy, do
    ktrej chcemy j zapisa.
    </P
></LI
><LI
><P
>    tlen_removecontact - usuwanie osoby z ksiki.
    </P
></LI
><LI
><P
>    tlen_request_subscribe - proba o autoryzacj u danej osoby.
    </P
></LI
><LI
><P
>    tlen_request_unsubscribe - proba o wypisanie si z ksiki danej osoby.
    </P
></LI
><LI
><P
>    tlen_accept_subscribe - autoryzowanie danej osoby w naszej ksice.
    </P
></LI
><LI
><P
>    tlen_accept_unsubscribe - zatwierdzenie wypisania z naszej ksiki danej
    osoby.
    </P
></LI
><LI
><P
>    tlen_presence - zmiana statusu, podajemy TLEN_STATUS_* oraz opis, jeli
    podamy TLEN_STATUS_UNAVAILABLE to zerwiemy poczenie z serwerem.
    </P
></LI
><LI
><P
>    tlen_sendmsg - wysanie komunikatu, musimy okreli typ (TLEN_CHAT dla
    rozmowy lub TLEN_MESSAGE dla wiadomoci).
    </P
></LI
><LI
><P
>    tlen_search - wyszukiwanie w katalogu publicznym.
    </P
></LI
><LI
><P
>    tlen_new_pubdir - inicjalizacja struktury tlen_pubdir.
    </P
></LI
><LI
><P
>    tlen_free_pubdir - zwolnienie pamici zajmowanem przez struktur
    tlen_pubdir.
    </P
></LI
><LI
><P
>    tlen_get_pubdir - pobranie z serwera naszych danych.
    </P
></LI
><LI
><P
>    tlen_change_pubdir - zmiana naszych danych w katalogu publicznym.
    </P
></LI
></UL
>
    </P
></DIV
></DIV
></DIV
><DIV
CLASS="CHAPTER"
><HR><H1
><A
NAME="AEN93"
></A
>Rozdzia&#322; 2. Specyfikacja katalogu publicznego</H1
><DIV
CLASS="SECT1"
><H2
CLASS="SECT1"
><A
NAME="AEN95"
>2.1. Tagi z parametrami katalogu publicznego</A
></H2
><P
>	Parametry wyszukiwania:
    </P
><UL
><LI
><P
>&lt;first&gt; imi &lt;/first&gt;</P
></LI
><LI
><P
>&lt;last&gt; nazwisko &lt;/last&gt;</P
></LI
><LI
><P
>&lt;nick&gt; nick &lt;/nick&gt;</P
></LI
><LI
><P
>&lt;email&gt; email &lt;/email&gt;</P
></LI
><LI
><P
>&lt;c&gt; miasto &lt;/c&gt;</P
></LI
><LI
><P
>&lt;s&gt; pe &lt;/s&gt; (TLEN_PUBDIR_GENDER_)</P
></LI
><LI
><P
>&lt;d&gt; minimalny wiek &lt;/d&gt;</P
></LI
><LI
><P
>&lt;u&gt; maksymalny wiek &lt;/u&gt;</P
></LI
><LI
><P
>&lt;r&gt; poszukuj &lt;/r&gt; (TLEN_PUBDIR_LOOK_)</P
></LI
><LI
><P
>&lt;g&gt; rozmowa gosowa &lt;/g&gt; (TLEN_PUBDIR_VOICE_)</P
></LI
><LI
><P
>&lt;j&gt; zawd &lt;/j&gt; (TLEN_PUBDIR_JOB_)</P
></LI
><LI
><P
>&lt;m&gt; stan &lt;/m&gt; (TLEN_STATUS_)</P
></LI
><LI
><P
>&lt;p&gt; plany &lt;/p&gt; (TLEN_PUBDIR_PLANS_)</P
></LI
><LI
><P
>&lt;e&gt; szkoa &lt;/e&gt;</P
></LI
><LI
><P
>&lt;i&gt; identyfikator &lt;/i&gt;</P
></LI
></UL
><P
>	Parametry naszych danych z katalogu publicznego s takie same jak wyszkiwaniu z rznicami:
    </P
><UL
><LI
><P
>&lt;v&gt; widoczno naszego stanu &lt;/v&gt;</P
></LI
><LI
><P
>&lt;d&gt;, &lt;u&gt; zastpione przez &lt;b&gt; - rok urodzenia</P
></LI
></UL
><P
>	W naszych danych nie ma pola &lt;i&gt; !
    </P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN136"
>2.2. Odczyt danych z katalogu publicznego</A
></H2
><P
>	Aby odczyta nasze dane z katalogu publicznego, wysyamy zapytanie:
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    &lt;iq type="get" id="tr" to="tuba"&gt;&lt;query xmlns="jabber:iq:register"&gt;&lt;/query&gt;&lt;/iq&gt;
    </PRE
></TD
></TR
></TABLE
><P
>	Serwer zwrci nam: 
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    &lt;iq type="result" id="tr" to="id@tlen.pl/t" from="tuba"&gt;&lt;query xmlns="jabber:iq:register"&gt;&lt;item&gt;parametry&lt;/item&gt;&lt;/query&gt;&lt;/iq&gt;
    </PRE
></TD
></TR
></TABLE
><P
>	<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>parametry</I
></SPAN
> to tagi, ktre musimy parsowa
    </P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN144"
>2.3. Zmiana naszych danych w katalogu publicznym</A
></H2
><P
>	Aby zmieni nasze dane w katalogu publicznym, wysyamy zapytanie:
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    &lt;iq type="set" id="tr" to="tuba"&gt;&lt;query xmlns="jabber:iq:register"&gt;parametry&lt;/query&gt;&lt;/iq&gt;
    </PRE
></TD
></TR
></TABLE
><P
>	gdzie <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>parametry</I
></SPAN
> to tagi (takie samej jak przy odbiorze danych).
	Jeeli wszystko poszo prawidowo i nasze dane zostay uaktualnione, serwer zwrci potwierdzenie w postaci
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    &lt;iq type="result" id="tw" to="id@tlen.pl/t" from="tuba"&gt;&lt;query xmlns="jabber:iq:register"&gt;&lt;/query&gt;&lt;/iq&gt;
    </PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN151"
>2.4. Wyszukiwanie</A
></H2
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
NAME="AEN153"
>2.4.1. Zapytanie</A
></H3
><P
>    Aby przeszuka katalog publiczny wysyamy do serwera zapytanie:
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    &lt;iq type="get" id="src" to="tuba"&gt;&lt;query xmlns="jabber:iq:search"&gt;tutaj to czego szukamy&lt;/query&gt;&lt;/iq&gt;
    </PRE
></TD
></TR
></TABLE
><P
>	<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>to czego szukamy</I
></SPAN
> to lista tagw z wybranymi przez nas waciwociami.
    </P
><P
>	Jeeli przy wyszukiwaniu nie szukamy wg. ktrego z tych parametrw, to po prostu
	nie umieszczamy go w zapytaniu. Wikszo parametrw liczbowych opisywana jest przez 
	#define'y TLEN_PUBDIR_, ktre uatwiaj nam rozumienie zapyta. Nie dotyczy to parametrw
	wieku - gdzie po prostu podajemy odpowiedni liczb. Po zoeniu zapytania wysyamy je do
	serwera po czym czekamy na odpowied z wynikami.
    </P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN160"
>2.4.2. Odpowied od serwera</A
></H3
><P
>	Po wysaniu zapytania serwer odpowie nam takim tagiem:
    </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    &lt;iq type="result" id="src" to="id/@tlen.pl/t" from="tuba" n="1"&gt;&lt;query xmlns="jabber:iq:search"&gt;
	&lt;item jid="jakistamid@tlen.pl"&gt;parametry&lt;/item&gt;
	&lt;item jid="jakistamid@tlen.pl"&gt;parametry&lt;/item&gt;	
    &lt;/query&gt;&lt;/iq&gt;
    </PRE
></TD
></TR
></TABLE
><P
>	Zwrcona parametry s takie same jak te, ktre wysyamy w zapytaniu z kilkoma wyjtkami:
    </P
><UL
><LI
><P
>Zamiast &lt;d&gt; i &lt;u&gt; zwracany jest tag &lt;b&gt; - wiek</P
></LI
><LI
><P
>Zamiast &lt;m&gt; stan zwracany jest w tagu &lt;a&gt;</P
></LI
><LI
><P
>Id uytkownika zwracany jest w gwnym tagu &lt;item&gt; w parametrze jid, zamiast w &lt;i&gt;</P
></LI
></UL
><P
>	Otrzymany wynik parsujemy. Kady tag &lt;item&gt; odpowiada jednemu uytkownikowi. Ze wzgldu na ograniczenia
	spamu serwer zwraca maksymalnie 20 wynikw. Jeeli nie ma w nich poszukwianej przez nas osoby, dokadniej sprecyzujmy
	parametry przeszukiwania.
    </P
></DIV
></DIV
></DIV
><DIV
CLASS="CHAPTER"
><HR><H1
><A
NAME="AEN173"
></A
>Rozdzia&#322; 3. Dokumentacja funkcji biblioteki</H1
><P
>Opis wszystkich funkcji biblioteki wraz z ich parametrami i dodatkowymi komentarzami.</P
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN176"
>3.1. auth.c</A
></H2
><P
>Opis funkcji zawartych w pliku auth.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN179"
>3.1.1. tlen_hash()</A
></H3
><P
>Generuje hash potrzebny do zalogowania si</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- pass - haso
- id - identyfikator sesji</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna na potrzeby tlen_authorize</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>char *tlen_hash (const char *pass, const char *id)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN187"
>3.1.2. tlen_getid()</A
></H3
><P
>Wysya prob o ID do serwera</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja</PRE
></TD
></TR
></TABLE
></P
><P
>Wywoywane zaraz po poczeniu</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_getid (struct tlen_session *sesja)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN195"
>3.1.3. tlen_authorize()</A
></H3
><P
>Wysya zapytanie logujce do serwera</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja</PRE
></TD
></TR
></TABLE
></P
><P
>Wywoywane po otrzymaniu ID</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_authorize (struct tlen_session *sesja)</I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN203"
>3.2. events.c</A
></H2
><P
>Opis funkcji zawartych w pliku events.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN206"
>3.2.1. tlen_starttag_handler()</A
></H3
><P
>Handler wykonywany przy rozpoczciu tagu</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- userData - dane parsera
- name - nazwa obsugiwanego tagu
- atts - parametry w tagu</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna parsera zdarze</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_starttag_handler(void *userData, const XML_Char *name, const XML_Char **atts)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN214"
>3.2.2. tlen_endtag_handler()</A
></H3
><P
>Handler wykonywany przy zakoczeniu tagu</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- userData - dane parsera
- name - nazwa obsugiwanego tagu</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna parsera zdarze</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_endtag_handler (void *userData, const XML_Char *name)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN222"
>3.2.3. tlen_char_handler()</A
></H3
><P
>Buforuje otrzymywany tekst w celu otrzymania kompletnego tagu</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- userData - dane parsera
- s - tekst dodawany do bufora
- len - dugo tekstu</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna parsera zdarze</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_char_handler (void *userData, const XML_Char *s, int len)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN230"
>3.2.4. tlen_parsebuffer()</A
></H3
><P
>Parsuje jeden kompletny tag XML otrzymany od serwera</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - sesja, w ktrej obsugujemy ewentualne zdarzenia</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna parsera zdarze</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_parsebuffer(struct tlen_session *sesja) {</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN238"
>3.2.5. tlen_addevent()</A
></H3
><P
>Dodaje zdarzenie do kolejki zdarze</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - sesja, do ktrej kolejki dodajemy
- e - zdarzenie</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna parsera zdarze</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_addevent(struct tlen_session *sesja, struct tlen_event *e)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN246"
>3.2.6. tlen_getevent()</A
></H3
><P
>Pobiera kolejne (jeeli istnieje) zdarzenie z kolejki</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - sesja, ktrej zdarzenia obsugujemy</PRE
></TD
></TR
></TABLE
></P
><P
>Zwraca zdarzenie, lub NULL jeeli nie ma wicej</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>struct tlen_event* tlen_getevent(struct tlen_session *sesja)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN254"
>3.2.7. tlen_newevent()</A
></H3
><P
>Tworzy nowe zdarzenie</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- type - typ zdarzenia</PRE
></TD
></TR
></TABLE
></P
><P
>Zwraca zaalokowan struktur zdarzenia</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>struct tlen_event* tlen_newevent(int type)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN262"
>3.2.8. tlen_freeevent()</A
></H3
><P
>Zwalnia pami po zdarzeniu</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- e - zdarzenie</PRE
></TD
></TR
></TABLE
></P
><P
>Wewntrzna funkcja parsowania zdarze</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_freeevent(struct tlen_event *e)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN270"
>3.2.9. tlen_watch_fd()</A
></H3
><P
>funkcja sprawdzajca socket w poszukiwaniu jakiego 
zdarzenia</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja</PRE
></TD
></TR
></TABLE
></P
><P
>Podczas bdw ustawia sesja-&#62;error i potrafi nawet rozczy gniazdo!</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_watch_fd (struct tlen_session *sesja)</I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN278"
>3.3. expat.c</A
></H2
><P
>Opis funkcji zawartych w pliku expat.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN281"
>3.4. groupchat.c</A
></H2
><P
>Opis funkcji zawartych w pliku groupchat.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN284"
>3.4.1. tlen_groupchat_init()</A
></H3
><P
>Inicjuje konferencj</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja
- to - uytkownik z ktrym chcemy konferowa</PRE
></TD
></TR
></TABLE
></P
><P
>Niezaimplementowana obsuga konferencji, funkcja testowa!</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_groupchat_init(struct tlen_session *sesja, char *to)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN292"
>3.4.2. tlen_get_second()</A
></H3
><P
>Zwraca sekund danego dnia</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- brak parametrw</PRE
></TD
></TR
></TABLE
></P
><P
>Potrzebna przy zapytaniach konferencyjnych</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_get_second()</I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN300"
>3.5. hashtable.c</A
></H2
><P
>Opis funkcji zawartych w pliku hashtable.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN303"
>3.6. hub.c</A
></H2
><P
>Opis funkcji zawartych w pliku hub.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN306"
>3.6.1. tlen_connect_server()</A
></H3
><P
>czy si z serwerem</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- host - adres
- port - port</PRE
></TD
></TR
></TABLE
></P
><P
>Wewntrzna funkcja dla resolvera huba</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_connect_server(const char* host, int port)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN314"
>3.6.2. tlen_hub_query()</A
></H3
><P
>Tworzy i wysya zapytanie do huba</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- user - nazwa uytkownika</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna resolvera huba</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>xmlnode tlen_hub_query (const char* user)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN322"
>3.6.3. tlen_find_server()</A
></H3
><P
>Znajduje adres i port serwera z ktrym mona si poczy</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- username - nazwa uytkownika
- port - port (wskanik!)</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna do resolvera huba</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>char* tlen_find_server (const char* username, int* port)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN330"
>3.6.4. tlen_connect_hub_process()</A
></H3
><P
>Tworzy i obsuguje proces czenia z hubem</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- user - nazwa uytkownika
- pipe - rrka</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna resolvera huba</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_connect_hub_process (const char* user, int pipe)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN338"
>3.6.5. tlen_connect_hub()</A
></H3
><P
>czy si z hubem</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sess - sesja
- blocking - blokowalne, lub nie</PRE
></TD
></TR
></TABLE
></P
><P
>jeli blocking=0 uruchamia proces czcy si w tle z hubem</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_connect_hub (struct tlen_session *sess, int blocking)</I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN346"
>3.7. libtlen.c</A
></H2
><P
>Opis funkcji zawartych w pliku libtlen.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN349"
>3.7.1. tlen_init()</A
></H3
><P
>Wywoywana na pocztku, w celu zainicjowania struktury sesji</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- brak parametrw</PRE
></TD
></TR
></TABLE
></P
><P
>Przed wykonaniem tej funkcji nie wolno nic robi z sesj!</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>struct tlen_session *tlen_init (void)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN357"
>3.7.2. tlen_set_hub_blocking()</A
></H3
><P
>Ustawia, czy proces resolvovania huba ma by synchroniczny,
czy asynchroniczny</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sess - sesja dla ktrej ustawiamy parametr
- blocking - 0 lub 1</PRE
></TD
></TR
></TABLE
></P
><P
>Nie ustawiamy tego rcznie, poprzez edycj struktury, a jedynie</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_set_hub_blocking(struct tlen_session *sess, int blocking)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN365"
>3.7.3. tlen_set_auth()</A
></H3
><P
>Ustawia nazw uytkownika i haso w sesji</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sess - sesja dla ktrej ustawiamy parametr
- username - nazwa uytkownika
- password - haso</PRE
></TD
></TR
></TABLE
></P
><P
>Nie ustawiamy tego rcznie, poprzez edycj struktury, a jedynie</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_set_auth(struct tlen_session *sess, char *username, char *password)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN373"
>3.7.4. tlen_set_proxy()</A
></H3
><P
>Ustawia adres i port serwera proxy dla transmisji</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sess - sesja dla ktrej ustawiamy parametr
- addr - adres serwera
- port - port</PRE
></TD
></TR
></TABLE
></P
><P
>NIEZAIMPLEMENTOWANE</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_set_proxy(struct tlen_session *sess, char *addr, int port)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN381"
>3.7.5. tlen_login()</A
></H3
><P
>Podstawowa funkcja rozpoczynajca poczenie z serwerem</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sess - sesja opisujca poczenie</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wypenia rne pola w sesji, jako jej parametr podajemy</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_login (struct tlen_session *sess)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN389"
>3.7.6. tlen_freesession()</A
></H3
><P
>Wywoywane w celu zwolnienia pamici po sesji</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sess - sesja, ktr zwalniamy</PRE
></TD
></TR
></TABLE
></P
><P
>Najpierw nalezy si rozczy z serwerem wysyajc status</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_freesession (struct tlen_session *sess)</I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN397"
>3.8. message.c</A
></H2
><P
>Opis funkcji zawartych w pliku message.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN400"
>3.8.1. tlen_sendmsg()</A
></H3
><P
>Wysya wiadomo</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja
- destination - osoba, do ktrej wysyamy wiadomo
- message - tre wiadomoci
- type - typ wiadomoci, TLEN_CHAT lub TLEN_MESSAGE</PRE
></TD
></TR
></TABLE
></P
><P
>Trzeba okreli w parametrze type rodzaj wysyanej wiadomoci </P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_sendmsg(struct tlen_session *sesja, const char *destination, const char *message, int type)</I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN408"
>3.9. pool.c</A
></H2
><P
>Opis funkcji zawartych w pliku pool.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN411"
>3.10. pubdir.c</A
></H2
><P
>Opis funkcji zawartych w pliku pubdir.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN414"
>3.10.1. tlen_search()</A
></H3
><P
>Inicjuje wyszukiwanie w katalogu publicznym</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja
- search - struktura opisujaca wyszukiwanie</PRE
></TD
></TR
></TABLE
></P
><P
>Uwagi do poniszego kodu:</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_search(struct tlen_session *sesja, struct tlen_pubdir *search)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN422"
>3.10.2. tlen_get_pubdir()</A
></H3
><P
>Wysya prob o nasze dane z katalogu publicznego</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja</PRE
></TD
></TR
></TABLE
></P
><P
>Wraca zaraz po wysaniu zapytania</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_get_pubdir (struct tlen_session *sesja)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN430"
>3.10.3. tlen_change_pubdir()</A
></H3
><P
>Wysya danie o zmian danych w katalogu publicznym</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja
- pubdir - struktura zawierajca nowe dane</PRE
></TD
></TR
></TABLE
></P
><P
>Wraca zaraz po wysaniu zapytania</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_change_pubdir(struct tlen_session *sesja, struct tlen_pubdir *pubdir)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN438"
>3.10.4. tlen_new_pubdir()</A
></H3
><P
>Inicjuje struktur zawierajc dane typu katalog publiczny
(wyszukiwanie, itp.)</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- brak parametrw</PRE
></TD
></TR
></TABLE
></P
><P
>Zwraca now struktur tlen_pubdir</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>struct tlen_pubdir *tlen_new_pubdir ()</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN446"
>3.10.5. tlen_free_pubdir()</A
></H3
><P
>Zwalnia pami po strukturze tlen_pubdir</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- pubdir - struktura, ktr chcemy zwolni</PRE
></TD
></TR
></TABLE
></P
><P
>Brak uwag dodatkowych</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_free_pubdir (struct tlen_pubdir *pubdir)</I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN454"
>3.11. rate.c</A
></H2
><P
>Opis funkcji zawartych w pliku rate.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN457"
>3.12. roster.c</A
></H2
><P
>Opis funkcji zawartych w pliku roster.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN460"
>3.12.1. tlen_presence()</A
></H3
><P
>Pozwala na ustawienie swojego stanu dostpnoci</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja
- status - stan w postaci TLEN_STATUS_*
- description - opcjonalny status opisowy, jeeli NULL to ""</PRE
></TD
></TR
></TABLE
></P
><P
>Brak uwag dodatkowych</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_presence (struct tlen_session *sesja, int status, const char *description)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN468"
>3.12.2. tlen_presence_disconnect()</A
></H3
><P
>Funkcja wewntrzna zamykajca poczenie z serwerem,
wywoywana przez wysanie statusu TLEN_STATUS_UNAVAILABLE</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja</PRE
></TD
></TR
></TABLE
></P
><P
>Nie uywa w swoich programach, od tego jest tlen_presence()</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_presence_disconnect (struct tlen_session *sesja)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN476"
>3.12.3. tlen_getroster()</A
></H3
><P
>Wysya prob o ksiak adresow</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja</PRE
></TD
></TR
></TABLE
></P
><P
>brak uwag</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_getroster (struct tlen_session *sesja)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN484"
>3.12.4. tlen_addcontact()</A
></H3
><P
>Dodaje uytkownika do ksiki adresowej</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja
- name - nazwa uytkownika 
- jid - identyfikator uytkownika w @tlen.pl
- group - grupa dla uytkownika</PRE
></TD
></TR
></TABLE
></P
><P
>Po dodaniu wypadaoby poprosi o subskrypcj przez</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_addcontact (struct tlen_session *sesja, const char *name,</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN492"
>3.12.5. tlen_removecontact()</A
></H3
><P
>Usuwa uytkownika z ksiki adresowej</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - nasza sesja
- jid - identyfikator w @tlen.pl</PRE
></TD
></TR
></TABLE
></P
><P
>Przed naley poprosi o desubskrypcj przez tlen_request_unsubscribe()</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_removecontact (struct tlen_session *sesja, const char *jid)</I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN500"
>3.13. snprintf.c</A
></H2
><P
>Opis funkcji zawartych w pliku snprintf.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN503"
>3.14. sockets.c</A
></H2
><P
>Opis funkcji zawartych w pliku sockets.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN506"
>3.14.1. tlen_socket_create()</A
></H3
><P
>tworzy socket i laczy sie z serwerem</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- address - adres IP serwera
- port - port na ktry si czymy</PRE
></TD
></TR
></TABLE
></P
><P
>zwraca gniazdo</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_socket_create (const char *address, int port)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN514"
>3.14.2. tlen_socket_write()</A
></H3
><P
>pisze do gniazda</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sess - sesja, w ktrej jest nasze gniazdo
- data - to co chcemy wysa
- len - dugo tego co chcemy wysa</PRE
></TD
></TR
></TABLE
></P
><P
>zwraca 0 w przypadku bdu lub 1 jak si powiedzie</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_socket_write (struct tlen_session *sess, const void *data, size_t len)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN522"
>3.14.3. tlen_socket_write_string()</A
></H3
><P
>Pisze tekst do gniazda</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sess - sesja z gniazdem
- string - tekst do wyslania</PRE
></TD
></TR
></TABLE
></P
><P
>Zwraca 0 w przypadku bledu, lub 1 jak operacja si powioda</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_socket_write_string (struct tlen_session *sess, const void *string)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN530"
>3.14.4. tlen_socket_destroy()</A
></H3
><P
>niszczy gniazdo</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sess - sesja w ktrej jest gniazdo</PRE
></TD
></TR
></TABLE
></P
><P
>Zwraca 1 jak si powiedzie, lub 0 w przypadku bdu</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_socket_destroy (struct tlen_session *sess)</I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN538"
>3.15. str.c</A
></H2
><P
>Opis funkcji zawartych w pliku str.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN541"
>3.16. testclient.c</A
></H2
><P
>Opis funkcji zawartych w pliku testclient.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN544"
>3.17. utils.c</A
></H2
><P
>Opis funkcji zawartych w pliku utils.c</P
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN547"
>3.17.1. tlen_ping()</A
></H3
><P
>Wysya pakiet kontrolny keep-alive do serwera</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- sesja - identyfikator sesji</PRE
></TD
></TR
></TABLE
></P
><P
>Ping powinien by wysyany co okoo 60 sekund</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_ping(struct tlen_session *sesja)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN555"
>3.17.2. tlen_encode()</A
></H3
><P
>Koduje tekst przy pomocy urlencode</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- what - tekst ktry chcemy zakodowa</PRE
></TD
></TR
></TABLE
></P
><P
>Dla zwracanego tekstu alokowana jest pami, trzeba go</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>char *tlen_encode (const char *what)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN563"
>3.17.3. tlen_decode()</A
></H3
><P
>Dekoduje tekst przy pomocy urldecode</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- what - tekst ktry chcemy rozkodowa</PRE
></TD
></TR
></TABLE
></P
><P
>Dla zwracanego tekstu alokowana jest pami, trzeba go</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>char *tlen_decode(const char *what)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN571"
>3.17.4. tlen_debug_raw()</A
></H3
><P
>Wywietla na stderr tekst pomocniczy przy debugowaniu</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- name - nazwa funkcji z ktrej debug zosta wywoany
- format - format tekstu do wywietlenia
- ... - wywietlany tekst(y)</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja wewntrzna, naley uywa wrappera tlen_debug(),</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>void tlen_debug_raw(const char *name, char *format, ...) {</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN579"
>3.17.5. tlen_stripresource()</A
></H3
><P
>Usuwa z podanego tekstu wszystko co po znaku /</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- jid - tekst z ktrego ma zosta usuniety "resource"</PRE
></TD
></TR
></TABLE
></P
><P
>Uywane dla identyfikatorw jabbera dla przychodzcych</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>int tlen_stripresource (char *jid)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN587"
>3.17.6. tlen_base64_encode()</A
></H3
><P
>Funkcja kodujca tekst przy uyciu base64</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- buf - tekst do zakodowania</PRE
></TD
></TR
></TABLE
></P
><P
>Warto zwracana jest alokowana, naley zwolni przez free()</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>char *tlen_base64_encode(const char *buf)</I
></SPAN
></P
></DIV
><DIV
CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
NAME="AEN595"
>3.17.7. tlen_base64_decode()</A
></H3
><P
>Funkcja dekodujca tekst przy uyciu base64</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>- buf - tekst do zdekodowania</PRE
></TD
></TR
></TABLE
></P
><P
>Warto zwracana jest alokowana, naley zwolni przez free()</P
><P
>Deklaracja: 
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>char *tlen_base64_decode(const char *buf)                                         </I
></SPAN
></P
></DIV
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN603"
>3.18. xmlnode.c</A
></H2
><P
>Opis funkcji zawartych w pliku xmlnode.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN606"
>3.19. xmlparse.c</A
></H2
><P
>Opis funkcji zawartych w pliku xmlparse.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN609"
>3.20. xmlrole.c</A
></H2
><P
>Opis funkcji zawartych w pliku xmlrole.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN612"
>3.21. xmltok.c</A
></H2
><P
>Opis funkcji zawartych w pliku xmltok.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN615"
>3.22. xmltok_impl.c</A
></H2
><P
>Opis funkcji zawartych w pliku xmltok_impl.c</P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN618"
>3.23. xmltok_ns.c</A
></H2
><P
>Opis funkcji zawartych w pliku xmltok_ns.c</P
></DIV
></DIV
><DIV
CLASS="CHAPTER"
><HR><H1
><A
NAME="AEN621"
></A
>Rozdzia&#322; 4. Omwienie programw przykadowych</H1
><P
>Automatycznie wygenerowane na podstawie kodu rdowego omwienie programw przykadowych libtlen</P
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN624"
>4.1. examples/sendmsg.c</A
></H2
><P
>Omwienie programu examples/sendmsg.c</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
></PRE
></TD
></TR
></TABLE
></P
><P
>Po wicej informacji zajyj do rozdziau o lib/testclient.c, gdy
podstawa dokumentacji na nim si opiera.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
> 
#include &lt;stdio.h&gt;
#include &lt;stdlib.h&gt;
#include &lt;unistd.h&gt;
#include &lt;string.h&gt;
#include &lt;sys/select.h&gt;
#include &lt;sys/time.h&gt;
#include &lt;sys/types.h&gt;
#include &lt;signal.h&gt;&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Inkludujemy nagwek libtlen&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;#include "libtlen.h"

int main (int argc, char **argv)
{</PRE
></TD
></TR
></TABLE
></P
><P
>Deklarujemy struktur sesji&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
> 
struct tlen_session *sesja;
struct tlen_event *event;
struct timeval tv;

tlen_setdebug(0);

if (argc==5) { </PRE
></TD
></TR
></TABLE
></P
><P
>Inicjujemy sesj&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    sesja = tlen_init();</PRE
></TD
></TR
></TABLE
></P
><P
>Ustawiamy uytkownika i haso z parametru programu&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    tlen_set_auth(sesja,argv[1],argv[2]);</PRE
></TD
></TR
></TABLE
></P
><P
>czenie z hubem ma przebiega jako nieblokowalne&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    tlen_set_hub_blocking(sesja,0);</PRE
></TD
></TR
></TABLE
></P
><P
>Okej, czymy&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>    tlen_login(sesja);
} else {
            printf("Usage: %s login password user message\n",argv[0]);
            return 1;
        }

// tutaj jest obserwowany socket
while ((!sesja-&gt;error))
{
fd_set rd, wr;
int retval;

tv.tv_sec = 60;
tv.tv_usec = 0;

FD_ZERO (&amp;rd);
FD_ZERO (&amp;wr);&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Ustawiamy opcje monitorowania deskryptorw&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;if ((sesja-&gt;check &amp; TLEN_CHECK_READ))
FD_SET (sesja-&gt;fd, &amp;rd);
if ((sesja-&gt;check &amp; TLEN_CHECK_WRITE))
FD_SET (sesja-&gt;fd, &amp;wr);

if ((retval = select (sesja-&gt;fd + 1, &amp;rd, &amp;wr, NULL, &amp;tv) == -1))
{
perror ("select");
}
else if (sesja &amp;&amp; (FD_ISSET (sesja-&gt;fd, &amp;rd) || FD_ISSET (sesja-&gt;fd, &amp;wr)))
{</PRE
></TD
></TR
></TABLE
></P
><P
>Sprawdzamy co si zmienio na gniedzie&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>tlen_watch_fd (sesja);</PRE
></TD
></TR
></TABLE
></P
><P
>Ptla obsugi zdarze&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>while ((event=tlen_getevent(sesja))!=NULL) {
switch (event-&gt;type)
{</PRE
></TD
></TR
></TABLE
></P
><P
>Poczony! Pobieramy id.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_NOWGETID:
{
tlen_getid(sesja);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Logujemy si&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_GOTID:
{
tlen_authorize(sesja);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Udao si - pobieramy ksik adresow&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_AUTHORIZED:
{
tlen_getroster(sesja);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Ups - co nie wyszo. Wychodzimy&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_UNAUTHORIZED:
{
exit(0);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Ksika adresowa si odebraa (nie obsugujemy poszczeglnych elementw, bo nie ma po co. 
Moemy wic wysa wiadomo (TLEN_MESSAGE, nie TLEN_CHAT), a nastpnie si rozczy&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_ENDROSTER:
{
tlen_sendmsg(sesja,argv[3],argv[4],TLEN_MESSAGE);
tlen_presence_disconnect (sesja);
tlen_freesession (sesja);
break;
}

}</PRE
></TD
></TR
></TABLE
></P
><P
>Zwalniamy zdarzenie&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>tlen_freeevent(event);
}
}
return 0;
}</PRE
></TD
></TR
></TABLE
></P
></DIV
><DIV
CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
NAME="AEN677"
>4.2. lib/testclient.c</A
></H2
><P
>Omwienie programu lib/testclient.c</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
></PRE
></TD
></TR
></TABLE
></P
><P
>Ostatnia aktualizacja:

- $Id: libtlen.html,v 1.25 2003/04/04 19:14:19 mati Exp $&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;#include &lt;stdio.h&gt;
#include &lt;stdlib.h&gt;
#include &lt;unistd.h&gt;
#include &lt;string.h&gt;
#include &lt;sys/select.h&gt;
#include &lt;sys/time.h&gt;
#include &lt;sys/types.h&gt;
#include &lt;signal.h&gt;&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Doczamy nagwek libtlen.h w ktrym zawarte s wszystkie 
informacje o zdarzeniach, funkcjach, strukturach itp. Bez
tego ani rusz!&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;#include "libtlen.h"&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Zmienna suca do zamknicia klienta - obsugiwana w handlerze
dla wcinicia CTRL+C&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;int terminate=0;&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Zmienna klienta informujca kiedy by ostatni ping do serwera - 
w tym przypadku potrzebna, eby pinga tylko co 60 sekund.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;int last_ping_time;&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Wewntrzny handler klienta ustawiajcy zmienn na 1 - wywoywany
podczas CTRL+C&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;void termhandler(int sig)
{
    terminate=1;
}&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Gowna funkcja programu - tutaj bdzie michanie z tlenem&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;int main (int argc, char **argv)
{&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Definiujemy struktur typu tlen_session opisujc wszystko
co z naszym tlenowym poczeniem zwizane. Przechowuje ona
gniazda, zdarzenia i inne potrzebne rzeczy&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;struct tlen_session *sesja;&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Struktura typu tlen_event suy do przechowywania informacji
o zdarzeniach - do niej bd pobierane zdarzenia w gwnej
ptli tlenowej.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;struct tlen_event *event;&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Struktura nie zwizana z libtlen - potrzebna przy takim a nie
innym rozwizaniu monitorowania gniazda - okrela timeout.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;struct timeval tv;&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>czymy SIGINT (Ctrl+C) z naszym handlerem (termhandler),
pozwoli to na poprawne zamknicie poczenia - tzn. jego
obsuenie, zamiast twardego wyjcia z programu&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;signal(SIGINT,termhandler);&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja biblioteki, pozwalajca na sterowanie informacjami
dodatkowymi (debug). Ustawiajc jej parametr 1 wczamy debugowanie,
od tej pory biblioteka bdzie wypluwaa na stderr wszystkie
informacje pomocnicze.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;tlen_setdebug(1);&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Sprawdzamy, czy liczba parametrw przekazanych do programu
jest rwna 2 - uytkownik i haso (+1, gdy pierwszym z nich
jest sama nazwa programu, ktrej my nie przekazujemy).&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;if (argc==3) { &#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Inicjujemy sesj przy uyciu funkcji tlen_init()&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;sesja = tlen_init();&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Przy uyciu funkcji tlen_set_auth() przekazujemy 
do biblioteki nazw uytkownika i haso&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;tlen_set_auth(sesja,argv[1],argv[2]);&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja tlen_set_hub_blocking() ustawia, czy proces
czenia z HUBem ma by synchroniczny, czy asynchroniczny
(blokowalny/nieblokowalny) - ustawiamy asynchroniczno.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;tlen_set_hub_blocking(sesja,0);&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>tlen_login() inicjuje poczenie z serwerem Tlenu. Najpierw
czy si z hubem, nastpnie pobiera adres serwera i si
z nim czy. Pobranie ID oraz autoryzacja nastpuj automagicznie.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;tlen_login(sesja);
} else {
printf("Usage: %s login password\n",argv[0]);
return 1;
        }&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Punkt kulminacyjny klienta - gwna ptla obsugi zdarze&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;while ((!terminate)&amp;&amp;(!sesja-&gt;error))
{</PRE
></TD
></TR
></TABLE
></P
><P
>zmienne potrzebne do poprawnego sterowania obserwacj gniazda&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;fd_set rd, wr;
int retval;&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Ustawiamy timeout dla serwera na 60 sekund&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;tv.tv_sec = 60;
tv.tv_usec = 0;&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Zerujemy deskryptory&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;FD_ZERO (&amp;rd);
FD_ZERO (&amp;wr);&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Wchodzi kawaek obsugi biblioteki - jeeli libtlen
prosi nas o monitorowanie kanau przychodzcego, to
ustawiamy RD, za jeeli kanau wychodzcego to WR.
Kana wychodzcy przede wszystkim sprawdza, czy gniazdo
nadaje si ju do zapisy, czyli czy jestemy ju
poczeni&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;if ((sesja-&gt;check &amp; TLEN_CHECK_READ))
FD_SET (sesja-&gt;fd, &amp;rd);
if ((sesja-&gt;check &amp; TLEN_CHECK_WRITE))
FD_SET (sesja-&gt;fd, &amp;wr);&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja select - systemowa, nie zwizana z bibliotek,
obserwuje deskryptor poczenia z serwerem - gniazdo znajduje
si w strukturze sesji - jako sesja-&gt;fd&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;if ((retval = select (sesja-&gt;fd + 1, &amp;rd, &amp;wr, NULL, &amp;tv) == -1))
{
perror ("select");
terminate = 1;
}&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Znaleziono co w gniedzie! Obsugujemy zdarzenia.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;else if (sesja &amp;&amp; (FD_ISSET (sesja-&gt;fd, &amp;rd) || FD_ISSET (sesja-&gt;fd, &amp;wr)))
{</PRE
></TD
></TR
></TABLE
></P
><P
>Funkcja biblioteki - tlen_watch_fd() - sprawdza, 
co si zmienio na gniedzie, odczytuje dane, a nastpnie
uzupenia zdarzenia, ktre dalej bdziemy obsugiwa.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;tlen_watch_fd (sesja);&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>W ptli pobieramy zdarzenia poprzez tlen_getevent
do struktury typu tlen_event (ktr zadeklarowalimy
na pocztku programu). Ptla obsugi zdarze wykonuje
si tak dugo, a wszystkie czekajce zdarzenia
zostan obsuone&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;while ((event=tlen_getevent(sesja))!=NULL) {&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Przecznikiem switch sprawdzamy typ zdarzenia&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>&#13;switch (event-&gt;type)
{</PRE
></TD
></TR
></TABLE
></P
><P
>Dostalimy informacj, e logowanie si powiodo, moemy wic
pobra z serwera ksik adresow - funkcja tlen_getroster()&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_AUTHORIZED:
{
tlen_getroster(sesja);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Po wywoaniu tlen_getroster bdziemy po kolei dostawa zdarzenia typu
TLEN_EVENT_GOTROSTERITEM informujce o pobraniu danych jednego uytkownika.
W tym programie wypisujemy je jedynie na ekran. Dane uytkownika zawarte
s w strukturze typu tlen_user. Przy kadym zdarzeniu, w ktrym otrzymujemy
jakie dane, do struktury tlen_event dodawana jest struktura danego
zdarzenia - w tym wypadku ksiki adresowej.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_GOTROSTERITEM:
{
printf("Got user: %s\n",event-&gt;roster-&gt;jid);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Otrzymalimy ca ksik adresow - informuje o tym zdarzenie ENDROSTER.
Skoro tak, to powinnismy wysa informacj o swojej dostpnoci. Suy
do tego funkcja tlen_presence pobierajca informacje o stanie - TLEN_STATUS_*
oraz nasz status opisowy - jeeli aden wstawiamy "" lub NULL.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_ENDROSTER:
{
printf("Roster received\n");
tlen_presence(sesja,TLEN_STATUS_AVAILABLE,"Dostpny");
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Jednym z najtrudniejszych elementw protokou tlenu/jabbera s
subskrybcje. Jest to system pozwalajcy na kontrol naszej znajomoci.
Generalnie - nikt nie bdzie widzia naszego stanu, jeeli nie
wyrazimy na to zgody, tak samo nikt nie doda nas do ksiki adresowej
jeeli nie wyrazimy na to zgody. Zdarzenie TLEN_EVENT_SUBSCRIBE
mwi nam, e kto prosi o zgod na autoryzacj. Identyfikator
danej osoby znajduje si w polu event-&gt;subscribe-&gt;jid. Jeeli
zgadzamy si - tutaj zawsze si zgadzamy, nie jest zaimplementowana
obsuga niezgadzania sie ;) - to akceptujemy prob funkcj
tlen_accept_subscribe, no i eby by fair prosimy uytkownika
o subskrybcj, eby te mie go w ksice - tlen_request_subscribe.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_SUBSCRIBE:
{
tlen_accept_subscribe(sesja,event-&gt;subscribe-&gt;jid);
tlen_request_subscribe(sesja,event-&gt;subscribe-&gt;jid);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>"Kto" zgodzi si abymy go dodali do swojej ksiki - a wic
to robimy, funkcja tlen_addcontact.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_SUBSCRIBED:
{
tlen_addcontact(sesja,"nazwa",event-&gt;subscribe-&gt;jid,"grupa");
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>BUU - kto chce nas usun ze swojej ksiki - wi prosi abymy
my rwnie go usuli - zgadzamy si na to poprzez tlen_accept_unsubscribe,
i eby dobi wszystkich formalnoci prosimy o to samo - tlen_request_unsubscribe.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_UNSUBSCRIBE:
{
tlen_accept_unsubscribe(sesja,event-&gt;subscribe-&gt;jid);
tlen_request_unsubscribe(sesja,event-&gt;subscribe-&gt;jid);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>"Kto" nas wanie pomylnie usun, wic my te usuwamy -
tlen_removecontact&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_UNSUBSCRIBED:
{
tlen_removecontact(sesja,event-&gt;subscribe-&gt;jid);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Oho - przysza wiadomo! Dane wiadomoci s w strukturze event-&gt;message,
podstawowymi s body - tre, oraz from - od kogo, a na szarym kocu
type - typ (TLEN_CHAT albo TLEN_MESSAGE). Nasz prosty klient obsuguje
wiadomoci w sposb bardzo prowizoryczny, np. zmienia stan, odpowiada pingiem,
i inne takie pierdoy. Generalnie nie pojawia si tu na razie nic wanego
- do czasu...&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_MESSAGE:
{
                                                if (strcmp(event-&gt;message-&gt;body,"exit")==0) 
{ 
    terminate=1;
    tlen_sendmsg(sesja,event-&gt;message-&gt;from,"exiting...",TLEN_CHAT);
}
if (strcmp(event-&gt;message-&gt;body,"available")==0) { tlen_presence(sesja,TLEN_STATUS_AVAILABLE,"available"); tlen_sendmsg(sesja,event-&gt;message-&gt;from,"status changed to available", TLEN_CHAT); }
if (strcmp(event-&gt;message-&gt;body,"away")==0) { tlen_presence(sesja,TLEN_STATUS_AWAY,"away"); tlen_sendmsg(sesja,event-&gt;message-&gt;from,"status changed to away", TLEN_CHAT); }
if (strcmp(event-&gt;message-&gt;body,"chatty")==0) { tlen_presence(sesja,TLEN_STATUS_CHATTY,"away"); tlen_sendmsg(sesja,event-&gt;message-&gt;from,"status changed to chatty", TLEN_CHAT); }
if (strcmp(event-&gt;message-&gt;body,"xa")==0) { tlen_presence(sesja,TLEN_STATUS_EXT_AWAY,"away"); tlen_sendmsg(sesja,event-&gt;message-&gt;from,"status changed to xa", TLEN_CHAT); }
if (strcmp(event-&gt;message-&gt;body,"dnd")==0) { tlen_presence(sesja,TLEN_STATUS_DND,"away"); tlen_sendmsg(sesja,event-&gt;message-&gt;from,"status changed to dnd", TLEN_CHAT); }
if (strcmp(event-&gt;message-&gt;body,"invisible")==0) { tlen_presence(sesja,TLEN_STATUS_INVISIBLE,"away"); tlen_sendmsg(sesja,event-&gt;message-&gt;from,"status changed to invisible", TLEN_CHAT); }
if (strcmp(event-&gt;message-&gt;body,"ping")==0) { tlen_sendmsg(sesja,event-&gt;message-&gt;from,"pong", TLEN_CHAT); }&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Jeeli wylemy klientowi wiadomo pubdir, wyle on prob o swoje
dane z katalogu publicznego - tlen_get_pubdir()&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>if (strcmp(event-&gt;message-&gt;body,"pubdir")==0) { tlen_get_pubdir(sesja); }
if (strcmp(event-&gt;message-&gt;body,"groupchat")==0) { tlen_groupchat_init(sesja,event-&gt;message-&gt;from); }&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Jeeli wylemy do testclienta wiadomo o treci search, klient
rozpocznie proces wyszukiwania w katalogu publicznym. W tym celu
inicjowana jest struktura tlen_pubdir, przy uyciu funkcji tlen_new_pubdir(),
a nastpnie wypeniane s jej pola. Tutaj akutat wykonujemy 
odpowiednik windowsowej "wizytwki" - tzn. wyszukujemy po identyfikatorze
tlenu. Gdy wylemy zamwienie poprzez tlen_search, zwalniamy struktur
funkcj tlen_free_pubdir().&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>if (strcmp(event-&gt;message-&gt;body,"search")==0)
{
    struct tlen_pubdir *sercz = tlen_new_pubdir();
    sercz-&gt;id = "matijozef"; // tutaj sobie wpiszcie jaki wam sie podoba
    tlen_search(sesja,sercz);
    tlen_free_pubdir(sercz);
}</PRE
></TD
></TR
></TABLE
></P
><P
>Analogicznie - tutaj obsugiwana jest proba o zmian naszych
danych w katalogu. Rwnie inicjujemy struktur tlen_pubdir,
uzupeniamy jej pola, a nastpnie funkcj tlen_change_pubdir
wysyamy do serwera nowe dane. Na koniec zwalniamy struktur
poprzez tlen_free_pubdir()&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>if (strcmp(event-&gt;message-&gt;body,"pubdir_change")==0)
{
    struct tlen_pubdir *pub = tlen_new_pubdir();
    pub-&gt;firstname = "matijozef"; // tutaj sobie wpiszcie jaki wam sie podoba
    pub-&gt;lastname = "krzysztoffelix"; 
    tlen_change_pubdir(sesja,pub);
    tlen_free_pubdir(pub);
}
    
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Kto zmieni stan - np. na niedostpny, zajty, lub zmieni stan opisowy
Aktualnie nie jest to u nas obsugiwane :) Dane oczywicie zawarte s
w event-&gt;presence.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_PRESENCE:
{

break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Zintegrowany system kont na o2.pl / tlen.pl jest poczony z serwerem tlenu.
Tak wic moemy otrzyma informacj o nowej poczcie - tutaj wanie tak si
dzieje. Informacje o tym s wysyane na ekran - dane za znajdziemy w polu
event-&gt;newmail&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_NEWMAIL:
{
printf("Masz now poczt od %s o temacie %s!\n",event-&gt;newmail-&gt;from, event-&gt;newmail-&gt;subject);
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Na razie jeszcze nie mamy w testcliencie obsugi wyszukiwania, wi program
poinformuje nas jedynie o tym, e wyszukiwanie skoczy. Obsuga jednak jest
analogiczna do ksiki adresowej - GOTSEARCHITEM a na kocu ENDSEARCH.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_ENDSEARCH:
{
printf("Wyszukiwanie zakoczone!\n");
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>Serwer tlenu pomylnie zwrci nam swoje dane, znajdziemy je w 
event-&gt;pubdir.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_PUBDIR_GOTDATA:
{
printf("Odebralem swoje dane!\n");
break;
}</PRE
></TD
></TR
></TABLE
></P
><P
>"Pusty" event. Dostajemy informacje o tym, e nasze dane si
adnie zmieniy.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>case TLEN_EVENT_PUBDIR_GOTUPDATEOK:
{
printf("Zmienilem swoje dane!\n");
break;
}

}
tlen_freeevent(event);
}&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Co 60 sekund musimy pinga, zapewnia nam to prosty trick z funkcj time.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>if (time(NULL)-last_ping_time&gt;60) { tlen_ping (sesja); last_ping_time = time(NULL); }
}&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>obsluga m.in bledu autoryzacji&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>        if(sesja-&gt;error)
        {
                printf("Error occured while talking to server!\n");
                exit(1);
        }</PRE
></TD
></TR
></TABLE
></P
><P
>Jeeli dostalimy CTRL+C to wychodzimy i zamykamy poczenie
z serwerem.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>if (terminate) printf("SIGINT received, exiting...\n");&#13;</PRE
></TD
></TR
></TABLE
></P
><P
>Wysyamy zamknicie poczenia poprzez stan TLEN_STATUS_UNAVAILABLE.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>tlen_presence(sesja, TLEN_STATUS_UNAVAILABLE, "");</PRE
></TD
></TR
></TABLE
></P
><P
>A na koniec zwalniamy pami po sesji.&#13;</P
><P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
>tlen_freesession (sesja);
return 0;
}</PRE
></TD
></TR
></TABLE
></P
></DIV
></DIV
></DIV
></BODY
></HTML
>