openggsn/doc/sgsnemu.8.pl

.\" * OpenGGSN - Gateway GPRS Support Node
.\" * Copyright (C) 2002, 2003 Mondru AB.
.\" * Polish translation copyright (C) 2004 Marek <EFBFBD>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<EFBFBD>z<EFBFBD>a Dostarczaj<EFBFBD>cego Us<EFBFBD>ug GPRS
.SH U<EFBFBD>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<6F>ata"
] [
.BI \-\-uid " uid"
] [
.BI \-\-pwd " pwd"
] [
.BI \-\-createif
] [
.BI \-\-net " sie<69>" 
] [
.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<EFBFBD><EFBFBD>ci<EFBFBD> projektu
.B OpenGGSN
i implementuje emulator w<EFBFBD>z<EFBFBD>a dostarczaj<EFBFBD>cego us<EFBFBD>ug GPRS (SGSN).
Mo<EFBFBD>e on by<EFBFBD> wykorzystywany zar<EFBFBD>wno do testowania w<EFBFBD>z<EFBFBD><EFBFBD>w GGSN,
jak rdzenia sieci GRPS, czy po<EFBFBD><EFBFBD>cze<EFBFBD> odwiedzaj<EFBFBD>cych. 

Funkcjonalno<EFBFBD><EFBFBD> i protoko<EFBFBD>y GPRS zosta<EFBFBD>y ustandaryzowane w ramach projektu 
Third Generation Partnership Project (3GPP).
Wed<EFBFBD>ug specyfikacji 3GPP, SGSN posiada kilka interfejs<EFBFBD>w.
.B sgsnemu
implementuje interfejs Gn/Gp, kt<EFBFBD>ry jest wykorzystywany w kierunku
w<EFBFBD>z<EFBFBD><EFBFBD>w GGSN.

Interfejs Gn/Gp mo<EFBFBD>e by<EFBFBD> postrzegany jako <EFBFBD><EFBFBD>cze nadrz<EFBFBD>dne w<EFBFBD>z<EFBFBD>a SGSN.
Jest ono wykorzystywane do komunikacji z w<EFBFBD>z<EFBFBD>em GGSN, kt<EFBFBD>ry zazwyczaj jest
pod<EFBFBD><EFBFBD>czony do Internetu.
Interfejs Gn/Gp wykorzystuje protok<EFBFBD><EFBFBD> tunelowania GPRS (GTP).
Pakiety u<EFBFBD>ytkownika (zazwyczaj pakiety IP) s<EFBFBD> tunelowane za po<EFBFBD>rednictwem protoko<EFBFBD>u GTP,
kt<EFBFBD>ry z kolei wykorzystuje protok<EFBFBD><EFBFBD> UDP nad IP.


.B sgsnemu 
ustanawia pewn<EFBFBD> liczb<EFBFBD> po<EFBFBD><EFBFBD>cze<EFBFBD> do GGSN.
Wewn<EFBFBD>trzny ping transmituje <EFBFBD><EFBFBD>dania ICMP poprzez ju<EFBFBD> ustanowione po<EFBFBD><EFBFBD>czenia.
Alternatywnie, mo<EFBFBD>e by<EFBFBD> utworzony lokalny interfejs sieciowy.
W tym przypadku
.B sgsnemu
przekazuje pakiety pomi<EFBFBD>dzy lokalnym interfejsem sieciowym i po<EFBFBD><EFBFBD>czeniami
ustanowionymi na interfejsie Gn/Gp.

.B sgsnemu
wykorzystuje sterownik
.B TUN/TAP
jako interfejs lokalny.  Interfejs sieci tun jest ustanawiany dla ka<EFBFBD>dego
po<EFBFBD><EFBFBD>czenia zestawianego z w<EFBFBD>z<EFBFBD>em GGSN.
B<EFBFBD><EFBFBD>dy wyst<EFBFBD>puj<EFBFBD>ce podczas pracy programu s<EFBFBD> raportowane z wykorzystaniem 
.B syslogd (8).

.SH OPCJE
.TP
.BI --help
Wy<EFBFBD>wietla pomoc i na tym ko<EFBFBD>czy wykonanie programu.
  
.TP
.BI --version
Wy<EFBFBD>wietla pomoc i na tym ko<EFBFBD>czy wykonanie programu.
 
.TP
.BI --debug
Uruchamia w trybie usuwania b<EFBFBD><EFBFBD>d<EFBFBD>w (domy<EFBFBD>lnie wy<EFBFBD><EFBFBD>czone).
  
.TP
.BI --conf " plik"
Odczytuje konfiguracj<EFBFBD> z
.I pliku
,kt<EFBFBD>rego ka<EFBFBD>da linia odpowiada jednej opcji
linii polece<EFBFBD> pozbawionej przedrostka '--'.  Opcje podane w linii polece<EFBFBD>
nadpisuj<EFBFBD> opcje podane w pliku konfiguracyjnym.
 
.TP
.BI --pidfile " plik"
Nazwa
.I pliku
z identyfikatorem procesu (domy<EFBFBD>lnie ./sgsnemu.pid)
  
.TP
.BI --statedir " <20>cie<69>ka"
.I <EFBFBD>cie<EFBFBD>ka
do katalogu z trwa<EFBFBD>ymi (nie ulotnymi) danymi (domy<EFBFBD>lnie ./)

.TP
.BI --dns " host"
Serwer DNS wykorzystywany do zapyta<EFBFBD> APN.
Je<EFBFBD>li parametr zosta<EFBFBD> pomini<EFBFBD>ty, wykorzystywana jest domy<EFBFBD>lna, systemowa konfiguracja DNS.

.TP
.BI --listen " host"
Lokalny adres IP, kt<EFBFBD>ry zostanie u<EFBFBD>yty do nas<EFBFBD>uchu przez interfejs Gn/Gp.
Ta opcja musi zosta<EFBFBD> podana.
Z przyczyn bezpiecze<EFBFBD>stwa nie mo<EFBFBD>e by<EFBFBD> wykorzystany INADDR_ANY.

.TP
.BI --remote " host"
.I Host
z w<EFBFBD>z<EFBFBD>em GGSN wykorzystywanym do po<EFBFBD><EFBFBD>cze<EFBFBD>.  Je<EFBFBD>li DNS jest prawid<EFBFBD>owo skonfigurowany
to powinno by<EFBFBD> mo<EFBFBD>liwe podanie nazwy punktu dost<EFBFBD>powego (APN) jako nazwy zdalnego hosta.

.TP
.BI --contexts " liczba"
Liczba ustanawianych kontekst<EFBFBD>w (domy<EFBFBD>lnie = 1).  W przypadku wielu kontekst<EFBFBD>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<EFBFBD>czy wykonanie
.b sgsnemu
po up<EFBFBD>ywie podanej liczy \fIsekund\fP.
W przypadku wykorzystywania opcji ping mo<EFBFBD>na zako<EFBFBD>czy<EFBFBD>
.B sgsnemu
po wy<EFBFBD>aniu
.B --pingcount
pakiet<EFBFBD>w.  

.TP
.BI --gtpversion " wersja"
.I wersja
protoko<EFBFBD>u GTP wykorzystywana przy ustanawianiu kontekst<EFBFBD>w (domy<EFBFBD>lnie = 1).
Je<EFBFBD>li nie jest mo<EFBFBD>liwe ustanowienie kontekstu GTPw1
.B sgsnemu
powt<EFBFBD>rzy <EFBFBD><EFBFBD>danie wykorzystuj<EFBFBD>c GTPw0.
  
.TP
.BI --apn " apn"
.I apn
wykorzystywany przy <EFBFBD><EFBFBD>czeniu si<EFBFBD> z w<EFBFBD>z<EFBFBD>em GGSN (domy<EFBFBD>lnie = internet).
APN jest akronimem angielskich s<EFBFBD><EFBFBD>w Access Point Name.

.TP
.BI --selmode " tryb"
Tryb wyboru wykorzystywany w komunikacji z w<EFBFBD>z<EFBFBD>em GGSN (domy<EFBFBD>lnie = 0x01).
Jako tryby wyboru mog<EFBFBD> by<EFBFBD> wykorzystane nast<EFBFBD>puj<EFBFBD>ce kody:
0: MS lub sie<EFBFBD> dostarczana przez APN, subskrypcja zweryfikowana,
1: MS dostarczany przez APN, subskrypcja nie zweryfikowana,
2: sie<EFBFBD> dostarczana przez APN, subskrypcja nie zweryfikowana.

.TP
.BI --imsi " imsi"
.I imsi
wykorzystywane w komunikacji z w<EFBFBD>z<EFBFBD>em GGSN (domy<EFBFBD>lnie = 240010123456789).
IMSI jest akronimem angielskich s<EFBFBD><EFBFBD>w International Mobile Subscriber Identity.
IMSI musi sk<EFBFBD>ada<EFBFBD> si<EFBFBD> z dok<EFBFBD>adnie 15 cyfr.  Por<EFBFBD>wnaj z opcj<EFBFBD>
.I contexts
by zobaczy<EFBFBD> wykorzystanie 
.I imsi
w przypadku wielu kontekst<EFBFBD>w.

.TP
.BI --nsapi " nsapi"
.I nsapi
wykorzystywane w komunikacji z w<EFBFBD>z<EFBFBD>em GGSN (domy<EFBFBD>lnie = 0).
Warto<EFBFBD><EFBFBD> musi by<EFBFBD> pomi<EFBFBD>dzy 0, a 15.

.TP
.BI --msisdn " msisdn"
.I msisdn
wykorzystywane w komunikacji z w<EFBFBD>z<EFBFBD>em GGSN (domy<EFBFBD>lnie = 46702123456).
MSISDN jest akronimem angielskich s<EFBFBD><EFBFBD>w International Mobile Integrated Services Digital Network.
W istocie jest numerem telefonu zapisanym w mi<EFBFBD>dzynarodowym formacie bez wiod<EFBFBD>cych 00 lub 011.
Por<EFBFBD>wnaj z opcj<EFBFBD>
.I contexts
by zobaczy<EFBFBD> wykorzystanie 
.I msisdn
w przypadku wielu kontekst<EFBFBD>w.

.TP
.BI --qos " qos"
.I qos
wykorzystywany w komunikacji z w<EFBFBD>z<EFBFBD>em GGSN (domy<EFBFBD>lnie = 0x0b921f).
QoS jest akronimem angielskich s<EFBFBD><EFBFBD>w Quality of Service.
Format tego parametru zosta<EFBFBD> okre<EFBFBD>lony na podstawie specyfikacji 3GPP 09.60.

.TP
.BI --charging " op<6F>ata"
Charakterystyka rozliczania wykorzystywana w komunikacji z w<EFBFBD>z<EFBFBD>em GGSN
(domy<EFBFBD>lnie = 0x0800).  0x0800 = normalna, 0x0400 = przedp<EFBFBD>ata,
0x0200 = p<EFBFBD>aska rata, 0x0100 = rozliczanie dynamiczne.
Format pola zosta<EFBFBD> opisany w specyfikacji 3GPP 32.015.

.TP
.BI --uid " uid"
Identyfikator u<EFBFBD>ytkownika wysy<EFBFBD>any do GGSN jako opcja konfiguracyjna protoko<EFBFBD>u.

.TP
.BI --pwd " has<61>o"
Identyfikator wysy<EFBFBD>ane do GGSN jako opcja konfiguracyjna protoko<EFBFBD>u.

.TP
.BI --createif
Tworzy lokalny interfejs tun, wykorzystywany dla
przesy<EFBFBD>ania pakiet<EFBFBD>w do i z interfejsu Gn/Gp.
Nale<EFBFBD>y zaznaczy<EFBFBD>, <EFBFBD>e interfejs Gn/Gp zazwyczaj jest kierowany
do Internetu przez GGSN.  Tylko jeden interfejs mo<EFBFBD>e by<EFBFBD> utworzony, chocia<EFBFBD>
wiele kontekst<EFBFBD>w mo<EFBFBD>e zosta<EFBFBD> ustanowionych.
Interfejs mo<EFBFBD>e by<EFBFBD> podany dla ka<EFBFBD>dego kontekstu jako adres IP, lub mo<EFBFBD>e by<EFBFBD>
okre<EFBFBD>lony za pomoc<EFBFBD> opcji
.I net.

.TP
.BI --net " sie<69>"
Adres sieci lokalnego interfejsu.
Opcja
.I net
jest poprawna tylko wtedy, gdy zosta<EFBFBD>a wykorzystana opcja
.I createif.
Warto<EFBFBD><EFBFBD> parametru
.I net
jest podawana w formacie cidr (sie<EFBFBD>/maska).  Je<EFBFBD>li opcja
.I net
zostanie pomini<EFBFBD>ta, adres IP jest rezerwowany dla ka<EFBFBD>dego ustanawianego kontekstu.

.TP
.BI --defaultroute
Definiuje domy<EFBFBD>lne trasowanie przez lokalny interfejs tun.

.TP
.BI --ipup " skrypt"
Skrypt wykonywany po aktywacji interfejsu Gi w sieci tun.
Skrypt jest uruchamiany z nast<EFBFBD>puj<EFBFBD>cymi parametrami <nazwa urz<EFBFBD>dzenia> <adres ip>.
  
.TP
.BI --ipdown " skrypt"
Skrypt wykonywany po wy<EFBFBD><EFBFBD>czeniu interfejsu Gi w sieci tun.
Skrypt jest uruchamiany z nast<EFBFBD>puj<EFBFBD>cymi parametrami <nazwa urz<EFBFBD>dzenia> <adres ip>.
  
.TP
.BI --pinghost " host"
Powoduje wysy<EFBFBD>anie pakiet<EFBFBD>w ICMP do urz<EFBFBD>dzenia
.I host
poprzez interfejs Gn/Gp.  Statystyki po<EFBFBD><EFBFBD>cze<EFBFBD> s<EFBFBD> raportowane w formie
bardzo zbli<EFBFBD>onej do wyj<EFBFBD>cia oryginalnego programu ping.  Mo<EFBFBD>esz wykorzysta<EFBFBD>
to udogodnienie do testowania wydajno<EFBFBD>ci GGSN.

.TP
.BI --pingrate " liczba"
Ilo<EFBFBD><EFBFBD> <EFBFBD><EFBFBD>da<EFBFBD> ICMP generowanych w przeci<EFBFBD>gu sekundy (domy<EFBFBD>lnie = 1).

.TP
.BI --pingsize " liczba"
Rozmiar generowanych <EFBFBD><EFBFBD>da<EFBFBD> ICMP wyra<EFBFBD>ony w oktetach (domy<EFBFBD>lnie = 56).


.TP
.BI --pingcount " liczba"
Oczekiwana ilo<EFBFBD><EFBFBD> wygenerowanych <EFBFBD><EFBFBD>da<EFBFBD> ICMP (domy<EFBFBD>lnie  = 0).
Warto<EFBFBD><EFBFBD> 0 (zero) oznacza wielko<EFBFBD><EFBFBD> nieograniczon<EFBFBD>.

.TP
.BI --pingquiet
Wy<EFBFBD><EFBFBD>cza wypisywanie informacji o otrzymanych pakietach (domy<EFBFBD>lnie pakiety s<EFBFBD> wypisywane).
Jest to ca<EFBFBD>kiem przydatne dla du<EFBFBD>ych ilo<EFBFBD>ci pakiet<EFBFBD>w ICMP generowanych w przeci<EFBFBD>gu sekundy
(por<EFBFBD>wnaj z opcj<EFBFBD> pingrate).

.SH PLIKI
.I sgsnemu.conf
.RS
Plik konfiguracyjny dla
.B sgsnemu.
.RE
.I .sgsnemu.pid
.RS
Plik zawieraj<EFBFBD>cy identyfikator procesu.
.RE
.I ./
.RS
Katalog przechowuj<EFBFBD>cy trwa<EFBFBD>e (nie ulotne) dane.
.RE

.SH B<EFBFBD><EFBFBD>DY
Zg<EFBFBD>aszaj b<EFBFBD><EFBFBD>dy na list<EFBFBD> <EFBFBD>ledzenia b<EFBFBD><EFBFBD>d<EFBFBD>w OpenGGSN
.I http://sourceforge.net/projects/sgsnemu/


.SH "ZOBACZ TAK<41>E"
.BR ggsn (8), 
.BR syslog (8)

.SH UWAGI
.LP

Opr<EFBFBD>cz d<EFBFBD>ugich, udokumentowanych w tym podr<EFBFBD>czniku, opcji
.B sgsnemu
wspiera r<EFBFBD>wnie<EFBFBD> pewn<EFBFBD> liczb<EFBFBD> kr<EFBFBD>tkich opcji o tej samej funkcjonalno<EFBFBD>ci.
Wywo<EFBFBD>aj 
.B sgsnemu --help
by uzyska<EFBFBD> pe<EFBFBD>n<EFBFBD> list<EFBFBD> dost<EFBFBD>pnych opcji.

Sterownik TUN/TAP jest wymagany dla poprawnego dzia<EFBFBD>ania
.B sgsnemu. 
Dla j<EFBFBD>der linuksa p<EFBFBD><EFBFBD>niejszych ni<EFBFBD> 2.4.7 sterownik TUN/TAP jest zawarty w j<EFBFBD>drze,
chocia<EFBFBD> w typowej sytuacji musi by<EFBFBD> <EFBFBD>adowany oddzielnie za pomoc<EFBFBD>
.B modprobe tun.
Aby <EFBFBD>adowa<EFBFBD> automatycznie nale<EFBFBD>y do pliku
.B /etc/modules.conf.
doda<EFBFBD> lini<EFBFBD>  
.B alias char-major-10-200 tun
Aby uzyska<EFBFBD> informacje o innych platformach zobacz stron<EFBFBD>
.I http://vtun.sourceforge.net/tun/
opisuj<EFBFBD>c<EFBFBD> jak zainstalowa<EFBFBD> i skonfigurowa<EFBFBD> sterownik tun.

.B ggsn 
wykorzystuje protok<EFBFBD><EFBFBD> tunelowania GPRS (GTP) wyspecyfikowany przez 
Third Generation Partnership Project (3GPP). Specyfikacje protoko<EFBFBD><EFBFBD>w 3GPP
mog<EFBFBD> by<EFBFBD> znalezione na
.I http://www.3gpp.org

.SH COPYRIGHT

Copyright (C) 2002, 2003, 2004 by Mondru AB.

Zawarto<EFBFBD><EFBFBD> tego pliku mo<EFBFBD>e by<EFBFBD> wykorzystywana stosownie do termin<EFBFBD>w
Og<EFBFBD>lnej, Publicznej Licencji (GPL) GNU w wersji 2 dostarczonej wraz
z niniejsz<EFBFBD> uwag<EFBFBD> o prawach autorskich zawart<EFBFBD> we wszystkich kopiach
i istotnych fragmentach oprogramowania.

.SH AUTORZY
Jens Jakobsen <jj@openggsn.org>

.SH T<EFBFBD>UMACZENIE
Polish translation copyright (C) 2004 Marek <EFBFBD>akowicz <mazaczek@users.sourceforge.net>

T<EFBFBD>umaczenie jest chronione prawami autorskimi.
Dozwolone jest korzystanie, rozprowadzanie i modyfikacja na zasadach licencji GNU GPL 2.