openggsn/doc/ggsn.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 ggsn 8 "Lipiec 2003"
.SH NAZWA
ggsn \- W<EFBFBD>ze<EFBFBD> Wspieraj<EFBFBD>cy Bramy GPRS (ang. Gateway GPRS Support Node).
.SH U<EFBFBD>YTKOWANIE
.B ggsn
\-\-help
  
.B ggsn
  \-\-version

.B ggsn
[
.BI \-\-fg
] [
.BI \-\-debug
] [
.BI \-\-conf " plik"
] [
.BI \-\-pidfile " plik"
] [
.BI \-\-statedir " plik" 
] [ 
.BI \-\-listen " host" 
] [
.BI \-\-net " sie<69>" 
] [
.BI \-\-ipup " skrypt" 
] [
.BI \-\-ipdown " skrypt" 
] [
.BI \-\-dynip " sie<69>" 
] [
.BI \-\-statip " sie<69>" 
] [
.BI \-\-pcodns1 " host" 
] [
.BI \-\-pcodns2 " host" 
] [
.BI \-\-timelimit " sekundy" 
]

.SH OPIS
.B ggsn
jest cz<EFBFBD><EFBFBD>ci<EFBFBD> projektu 
.B OpenGGSN
i implementuje funkcjonalno<EFBFBD><EFBFBD> w<EFBFBD>z<EFBFBD>a wspieraj<EFBFBD>cego bramy GPRS.
W<EFBFBD>z<EFBFBD>y GGSN s<EFBFBD> wykorzystywane przez operator<EFBFBD>w sieci kom<EFBFBD>rkowych jako interfejsy
pomi<EFBFBD>dzy Internetem i reszt<EFBFBD> infrastruktury sieci kom<EFBFBD>rkowej.
  
Funkcjonalno<EFBFBD><EFBFBD> i protoko<EFBFBD>y GPRS zosta<EFBFBD>y ustandaryzowane w ramach projektu
Third Generation Partnership Project (3GPP).  Stosownie do specyfikacji 3GPP,
GGSN posiada dwa interfejsy: interfejs Gn/Gp oraz interfejs Gi.
 
Interfejs Gn/Gp mo<EFBFBD>e by<EFBFBD> postrzegany jako <EFBFBD><EFBFBD>cze podrz<EFBFBD>dne w<EFBFBD>z<EFBFBD>a GGSN.
Jest on wykorzystywany do komunikacji z W<EFBFBD>z<EFBFBD>em Dostarczaj<EFBFBD>cym Us<EFBFBD>ug GPRS
(SGSN), kt<EFBFBD>ry z kolei jest interfejsem do radiowej sieci dost<EFBFBD>powej.
Interfejs Gn/Gp wykorzystuje protok<EFBFBD><EFBFBD> tunelowania GPRS (GTP).  Pakiety danych
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.
  
Drugi z interfejs<EFBFBD>w mo<EFBFBD>e by<EFBFBD> postrzegany jako <EFBFBD><EFBFBD>cze nadrz<EFBFBD>dne,
prowadz<EFBFBD>ce z w<EFBFBD>z<EFBFBD>a GGSN do zewn<EFBFBD>trznej sieci danych.
Gi jest najcz<EFBFBD><EFBFBD>ciej interfejsem do Internetu.
 
.B ggsn
wykorzystuje
.B sterownik TUN/TAP
jako interfejs Gi.  Interfejs w sieci tun jest uruchamiany podczas startu
.B ggsn.
 
.B ggsn
odbiera po<EFBFBD><EFBFBD>czenia nadchodz<EFBFBD>ce od urz<EFBFBD>dze<EFBFBD> ruchomych za po<EFBFBD>rednictwem
sieci radiowej oraz SGSN.  Gdy nadchodzi <EFBFBD><EFBFBD>danie po<EFBFBD><EFBFBD>czenia, ggsn rezerwuje
dla urz<EFBFBD>dzenia ruchomego dynamiczny adres IP i pozwala urz<EFBFBD>dzeniu ruchomemu
korzysta<EFBFBD> z interfejsu Gi.  Po<EFBFBD><EFBFBD>czenia mog<EFBFBD> by<EFBFBD> zamykane zar<EFBFBD>wno przez
stacje ruchome, jak i SGSN.  B<EFBFBD><EFBFBD>dy wyst<EFBFBD>puj<EFBFBD>ce podczas pracy programu
s<EFBFBD> raportowane z wykorzystaniem 
.B syslogd (8).
  
W typowej sytuacji
.B ggsn
jest uruchamiany na komputerze z dwoma kartami Ethernet - jedn<EFBFBD>
przeznaczon<EFBFBD> dla interfejsu Gn/Gp i jedn<EFBFBD> dla interfejsu Gi.
Polityki trasowania i regu<EFBFBD>y <EFBFBD>ciany ogniowej powinny by<EFBFBD> wykorzystane
w celu rozdzielenia ruchu Gi od ruchu Gn/Gp.
  
.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 --fg
Uruchamia na pierwszym planie (domy<EFBFBD>lnie wy<EFBFBD><EFBFBD>czone).
  
.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
(domy<EFBFBD>lnie /etc/ggsn.conf), 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 /var/run/ggsn.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 /var/lib/ggsn/)
 
.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 --net " sie<69>"
Adres sieci interfejsu Gi (domy<EFBFBD>lnie 192.168.0.0/24).
Adres sieci jest ustawiany podczas inicjalizacji, gdy
.B ggsn
uruchamia urz<EFBFBD>dzenie tun dla interfejsu Gi.
 
.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 --dynip " sie<69>"
Pula dynamicznych adres<EFBFBD>w sieci IP.  Okre<EFBFBD>la pul<EFBFBD> dynamicznych adres<EFBFBD>w IP.
Je<EFBFBD>li ta opcja zostanie pomini<EFBFBD>ta, ggsn wykorzystuje do dynamicznej rezerwacji
adres<EFBFBD>w IP, adres sieci okre<EFBFBD>lony przez opcj<EFBFBD>
.BI --net.
  
.TP
.BI --pcodns1 " host"
Serwer PCO DNS 1 (domy<EFBFBD>lnie 0.0.0.0). PCO jest akronimem 
Protocol Configuration Options, co t<EFBFBD>umaczy si<EFBFBD> jako Protok<EFBFBD><EFBFBD> Opcji
Konfiguracyjnych i jest cz<EFBFBD><EFBFBD>ci<EFBFBD> specyfikacji prtoko<EFBFBD><EFBFBD>w GPRS.  Jest
wykorzystywany do informowania stacji ruchomej o adresie serwera DNS
stosowanego do rozwi<EFBFBD>zywania nazw host<EFBFBD>w.
  
.TP
.BI --pcodns2 " host"
Serwer PCO DNS 2 (domy<EFBFBD>lnie 0.0.0.0). PCO jest akronimem 
Protocol Configuration Options, co t<EFBFBD>umaczy si<EFBFBD> jako Protok<EFBFBD><EFBFBD> Opcji
Konfiguracyjnych i jest cz<EFBFBD><EFBFBD>ci<EFBFBD> specyfikacji prtoko<EFBFBD><EFBFBD>w GPRS.  Jest
wykorzystywany do informowania stacji ruchomej o adresie serwera DNS
stosowanego do rozwi<EFBFBD>zywania nazw host<EFBFBD>w.
  
.TP
.BI --timelimit " sekundy"
Ko<EFBFBD>czy wykonanie
.b ggsn
po up<EFBFBD>ywie podanej liczy \fIsekund\fP.
Opcja wykorzystywana w celu usuwania b<EFBFBD><EFBFBD>d<EFBFBD>w.
  

.SH PLIKI
.I /etc/ggsn.conf
.RS
Plik konfiguracyjny dla
.B ggsn.
.RE
.I /var/run/ggsn.pid
.RS
Plik zawieraj<EFBFBD>cy identyfikator procesu.
.RE
.I /var/lib/ggsn
.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/ggsn/

.B ggsn
ma bardzo ograniczone wsparcie dla zarz<EFBFBD>dzania.
Obecnie zar<EFBFBD>wno SNMP jak i mechanizmy rozliczania s<EFBFBD> pomini<EFBFBD>te.
  
.SH "ZOBACZ TAK<41>E"
.BR sgsnemu (8), 
.BR syslogd (8)
 
.SH UWAGI
.LP
  
Opr<EFBFBD>cz d<EFBFBD>ugich, udokumentowanych w tym podr<EFBFBD>czniku, opcji
.B ggsn
wspiera r<EFBFBD>wnie<EFBFBD> pewn<EFBFBD> liczb<EFBFBD> kr<EFBFBD>tkich opcji o tej samej funkcjonalno<EFBFBD>ci.
Wywo<EFBFBD>aj 
.B ggsn --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 ggsn. 
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 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.