README(6).txt

(3 KB) Pobierz
==========================================================================
GG Spy - sniffer Gadu-Gadu
Program slu��cy do pods�uchiwania Gadu-Gadu
(C) Copyright 2002 GaduPO Team
==========================================================================

   [Polskie litery w iso-8859-2]

   Niniejszy program jest wolnym oprogramowaniem; mo�esz go
   rozprowadza� dalej i/lub modyfikowa� na warunkach GNU General
   Public License wydanej przez Free Software Foundation - wed�ug
   wersji 2-giej tej Licencji lub kt�rej� z p�niejszych wersji.

   Niniejszy program rozpowszechniany jest z nadziej�, i� b�dzie on
   u�yteczny - jednak BEZ JAKIEJKOLWIEK GWARANCJI, nawet domy�lnej
   gwarancji PRZYDATNO�CI HANDLOWEJ albo PRZYDATNO�CI DO OKRE�LONYCH
   ZASTOSOWA�. 

   Tre�� GNU General Public License znajdziesz w pliku COPYING.

   Do stworzenia tego programu u�y�em opisu protoko�u Gadu-Gadu
   stworzonego przez tw�rc�w Eksperymentalnego Klienta Gadu-Gadu,
   kt�ry mo�na znale�� na <http://dev.null.pl/ekg/>, oraz informacji
   uzyskanych przez badanie pakiet�w wysy�anych mi�dzy klientem a
   serwerem.

   This product includes software developed by the University of
   California, Berkeley and its contributors.

   This product includes software developed by the Politecnico
   di Torino, and its contributors.

   This product includes software developed by the Computer Systems
   Engineering Group at Lawrence Berkeley Laboratory.

   Gadu-gadu jest zastrze�onym znakiem towarowym sms-express sp. z o.o.

   Pods�uchiwanie cudzych rozm�w jest prawnie karalne (patrz np.:
   art. 267 Kodeksu Karnego).

===========================================================================

1. INSTALACJA
   
   a. u�yj skryptu 'configure' do okre�lenia interfejsu

   b. skompiluj (odpalaj�c 'make')

   Program wymaga biblioteki libpcap (chyba, �e kiedy� powstanie
   modu� umo�liwiaj�cy chwytanie pakiet�w za pomoc� innej
   biblioteki), ma ona odpowiednik Windows'owy, kt�ry nazywa si�
   WinPcap, i jest dost�pny z <http://winpcap.polito.it>.

   Co do Windows'�w to proponuj� kompilowa� pod �rodowiskiem Cygwin
   (kompilator GNU C + bash, etc.), bodaj�e <http://www.cygnus.com>
   
2. BUDOWA

   ui-*.c            modu�y interfejsu u�ytkownika

   cap-*.c           modu�y przechwytywania pakiet�w (obecnie tylko
                     cap-pcap.c)

   analyse.c         "spinacz" pomi�dzy parserem a
                     modu�em przechwytywania

   parse-handlers.c  zawiera funkcje obs�ugiwania poszczeg�lnych
                     typ�w pakiet�w GG

   parse.c           przetwarza pakiety GG

   utils.c           r�ne funkcje pomocnicze

   genver.c          programik modyfikuj�cy numer wersji

   Dzia�a to mniej wi�cej w ten spos�b (na przyk�adzie cap-pcap i
   ui-wingui):

   [WinPcap] -> [cap-pcap] -> [analyse] -> [parse] -> [ui-wingui]

3. INTERFEJSY U�YTK�WNIKA      

   Wszystkie interfejsy u�ytkownika pozwalaj� na odczyt bezpo�rednio
   z urz�dzenia lub z pliku zrzutu (dump file). (BTW: jak na razie
   pliki zrzutu s� tworzone zawsze).

   Za wz�r tworzenia nowego UI powinien s�u�y� ui-console.c.

   a. ui-console.c

   UI czysto tekstowy, wszystkie informacje drukuje bezpo�rednio na
   standardowe wyj�cie. W�a�ciwie nie ma co w nim zrobi� wi�cej.

   b. ui-wingui.c

   UI okienkowy, dzia�a tylko w Windowsach.
   
   Z racji tego, �e GG u�ywam wy��cznie w Windowsach, to tylko ten
   interfejs b�dzie jako� rozwijany.

   Przeczytaj README-WinGUI.

4. MODU�Y PRZECHWYTYWANIA PAKIET�W

   a. cap-pcap.c

   Modu� przechwytywania opakowywuj�cy bibliotek� libpcap.
   Robi�c jaki� inny wypada�oby, �eby zachowa� format plik�w zrzutu
   z libpcap'a, �eby by�a zgodno�� formatu mi�dzy wszystkimi
   wersjami.

   FYI: Informacje dostarczane przez libpcap r�ni� si� nieco
   mi�dzy systemami...

5. AUTORZY

   ok0n <ok0n@poczta.fm>

   i inni pozostaj�cy w ukryciu...

6. PODZI�KOWANIA

   EKG Team <http://dev.null.pl/ekg/>
Zgłoś jeśli naruszono regulamin