.\" * OpenGGSN - Gateway GPRS Support Node .\" * Copyright (C) 2002, 2003 Mondru AB. .\" * Polish translation copyright (C) 2004 Marek Żakowicz .\" * .\" * 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 .\" * .\" * Contributor(s): .\" * .\" * Translation to polish: Marek Zakowicz .\" 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 . .TP .BI --ipdown " skrypt" Skrypt wykonywany po wyłączeniu interfejsu Gi w sieci tun. Skrypt jest uruchamiany z następującymi parametrami . .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 .SH TŁUMACZENIE Polish translation copyright (C) 2004 Marek Żakowicz Tłumaczenie jest chronione prawami autorskimi. Dozwolone jest korzystanie, rozprowadzanie i modyfikacja na zasadach licencji GNU GPL 2.