Added Polish man pages
diff --git a/doc/sgsnemu.8.pl b/doc/sgsnemu.8.pl
new file mode 100644
index 0000000..cbdea48
--- /dev/null
+++ b/doc/sgsnemu.8.pl
@@ -0,0 +1,407 @@
+
+.\" * OpenGGSN - Gateway GPRS Support Node
+.\" * Copyright (C) 2002, 2003 Mondru AB.
+.\" * Polish translation copyright (C) 2004 Marek ¯akowicz <mazaczek@users.sourceforge.net>
+.\" *
+.\" * The contents of this file may be used under the terms of the GNU
+.\" * General Public License Version 2, provided that the above copyright
+.\" * notice and this permission notice is included in all copies or
+.\" * substantial portions of the software.
+.\" *
+.\" * The initial developer of the original code is
+.\" * Jens Jakobsen <jj@openggsn.org>
+.\" *
+.\" * Contributor(s):
+.\" *
+.\" * Translation to polish: Marek Zakowicz <mazak@debian.linux.org.pl>
+.\" Manual page for ggsn
+.\" SH section heading
+.\" SS subsection heading
+.\" LP paragraph
+.\" IP indented paragraph
+.\" TP hanging label
+
+.TH sgsnemu 8 "Maj 2004"
+.SH NAZWA
+sgsnemu \- Emulator Wêz³a Dostarczaj±cego Us³ug GPRS
+.SH U¯YTKOWANIE
+.B sgsnemu
+\-\-help
+
+.B sgsnemu
+\-\-version
+
+.B sgsnemu
+[
+.BI \-\-debug
+] [
+.BI \-\-conf " plik"
+] [
+.BI \-\-pidfile " plik"
+] [
+.BI \-\-statedir " plik"
+] [
+.BI \-\-dns " host"
+] [
+.BI \-\-listen " host"
+] [
+.BI \-\-remote " host"
+] [
+.BI \-\-contexts " liczba"
+] [
+.BI \-\-timelimit " sekundy"
+] [
+.BI \-\-gtpversion " wersja"
+] [
+.BI \-\-apn " apn"
+] [
+.BI \-\-selmode " tryb"
+] [
+.BI \-\-imsi " imsi"
+] [
+.BI \-\-nsapi " nsapi"
+] [
+.BI \-\-msisdn " msisdn"
+] [
+.BI \-\-qos " qos"
+] [
+.BI \-\-charging " op³ata"
+] [
+.BI \-\-uid " uid"
+] [
+.BI \-\-pwd " pwd"
+] [
+.BI \-\-createif
+] [
+.BI \-\-net " sieæ"
+] [
+.BI \-\-defaultroute
+] [
+.BI \-\-ipup " skrypt"
+] [
+.BI \-\-ipdown " skrypt"
+] [
+.BI \-\-pinghost " host"
+] [
+.BI \-\-pingrate " liczba"
+] [
+.BI \-\-pingsize " liczba"
+] [
+.BI \-\-pingcount " liczba"
+]
+.SH OPIS
+.B sgsnemu
+jest czê¶ci± projektu
+.B OpenGGSN
+i implementuje emulator wêz³a dostarczaj±cego us³ug GPRS (SGSN).
+Mo¿e on byæ wykorzystywany zarówno do testowania wêz³ów GGSN,
+jak rdzenia sieci GRPS, czy po³±czeñ odwiedzaj±cych.
+
+Funkcjonalno¶æ i protoko³y GPRS zosta³y ustandaryzowane w ramach projektu
+Third Generation Partnership Project (3GPP).
+Wed³ug specyfikacji 3GPP, SGSN posiada kilka interfejsów.
+.B sgsnemu
+implementuje interfejs Gn/Gp, który jest wykorzystywany w kierunku
+wêz³ów GGSN.
+
+Interfejs Gn/Gp mo¿e byæ postrzegany jako ³±cze nadrzêdne wêz³a SGSN.
+Jest ono wykorzystywane do komunikacji z wêz³em GGSN, który zazwyczaj jest
+pod³±czony do Internetu.
+Interfejs Gn/Gp wykorzystuje protokó³ tunelowania GPRS (GTP).
+Pakiety u¿ytkownika (zazwyczaj pakiety IP) s± tunelowane za po¶rednictwem protoko³u GTP,
+który z kolei wykorzystuje protokó³ UDP nad IP.
+
+
+.B sgsnemu
+ustanawia pewn± liczbê po³±czeñ do GGSN.
+Wewnêtrzny ping transmituje ¿±dania ICMP poprzez ju¿ ustanowione po³±czenia.
+Alternatywnie, mo¿e byæ utworzony lokalny interfejs sieciowy.
+W tym przypadku
+.B sgsnemu
+przekazuje pakiety pomiêdzy lokalnym interfejsem sieciowym i po³±czeniami
+ustanowionymi na interfejsie Gn/Gp.
+
+.B sgsnemu
+wykorzystuje sterownik
+.B TUN/TAP
+jako interfejs lokalny. Interfejs sieci tun jest ustanawiany dla ka¿dego
+po³±czenia zestawianego z wêz³em GGSN.
+B³êdy wystêpuj±ce podczas pracy programu s± raportowane z wykorzystaniem
+.B syslogd (8).
+
+.SH OPCJE
+.TP
+.BI --help
+Wy¶wietla pomoc i na tym koñczy wykonanie programu.
+
+.TP
+.BI --version
+Wy¶wietla pomoc i na tym koñczy wykonanie programu.
+
+.TP
+.BI --debug
+Uruchamia w trybie usuwania b³êdów (domy¶lnie wy³±czone).
+
+.TP
+.BI --conf " plik"
+Odczytuje konfiguracjê z
+.I pliku
+,którego ka¿da linia odpowiada jednej opcji
+linii poleceñ pozbawionej przedrostka '--'. Opcje podane w linii poleceñ
+nadpisuj± opcje podane w pliku konfiguracyjnym.
+
+.TP
+.BI --pidfile " plik"
+Nazwa
+.I pliku
+z identyfikatorem procesu (domy¶lnie ./sgsnemu.pid)
+
+.TP
+.BI --statedir " ¶cie¿ka"
+.I ¦cie¿ka
+do katalogu z trwa³ymi (nie ulotnymi) danymi (domy¶lnie ./)
+
+.TP
+.BI --dns " host"
+Serwer DNS wykorzystywany do zapytañ APN.
+Je¶li parametr zosta³ pominiêty, wykorzystywana jest domy¶lna, systemowa konfiguracja DNS.
+
+.TP
+.BI --listen " host"
+Lokalny adres IP, który zostanie u¿yty do nas³uchu przez interfejs Gn/Gp.
+Ta opcja musi zostaæ podana.
+Z przyczyn bezpieczeñstwa nie mo¿e byæ wykorzystany INADDR_ANY.
+
+.TP
+.BI --remote " host"
+.I Host
+z wêz³em GGSN wykorzystywanym do po³±czeñ. Je¶li DNS jest prawid³owo skonfigurowany
+to powinno byæ mo¿liwe podanie nazwy punktu dostêpowego (APN) jako nazwy zdalnego hosta.
+
+.TP
+.BI --contexts " liczba"
+Liczba ustanawianych kontekstów (domy¶lnie = 1). W przypadku wielu kontekstów
+pierwszy kontekst jest ustanawiany z wykorzystaniem imsi + 0 i msidn + 0.
+Drugi kontekst jest ustanawiany z wykorzystaniem imsi + 1 i msidn +1.
+Trzeci ...
+
+.TP
+.BI --timelimit " sekundy"
+Koñczy wykonanie
+.b sgsnemu
+po up³ywie podanej liczy \fIsekund\fP.
+W przypadku wykorzystywania opcji ping mo¿na zakoñczyæ
+.B sgsnemu
+po wy³aniu
+.B --pingcount
+pakietów.
+
+.TP
+.BI --gtpversion " wersja"
+.I wersja
+protoko³u GTP wykorzystywana przy ustanawianiu kontekstów (domy¶lnie = 1).
+Je¶li nie jest mo¿liwe ustanowienie kontekstu GTPw1
+.B sgsnemu
+powtórzy ¿±danie wykorzystuj±c GTPw0.
+
+.TP
+.BI --apn " apn"
+.I apn
+wykorzystywany przy ³±czeniu siê z wêz³em GGSN (domy¶lnie = internet).
+APN jest akronimem angielskich s³ów Access Point Name.
+
+.TP
+.BI --selmode " tryb"
+Tryb wyboru wykorzystywany w komunikacji z wêz³em GGSN (domy¶lnie = 0x01).
+Jako tryby wyboru mog± byæ wykorzystane nastêpuj±ce kody:
+0: MS lub sieæ dostarczana przez APN, subskrypcja zweryfikowana,
+1: MS dostarczany przez APN, subskrypcja nie zweryfikowana,
+2: sieæ dostarczana przez APN, subskrypcja nie zweryfikowana.
+
+.TP
+.BI --imsi " imsi"
+.I imsi
+wykorzystywane w komunikacji z wêz³em GGSN (domy¶lnie = 240010123456789).
+IMSI jest akronimem angielskich s³ów International Mobile Subscriber Identity.
+IMSI musi sk³adaæ siê z dok³adnie 15 cyfr. Porównaj z opcj±
+.I contexts
+by zobaczyæ wykorzystanie
+.I imsi
+w przypadku wielu kontekstów.
+
+.TP
+.BI --nsapi " nsapi"
+.I nsapi
+wykorzystywane w komunikacji z wêz³em GGSN (domy¶lnie = 0).
+Warto¶æ musi byæ pomiêdzy 0, a 15.
+
+.TP
+.BI --msisdn " msisdn"
+.I msisdn
+wykorzystywane w komunikacji z wêz³em GGSN (domy¶lnie = 46702123456).
+MSISDN jest akronimem angielskich s³ów International Mobile Integrated Services Digital Network.
+W istocie jest numerem telefonu zapisanym w miêdzynarodowym formacie bez wiod±cych 00 lub 011.
+Porównaj z opcj±
+.I contexts
+by zobaczyæ wykorzystanie
+.I msisdn
+w przypadku wielu kontekstów.
+
+.TP
+.BI --qos " qos"
+.I qos
+wykorzystywany w komunikacji z wêz³em GGSN (domy¶lnie = 0x0b921f).
+QoS jest akronimem angielskich s³ów Quality of Service.
+Format tego parametru zosta³ okre¶lony na podstawie specyfikacji 3GPP 09.60.
+
+.TP
+.BI --charging " op³ata"
+Charakterystyka rozliczania wykorzystywana w komunikacji z wêz³em GGSN
+(domy¶lnie = 0x0800). 0x0800 = normalna, 0x0400 = przedp³ata,
+0x0200 = p³aska rata, 0x0100 = rozliczanie dynamiczne.
+Format pola zosta³ opisany w specyfikacji 3GPP 32.015.
+
+.TP
+.BI --uid " uid"
+Identyfikator u¿ytkownika wysy³any do GGSN jako opcja konfiguracyjna protoko³u.
+
+.TP
+.BI --pwd " has³o"
+Identyfikator wysy³ane do GGSN jako opcja konfiguracyjna protoko³u.
+
+.TP
+.BI --createif
+Tworzy lokalny interfejs tun, wykorzystywany dla
+przesy³ania pakietów do i z interfejsu Gn/Gp.
+Nale¿y zaznaczyæ, ¿e interfejs Gn/Gp zazwyczaj jest kierowany
+do Internetu przez GGSN. Tylko jeden interfejs mo¿e byæ utworzony, chocia¿
+wiele kontekstów mo¿e zostaæ ustanowionych.
+Interfejs mo¿e byæ podany dla ka¿dego kontekstu jako adres IP, lub mo¿e byæ
+okre¶lony za pomoc± opcji
+.I net.
+
+.TP
+.BI --net " sieæ"
+Adres sieci lokalnego interfejsu.
+Opcja
+.I net
+jest poprawna tylko wtedy, gdy zosta³a wykorzystana opcja
+.I createif.
+Warto¶æ parametru
+.I net
+jest podawana w formacie cidr (sieæ/maska). Je¶li opcja
+.I net
+zostanie pominiêta, adres IP jest rezerwowany dla ka¿dego ustanawianego kontekstu.
+
+.TP
+.BI --defaultroute
+Definiuje domy¶lne trasowanie przez lokalny interfejs tun.
+
+.TP
+.BI --ipup " skrypt"
+Skrypt wykonywany po aktywacji interfejsu Gi w sieci tun.
+Skrypt jest uruchamiany z nastêpuj±cymi parametrami <nazwa urz±dzenia> <adres ip>.
+
+.TP
+.BI --ipdown " skrypt"
+Skrypt wykonywany po wy³±czeniu interfejsu Gi w sieci tun.
+Skrypt jest uruchamiany z nastêpuj±cymi parametrami <nazwa urz±dzenia> <adres ip>.
+
+.TP
+.BI --pinghost " host"
+Powoduje wysy³anie pakietów ICMP do urz±dzenia
+.I host
+poprzez interfejs Gn/Gp. Statystyki po³±czeñ s± raportowane w formie
+bardzo zbli¿onej do wyj¶cia oryginalnego programu ping. Mo¿esz wykorzystaæ
+to udogodnienie do testowania wydajno¶ci GGSN.
+
+.TP
+.BI --pingrate " liczba"
+Ilo¶æ ¿±dañ ICMP generowanych w przeci±gu sekundy (domy¶lnie = 1).
+
+.TP
+.BI --pingsize " liczba"
+Rozmiar generowanych ¿±dañ ICMP wyra¿ony w oktetach (domy¶lnie = 56).
+
+
+.TP
+.BI --pingcount " liczba"
+Oczekiwana ilo¶æ wygenerowanych ¿±dañ ICMP (domy¶lnie = 0).
+Warto¶æ 0 (zero) oznacza wielko¶æ nieograniczon±.
+
+.TP
+.BI --pingquiet
+Wy³±cza wypisywanie informacji o otrzymanych pakietach (domy¶lnie pakiety s± wypisywane).
+Jest to ca³kiem przydatne dla du¿ych ilo¶ci pakietów ICMP generowanych w przeci±gu sekundy
+(porównaj z opcj± pingrate).
+
+.SH PLIKI
+.I sgsnemu.conf
+.RS
+Plik konfiguracyjny dla
+.B sgsnemu.
+.RE
+.I .sgsnemu.pid
+.RS
+Plik zawieraj±cy identyfikator procesu.
+.RE
+.I ./
+.RS
+Katalog przechowuj±cy trwa³e (nie ulotne) dane.
+.RE
+
+.SH B£ÊDY
+Zg³aszaj b³êdy na listê ¶ledzenia b³êdów OpenGGSN
+.I http://sourceforge.net/projects/sgsnemu/
+
+
+.SH "ZOBACZ TAK¯E"
+.BR ggsn (8),
+.BR syslog (8)
+
+.SH UWAGI
+.LP
+
+Oprócz d³ugich, udokumentowanych w tym podrêczniku, opcji
+.B sgsnemu
+wspiera równie¿ pewn± liczb± krótkich opcji o tej samej funkcjonalno¶ci.
+Wywo³aj
+.B sgsnemu --help
+by uzyskaæ pe³n± listê dostêpnych opcji.
+
+Sterownik TUN/TAP jest wymagany dla poprawnego dzia³ania
+.B sgsnemu.
+Dla j±der linuksa pó¼niejszych ni¿ 2.4.7 sterownik TUN/TAP jest zawarty w j±drze,
+chocia¿ w typowej sytuacji musi byæ ³adowany oddzielnie za pomoc±
+.B modprobe tun.
+Aby ³adowaæ automatycznie nale¿y do pliku
+.B /etc/modules.conf.
+dodaæ liniê
+.B alias char-major-10-200 tun
+Aby uzyskaæ informacje o innych platformach zobacz stronê
+.I http://vtun.sourceforge.net/tun/
+opisuj±c± jak zainstalowaæ i skonfigurowaæ sterownik tun.
+
+.B ggsn
+wykorzystuje protokó³ tunelowania GPRS (GTP) wyspecyfikowany przez
+Third Generation Partnership Project (3GPP). Specyfikacje protoko³ów 3GPP
+mog± byæ znalezione na
+.I http://www.3gpp.org
+
+.SH COPYRIGHT
+
+Copyright (C) 2002, 2003, 2004 by Mondru AB.
+
+Zawarto¶æ tego pliku mo¿e byæ wykorzystywana stosownie do terminów
+Ogólnej, Publicznej Licencji (GPL) GNU w wersji 2 dostarczonej wraz
+z niniejsz± uwag± o prawach autorskich zawart± we wszystkich kopiach
+i istotnych fragmentach oprogramowania.
+
+.SH AUTORZY
+Jens Jakobsen <jj@openggsn.org>
+
+.SH T£UMACZENIE
+Polish translation copyright (C) 2004 Marek ¯akowicz <mazaczek@users.sourceforge.net>
+
+T³umaczenie jest chronione prawami autorskimi.
+Dozwolone jest korzystanie, rozprowadzanie i modyfikacja na zasadach licencji GNU GPL 2.