path: root/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.