jjako | d37c136 | 2004-10-24 21:30:25 +0000 | [diff] [blame] | 1 | |
| 2 | .\" * OpenGGSN - Gateway GPRS Support Node |
| 3 | .\" * Copyright (C) 2002, 2003 Mondru AB. |
| 4 | .\" * Polish translation copyright (C) 2004 Marek ¯akowicz <mazaczek@users.sourceforge.net> |
| 5 | .\" * |
| 6 | .\" * The contents of this file may be used under the terms of the GNU |
| 7 | .\" * General Public License Version 2, provided that the above copyright |
| 8 | .\" * notice and this permission notice is included in all copies or |
| 9 | .\" * substantial portions of the software. |
| 10 | .\" * |
| 11 | .\" * The initial developer of the original code is |
| 12 | .\" * Jens Jakobsen <jj@openggsn.org> |
| 13 | .\" * |
| 14 | .\" * Contributor(s): |
| 15 | .\" * |
| 16 | .\" * Translation to polish: Marek Zakowicz <mazak@debian.linux.org.pl> |
| 17 | .\" Manual page for ggsn |
| 18 | .\" SH section heading |
| 19 | .\" SS subsection heading |
| 20 | .\" LP paragraph |
| 21 | .\" IP indented paragraph |
| 22 | .\" TP hanging label |
| 23 | |
| 24 | .TH sgsnemu 8 "Maj 2004" |
| 25 | .SH NAZWA |
| 26 | sgsnemu \- Emulator Wêz³a Dostarczaj±cego Us³ug GPRS |
| 27 | .SH U¯YTKOWANIE |
| 28 | .B sgsnemu |
| 29 | \-\-help |
| 30 | |
| 31 | .B sgsnemu |
| 32 | \-\-version |
| 33 | |
| 34 | .B sgsnemu |
| 35 | [ |
| 36 | .BI \-\-debug |
| 37 | ] [ |
| 38 | .BI \-\-conf " plik" |
| 39 | ] [ |
| 40 | .BI \-\-pidfile " plik" |
| 41 | ] [ |
| 42 | .BI \-\-statedir " plik" |
| 43 | ] [ |
| 44 | .BI \-\-dns " host" |
| 45 | ] [ |
| 46 | .BI \-\-listen " host" |
| 47 | ] [ |
| 48 | .BI \-\-remote " host" |
| 49 | ] [ |
| 50 | .BI \-\-contexts " liczba" |
| 51 | ] [ |
| 52 | .BI \-\-timelimit " sekundy" |
| 53 | ] [ |
| 54 | .BI \-\-gtpversion " wersja" |
| 55 | ] [ |
| 56 | .BI \-\-apn " apn" |
| 57 | ] [ |
| 58 | .BI \-\-selmode " tryb" |
| 59 | ] [ |
| 60 | .BI \-\-imsi " imsi" |
| 61 | ] [ |
| 62 | .BI \-\-nsapi " nsapi" |
| 63 | ] [ |
| 64 | .BI \-\-msisdn " msisdn" |
| 65 | ] [ |
| 66 | .BI \-\-qos " qos" |
| 67 | ] [ |
| 68 | .BI \-\-charging " op³ata" |
| 69 | ] [ |
| 70 | .BI \-\-uid " uid" |
| 71 | ] [ |
| 72 | .BI \-\-pwd " pwd" |
| 73 | ] [ |
| 74 | .BI \-\-createif |
| 75 | ] [ |
| 76 | .BI \-\-net " sieæ" |
| 77 | ] [ |
| 78 | .BI \-\-defaultroute |
| 79 | ] [ |
| 80 | .BI \-\-ipup " skrypt" |
| 81 | ] [ |
| 82 | .BI \-\-ipdown " skrypt" |
| 83 | ] [ |
| 84 | .BI \-\-pinghost " host" |
| 85 | ] [ |
| 86 | .BI \-\-pingrate " liczba" |
| 87 | ] [ |
| 88 | .BI \-\-pingsize " liczba" |
| 89 | ] [ |
| 90 | .BI \-\-pingcount " liczba" |
| 91 | ] |
| 92 | .SH OPIS |
| 93 | .B sgsnemu |
| 94 | jest czê¶ci± projektu |
| 95 | .B OpenGGSN |
| 96 | i implementuje emulator wêz³a dostarczaj±cego us³ug GPRS (SGSN). |
| 97 | Mo¿e on byæ wykorzystywany zarówno do testowania wêz³ów GGSN, |
| 98 | jak rdzenia sieci GRPS, czy po³±czeñ odwiedzaj±cych. |
| 99 | |
| 100 | Funkcjonalno¶æ i protoko³y GPRS zosta³y ustandaryzowane w ramach projektu |
| 101 | Third Generation Partnership Project (3GPP). |
| 102 | Wed³ug specyfikacji 3GPP, SGSN posiada kilka interfejsów. |
| 103 | .B sgsnemu |
| 104 | implementuje interfejs Gn/Gp, który jest wykorzystywany w kierunku |
| 105 | wêz³ów GGSN. |
| 106 | |
| 107 | Interfejs Gn/Gp mo¿e byæ postrzegany jako ³±cze nadrzêdne wêz³a SGSN. |
| 108 | Jest ono wykorzystywane do komunikacji z wêz³em GGSN, który zazwyczaj jest |
| 109 | pod³±czony do Internetu. |
| 110 | Interfejs Gn/Gp wykorzystuje protokó³ tunelowania GPRS (GTP). |
| 111 | Pakiety u¿ytkownika (zazwyczaj pakiety IP) s± tunelowane za po¶rednictwem protoko³u GTP, |
| 112 | który z kolei wykorzystuje protokó³ UDP nad IP. |
| 113 | |
| 114 | |
| 115 | .B sgsnemu |
| 116 | ustanawia pewn± liczbê po³±czeñ do GGSN. |
| 117 | Wewnêtrzny ping transmituje ¿±dania ICMP poprzez ju¿ ustanowione po³±czenia. |
| 118 | Alternatywnie, mo¿e byæ utworzony lokalny interfejs sieciowy. |
| 119 | W tym przypadku |
| 120 | .B sgsnemu |
| 121 | przekazuje pakiety pomiêdzy lokalnym interfejsem sieciowym i po³±czeniami |
| 122 | ustanowionymi na interfejsie Gn/Gp. |
| 123 | |
| 124 | .B sgsnemu |
| 125 | wykorzystuje sterownik |
| 126 | .B TUN/TAP |
| 127 | jako interfejs lokalny. Interfejs sieci tun jest ustanawiany dla ka¿dego |
| 128 | po³±czenia zestawianego z wêz³em GGSN. |
| 129 | B³êdy wystêpuj±ce podczas pracy programu s± raportowane z wykorzystaniem |
| 130 | .B syslogd (8). |
| 131 | |
| 132 | .SH OPCJE |
| 133 | .TP |
| 134 | .BI --help |
| 135 | Wy¶wietla pomoc i na tym koñczy wykonanie programu. |
| 136 | |
| 137 | .TP |
| 138 | .BI --version |
| 139 | Wy¶wietla pomoc i na tym koñczy wykonanie programu. |
| 140 | |
| 141 | .TP |
| 142 | .BI --debug |
| 143 | Uruchamia w trybie usuwania b³êdów (domy¶lnie wy³±czone). |
| 144 | |
| 145 | .TP |
| 146 | .BI --conf " plik" |
| 147 | Odczytuje konfiguracjê z |
| 148 | .I pliku |
| 149 | ,którego ka¿da linia odpowiada jednej opcji |
| 150 | linii poleceñ pozbawionej przedrostka '--'. Opcje podane w linii poleceñ |
| 151 | nadpisuj± opcje podane w pliku konfiguracyjnym. |
| 152 | |
| 153 | .TP |
| 154 | .BI --pidfile " plik" |
| 155 | Nazwa |
| 156 | .I pliku |
| 157 | z identyfikatorem procesu (domy¶lnie ./sgsnemu.pid) |
| 158 | |
| 159 | .TP |
| 160 | .BI --statedir " ¶cie¿ka" |
| 161 | .I ¦cie¿ka |
| 162 | do katalogu z trwa³ymi (nie ulotnymi) danymi (domy¶lnie ./) |
| 163 | |
| 164 | .TP |
| 165 | .BI --dns " host" |
| 166 | Serwer DNS wykorzystywany do zapytañ APN. |
| 167 | Je¶li parametr zosta³ pominiêty, wykorzystywana jest domy¶lna, systemowa konfiguracja DNS. |
| 168 | |
| 169 | .TP |
| 170 | .BI --listen " host" |
| 171 | Lokalny adres IP, który zostanie u¿yty do nas³uchu przez interfejs Gn/Gp. |
| 172 | Ta opcja musi zostaæ podana. |
| 173 | Z przyczyn bezpieczeñstwa nie mo¿e byæ wykorzystany INADDR_ANY. |
| 174 | |
| 175 | .TP |
| 176 | .BI --remote " host" |
| 177 | .I Host |
| 178 | z wêz³em GGSN wykorzystywanym do po³±czeñ. Je¶li DNS jest prawid³owo skonfigurowany |
| 179 | to powinno byæ mo¿liwe podanie nazwy punktu dostêpowego (APN) jako nazwy zdalnego hosta. |
| 180 | |
| 181 | .TP |
| 182 | .BI --contexts " liczba" |
| 183 | Liczba ustanawianych kontekstów (domy¶lnie = 1). W przypadku wielu kontekstów |
| 184 | pierwszy kontekst jest ustanawiany z wykorzystaniem imsi + 0 i msidn + 0. |
| 185 | Drugi kontekst jest ustanawiany z wykorzystaniem imsi + 1 i msidn +1. |
| 186 | Trzeci ... |
| 187 | |
| 188 | .TP |
| 189 | .BI --timelimit " sekundy" |
| 190 | Koñczy wykonanie |
| 191 | .b sgsnemu |
| 192 | po up³ywie podanej liczy \fIsekund\fP. |
| 193 | W przypadku wykorzystywania opcji ping mo¿na zakoñczyæ |
| 194 | .B sgsnemu |
| 195 | po wy³aniu |
| 196 | .B --pingcount |
| 197 | pakietów. |
| 198 | |
| 199 | .TP |
| 200 | .BI --gtpversion " wersja" |
| 201 | .I wersja |
| 202 | protoko³u GTP wykorzystywana przy ustanawianiu kontekstów (domy¶lnie = 1). |
| 203 | Je¶li nie jest mo¿liwe ustanowienie kontekstu GTPw1 |
| 204 | .B sgsnemu |
| 205 | powtórzy ¿±danie wykorzystuj±c GTPw0. |
| 206 | |
| 207 | .TP |
| 208 | .BI --apn " apn" |
| 209 | .I apn |
| 210 | wykorzystywany przy ³±czeniu siê z wêz³em GGSN (domy¶lnie = internet). |
| 211 | APN jest akronimem angielskich s³ów Access Point Name. |
| 212 | |
| 213 | .TP |
| 214 | .BI --selmode " tryb" |
| 215 | Tryb wyboru wykorzystywany w komunikacji z wêz³em GGSN (domy¶lnie = 0x01). |
| 216 | Jako tryby wyboru mog± byæ wykorzystane nastêpuj±ce kody: |
| 217 | 0: MS lub sieæ dostarczana przez APN, subskrypcja zweryfikowana, |
| 218 | 1: MS dostarczany przez APN, subskrypcja nie zweryfikowana, |
| 219 | 2: sieæ dostarczana przez APN, subskrypcja nie zweryfikowana. |
| 220 | |
| 221 | .TP |
| 222 | .BI --imsi " imsi" |
| 223 | .I imsi |
| 224 | wykorzystywane w komunikacji z wêz³em GGSN (domy¶lnie = 240010123456789). |
| 225 | IMSI jest akronimem angielskich s³ów International Mobile Subscriber Identity. |
| 226 | IMSI musi sk³adaæ siê z dok³adnie 15 cyfr. Porównaj z opcj± |
| 227 | .I contexts |
| 228 | by zobaczyæ wykorzystanie |
| 229 | .I imsi |
| 230 | w przypadku wielu kontekstów. |
| 231 | |
| 232 | .TP |
| 233 | .BI --nsapi " nsapi" |
| 234 | .I nsapi |
| 235 | wykorzystywane w komunikacji z wêz³em GGSN (domy¶lnie = 0). |
| 236 | Warto¶æ musi byæ pomiêdzy 0, a 15. |
| 237 | |
| 238 | .TP |
| 239 | .BI --msisdn " msisdn" |
| 240 | .I msisdn |
| 241 | wykorzystywane w komunikacji z wêz³em GGSN (domy¶lnie = 46702123456). |
| 242 | MSISDN jest akronimem angielskich s³ów International Mobile Integrated Services Digital Network. |
| 243 | W istocie jest numerem telefonu zapisanym w miêdzynarodowym formacie bez wiod±cych 00 lub 011. |
| 244 | Porównaj z opcj± |
| 245 | .I contexts |
| 246 | by zobaczyæ wykorzystanie |
| 247 | .I msisdn |
| 248 | w przypadku wielu kontekstów. |
| 249 | |
| 250 | .TP |
| 251 | .BI --qos " qos" |
| 252 | .I qos |
| 253 | wykorzystywany w komunikacji z wêz³em GGSN (domy¶lnie = 0x0b921f). |
| 254 | QoS jest akronimem angielskich s³ów Quality of Service. |
| 255 | Format tego parametru zosta³ okre¶lony na podstawie specyfikacji 3GPP 09.60. |
| 256 | |
| 257 | .TP |
| 258 | .BI --charging " op³ata" |
| 259 | Charakterystyka rozliczania wykorzystywana w komunikacji z wêz³em GGSN |
| 260 | (domy¶lnie = 0x0800). 0x0800 = normalna, 0x0400 = przedp³ata, |
| 261 | 0x0200 = p³aska rata, 0x0100 = rozliczanie dynamiczne. |
| 262 | Format pola zosta³ opisany w specyfikacji 3GPP 32.015. |
| 263 | |
| 264 | .TP |
| 265 | .BI --uid " uid" |
| 266 | Identyfikator u¿ytkownika wysy³any do GGSN jako opcja konfiguracyjna protoko³u. |
| 267 | |
| 268 | .TP |
| 269 | .BI --pwd " has³o" |
| 270 | Identyfikator wysy³ane do GGSN jako opcja konfiguracyjna protoko³u. |
| 271 | |
| 272 | .TP |
| 273 | .BI --createif |
| 274 | Tworzy lokalny interfejs tun, wykorzystywany dla |
| 275 | przesy³ania pakietów do i z interfejsu Gn/Gp. |
| 276 | Nale¿y zaznaczyæ, ¿e interfejs Gn/Gp zazwyczaj jest kierowany |
| 277 | do Internetu przez GGSN. Tylko jeden interfejs mo¿e byæ utworzony, chocia¿ |
| 278 | wiele kontekstów mo¿e zostaæ ustanowionych. |
| 279 | Interfejs mo¿e byæ podany dla ka¿dego kontekstu jako adres IP, lub mo¿e byæ |
| 280 | okre¶lony za pomoc± opcji |
| 281 | .I net. |
| 282 | |
| 283 | .TP |
| 284 | .BI --net " sieæ" |
| 285 | Adres sieci lokalnego interfejsu. |
| 286 | Opcja |
| 287 | .I net |
| 288 | jest poprawna tylko wtedy, gdy zosta³a wykorzystana opcja |
| 289 | .I createif. |
| 290 | Warto¶æ parametru |
| 291 | .I net |
| 292 | jest podawana w formacie cidr (sieæ/maska). Je¶li opcja |
| 293 | .I net |
| 294 | zostanie pominiêta, adres IP jest rezerwowany dla ka¿dego ustanawianego kontekstu. |
| 295 | |
| 296 | .TP |
| 297 | .BI --defaultroute |
| 298 | Definiuje domy¶lne trasowanie przez lokalny interfejs tun. |
| 299 | |
| 300 | .TP |
| 301 | .BI --ipup " skrypt" |
| 302 | Skrypt wykonywany po aktywacji interfejsu Gi w sieci tun. |
| 303 | Skrypt jest uruchamiany z nastêpuj±cymi parametrami <nazwa urz±dzenia> <adres ip>. |
| 304 | |
| 305 | .TP |
| 306 | .BI --ipdown " skrypt" |
| 307 | Skrypt wykonywany po wy³±czeniu interfejsu Gi w sieci tun. |
| 308 | Skrypt jest uruchamiany z nastêpuj±cymi parametrami <nazwa urz±dzenia> <adres ip>. |
| 309 | |
| 310 | .TP |
| 311 | .BI --pinghost " host" |
| 312 | Powoduje wysy³anie pakietów ICMP do urz±dzenia |
| 313 | .I host |
| 314 | poprzez interfejs Gn/Gp. Statystyki po³±czeñ s± raportowane w formie |
| 315 | bardzo zbli¿onej do wyj¶cia oryginalnego programu ping. Mo¿esz wykorzystaæ |
| 316 | to udogodnienie do testowania wydajno¶ci GGSN. |
| 317 | |
| 318 | .TP |
| 319 | .BI --pingrate " liczba" |
| 320 | Ilo¶æ ¿±dañ ICMP generowanych w przeci±gu sekundy (domy¶lnie = 1). |
| 321 | |
| 322 | .TP |
| 323 | .BI --pingsize " liczba" |
| 324 | Rozmiar generowanych ¿±dañ ICMP wyra¿ony w oktetach (domy¶lnie = 56). |
| 325 | |
| 326 | |
| 327 | .TP |
| 328 | .BI --pingcount " liczba" |
| 329 | Oczekiwana ilo¶æ wygenerowanych ¿±dañ ICMP (domy¶lnie = 0). |
| 330 | Warto¶æ 0 (zero) oznacza wielko¶æ nieograniczon±. |
| 331 | |
| 332 | .TP |
| 333 | .BI --pingquiet |
| 334 | Wy³±cza wypisywanie informacji o otrzymanych pakietach (domy¶lnie pakiety s± wypisywane). |
| 335 | Jest to ca³kiem przydatne dla du¿ych ilo¶ci pakietów ICMP generowanych w przeci±gu sekundy |
| 336 | (porównaj z opcj± pingrate). |
| 337 | |
| 338 | .SH PLIKI |
| 339 | .I sgsnemu.conf |
| 340 | .RS |
| 341 | Plik konfiguracyjny dla |
| 342 | .B sgsnemu. |
| 343 | .RE |
| 344 | .I .sgsnemu.pid |
| 345 | .RS |
| 346 | Plik zawieraj±cy identyfikator procesu. |
| 347 | .RE |
| 348 | .I ./ |
| 349 | .RS |
| 350 | Katalog przechowuj±cy trwa³e (nie ulotne) dane. |
| 351 | .RE |
| 352 | |
| 353 | .SH B£ÊDY |
| 354 | Zg³aszaj b³êdy na listê ¶ledzenia b³êdów OpenGGSN |
| 355 | .I http://sourceforge.net/projects/sgsnemu/ |
| 356 | |
| 357 | |
| 358 | .SH "ZOBACZ TAK¯E" |
| 359 | .BR ggsn (8), |
| 360 | .BR syslog (8) |
| 361 | |
| 362 | .SH UWAGI |
| 363 | .LP |
| 364 | |
| 365 | Oprócz d³ugich, udokumentowanych w tym podrêczniku, opcji |
| 366 | .B sgsnemu |
| 367 | wspiera równie¿ pewn± liczb± krótkich opcji o tej samej funkcjonalno¶ci. |
| 368 | Wywo³aj |
| 369 | .B sgsnemu --help |
| 370 | by uzyskaæ pe³n± listê dostêpnych opcji. |
| 371 | |
| 372 | Sterownik TUN/TAP jest wymagany dla poprawnego dzia³ania |
| 373 | .B sgsnemu. |
| 374 | Dla j±der linuksa pó¼niejszych ni¿ 2.4.7 sterownik TUN/TAP jest zawarty w j±drze, |
| 375 | chocia¿ w typowej sytuacji musi byæ ³adowany oddzielnie za pomoc± |
| 376 | .B modprobe tun. |
| 377 | Aby ³adowaæ automatycznie nale¿y do pliku |
| 378 | .B /etc/modules.conf. |
| 379 | dodaæ liniê |
| 380 | .B alias char-major-10-200 tun |
| 381 | Aby uzyskaæ informacje o innych platformach zobacz stronê |
| 382 | .I http://vtun.sourceforge.net/tun/ |
| 383 | opisuj±c± jak zainstalowaæ i skonfigurowaæ sterownik tun. |
| 384 | |
| 385 | .B ggsn |
| 386 | wykorzystuje protokó³ tunelowania GPRS (GTP) wyspecyfikowany przez |
| 387 | Third Generation Partnership Project (3GPP). Specyfikacje protoko³ów 3GPP |
| 388 | mog± byæ znalezione na |
| 389 | .I http://www.3gpp.org |
| 390 | |
| 391 | .SH COPYRIGHT |
| 392 | |
| 393 | Copyright (C) 2002, 2003, 2004 by Mondru AB. |
| 394 | |
| 395 | Zawarto¶æ tego pliku mo¿e byæ wykorzystywana stosownie do terminów |
| 396 | Ogólnej, Publicznej Licencji (GPL) GNU w wersji 2 dostarczonej wraz |
| 397 | z niniejsz± uwag± o prawach autorskich zawart± we wszystkich kopiach |
| 398 | i istotnych fragmentach oprogramowania. |
| 399 | |
| 400 | .SH AUTORZY |
| 401 | Jens Jakobsen <jj@openggsn.org> |
| 402 | |
| 403 | .SH T£UMACZENIE |
| 404 | Polish translation copyright (C) 2004 Marek ¯akowicz <mazaczek@users.sourceforge.net> |
| 405 | |
| 406 | T³umaczenie jest chronione prawami autorskimi. |
| 407 | Dozwolone jest korzystanie, rozprowadzanie i modyfikacja na zasadach licencji GNU GPL 2. |