openggsn/doc/ggsn.8.pl

.\" * 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 ggsn 8 "Lipiec 2003"
.SH NAZWA
ggsn \- Wêze³ Wspieraj±cy Bramy GPRS (ang. Gateway GPRS Support Node).
.SH U¯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æ" 
] [
.BI \-\-ipup " skrypt" 
] [
.BI \-\-ipdown " skrypt" 
] [
.BI \-\-dynip " sieæ" 
] [
.BI \-\-statip " sieæ" 
] [
.BI \-\-pcodns1 " host" 
] [
.BI \-\-pcodns2 " host" 
] [
.BI \-\-timelimit " sekundy" 
]

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

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

.B ggsn
ma bardzo ograniczone wsparcie dla zarz±dzania.
Obecnie zarówno SNMP jak i mechanizmy rozliczania s± pominiête.
  
.SH "ZOBACZ TAK¯E"
.BR sgsnemu (8), 
.BR syslogd (8)
 
.SH UWAGI
.LP
  
Oprócz d³ugich, udokumentowanych w tym podrêczniku, opcji
.B ggsn
wspiera równie¿ pewn± liczb± krótkich opcji o tej samej funkcjonalno¶ci.
Wywo³aj 
.B ggsn --help
by uzyskaæ pe³n± listê dostêpnych opcji.

Sterownik TUN/TAP jest wymagany dla poprawnego dzia³ania
.B ggsn. 
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 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.