  Dip+SLiRP+CSLIP
  Autor: Zenon Fortuna, zenon@netcom.com
  v1.1, 29 Padziernika 1995
  Wersja polska: Bartosz Maruszewski
  B.Maruszewski@zsmeie.torun.pl
  v1.0, 3 Wrzenia 1997


  [Od tumacza]Tumaczenie to jest zrobione z wersji 1.1, ktr
  znalazem na serwerze u autora, a ktrej nie wiedzie czemu nie ma
  nigdzie na oficjalnych serwerach.[koniec] Dlaczego powsta ten doku
  ment? Jest on przeznaczony dla tych, ktrzy nie chc czyta caego
  NET-3-HOWTO z wszystkimi jego szczegami, ani nie chc czyta doku
  mentacji do Dip-a/SLiRP-a, ale chcieliby zainstalowa SLIP-owe
  poczenie do Internetu, uywajc do tego celu konta z dostpn
  powok (shell-em). Wymieniona wczeniej dokumentacja powinna by
  rozwaana jako bardziej wyczerpujca (i to w obu tego sowa znaczeni
  ach). Opisane przykady zostay przetestowane na pakietach dip337n-uri
  i slirp-0.95h. Testy zostay przeprowadzone na stabilnej wersji jdra
  (tm) Linux-a - 1.2.13, oprogramowanie zostao zainstalowane pod dys
  trybucj Slackware 2.2.0.  Dokument ten zosta napisany w standardzie
  ISO-8859-2.  Orygina tego dokumentu znajduje si pod adresem ftp.net
  com.com w katalogu /pub/ze/zenon/linux/DipSlirpCSLIP/.

  1.  Historia zmian.


  29 Padziernika '95 Wersja: 1.1 Dodaem informacj dla systemw tylko
  z urzdzeniem loopback.  15 Padziernika     Wersja: 1.0
  Pierwotna wersja tego dokumentu.


  2.  Krtki opis.



    Zakadam, e twj serwer ma moliwo dodzwonienia si do serwera
     dostawcy Internet-u, gdzie posiadasz konto z powok (shell-em). Na
     tym serwerze zainstalujemy narzdzie slirp.

    Bdziemy chcieli przygotowa narzdzie dip na Linux-ie, razem ze
     specjalnym skryptem do poczenia si z serwerem dostawcy oraz do
     wystartowania slirp-a na tyme serwerze.

    Uruchomiony dip skonfiguruje parametry linii szeregowej i
     poinformuje Linux-a o przyznanym numerze IP, ktr to informacje
     dostanie od slirp-a na serwerze dostawcy.

    W wyniku tych operacji pakiety TCP/IP wysyane poprzez lini
     szeregow/modem bd obsugiwane przez serwer dostawcy tak jakby
     byy wysane przez nasz serwer.

  I stanie si cud: bdziemy mieli poczenie TCP/IP midzy Linux-em a
  zasobami Internet-u.


  3.  Kroki podczas konfiguracji.



  3.1.  Instalacja SLiRP-a.



    zdobd plik dystrybucyjny ze SLiRP-em, np. slirp-0.95h.tar.gz, i
     skompiluj program slirp na serwerze dostawcy (na komputerze, do
     ktrego bdziesz dzwoni). Plik docs/README.compiling zawarty w
     dystrybucji SLiRP-a wyjania wszystkie szczegy dotyczce
     kompilacji.
     Moesz te wzi ju skompilowan wersj z ibc.wustl.edu
     <ftp://ibc.wustl.edu/pub/slirp_bin/USE_AT_OWN_RISK/>, ktr podaje
     FAQ z Alt.dcom.slip-emulators zawarte w dokumentacji.

    przenie program slirp do jakiego lepszego katalogu, np.
     ./bin/slirp czy ./slirp (w twoim katalogu domowym).

    stwrz w swoim katalogu domowym plik .slirprc
     eby by prosty, to uyjemy tylko kilku polece:


                     #### .slirprc file ####
                     add ptyexec /usr/bin/tcsh -l:10.0.2.1:23
                     compress
                     baudrate 38400
                     #### end



  Polecenie compress zapewnia nas, e zostanie uyty protok CSLIP.
  Polecenie add ptyexec zostao uyte zamiast polecenia shell (list
  polece znajdziesz w pliku docs/CONFIG), poniewa lepiej jest uy
  tcsh -l (w pliku .login), a polecenie shell nie przyjmuje opcji (tak
  sdz). Powiniene uy dokadnej cieki do tcsh na serwerze dostawcy
  (albo uyj jakiej innej powoki (shell-a) jeli wolisz).

  Polecenie baudrate powinno zosta uyte z wartoci odpowiedni dla
  twojego poczenia modemowego.


  3.2.  Testowanie SLiRP-a.


  Zaloguj si na swoje konto u dostawcy i napisz bin/slirp (albo
  ./slirp, w zalenoci od lokalizacji)

  Powiniene zobaczy list wiadomoci z tak lini na kocu:


                  [talking CSLIP, MTU 1500, MRU 1500, 38400 baud]



  Aby wyj ze slirp-a wpisz powoli (z ponad sekundowymi przerwami) pi
  zer.


  3.3.  Konfiguracja twojego Linux-a.


  W skrcie to co musisz zrobi, to przygotowa jdro, eby mogo
  pracowa z sieci i CSLIP-em. Potem powiniene skonfigurowa sie.
  Napisz make config w katalogu /usr/src/linux i odpowiedz "y" na
  nastpujace pytania:









                  Networking support (CONFIG_NET) [y]
                  TCP/IP networking (CONFIG_INET) [y]
                  Assume subnets are local (CONFIG_INET_SNARL) [y]
                  Network device support? (CONFIG_NETDEVICES) [y]
                  Dummy net driver support (CONFIG_DUMMY) [y]
                  SLIP (serial line) support (CONFIG_SLIP) [y]
                  CSLIP compressed headers (CONFIG_SLIP_COMPRESSED) [y]
                  PPP (point-to-point) support (CONFIG_PPP) [y]



  Ja uywam karty Ethernet-owej 3c509, wic moje dodatkowe opcje to:


                  3COM cards (CONFIG_NET_VENDOR_3COM) [y]
                  3c509/3c579 support (CONFIG_EL3) [y]



  Przy instalacji poprzez NFS moesz te doda:


                  NFS filesystem support (CONFIG_NFS_FS) [y]



  Teraz, jak ju poprawnie skonfigurowae jdro, skompiluj je wydajc
  polecenia: make dep && make clean && make zImage. Po kompilacji
  przenie plik /usr/src/linux/arch/i386/boot/zImage do katalogu, w
  ktrym zwykle znajduje si jdro i uruchom lilo.

  Aby skonfigurowa sie, najpierw zdecyduj jaki bdzie twj adres IP.
  Jeli brakuje ci specjalnych adresw, to we 192.168.1.100, ktry to
  jest dozwolony dla uytku lokalnego przez RFC1597.
  Dla systemw tylko z urzdzeniem loopback bdzie to adres 127.0.0.1.
  Jeli chcesz dokadnych i poprawnych informacji, to powiniene raczej
  przeczyta NET-3-HOWTO (dostpne    take po polsku
  <http://www.jtz.org.pl/Html/NET-3-HOWTO.pl.html>), ale moesz
  sprbowa zrobi co takiego:


    Nadaj swojemu systemowi nazw sieciow, np. moj-host.linux.org,
     gdzie wszystkie trzy czony mog by dowolne. Umie powyszy
     acuch (bez znakw ") w pliku /etc/HOSTNAME.

    Zmodyfikuj twj plik /etc/hosts, dodajc:


                     192.168.1.100   moj-host.linux.org moj-host
                     127.0.01        localhost
              (albo  127.0.0.1       moj-host.linux.org moj-host
                     127.0.0.1       localhost)



  acuch "moj-host.linux.org" powinien by identyczny z tym wybranym w
  pierwszym kroku.

    Jeli masz sie Ethernet, to dodaj do pliku /etc/networks lini:


                     moja-siec       192.168.1.0
              (albo  loopback        127.0.0.1)



    Zmodyfikuj swj plik rc.inet1 z katalogu /etc/rc.d (zachowaj gdzie
     oryginaln wersj) i wpisz do niego:


                     IPADDR=moj-host
                     NETWORK=moja-siec
                     NETMASK="255.255.255.0"
                     BROADCAST="192.168.1.255"

              (albo  NETMASK="255.0.0.0"
                     BROADCAST="127.255.255.255")



  Potem jeli masz w komputerze kart Ethernet-ow, to odkomentuj
  ponisze linie:


   /sbin/ifconfig eth0 ${IPADDR} netmask ${NETMASK} broadcast ${BROADCAST}
   /sbin/route add -net ${NETWORK} netmask ${NETMASK}



  W innym razie, jeli masz tylko loopback, to upewnij si, e s tam:


   /sbin/ifconfig lo localhost
   /sbin/route add -net loopback



    Umie swoj nazw domeny linux.org (porwnaj z krokiem pierwszym)
     w pliku /etc/resolv.conf w taki sposb:


                     domain  linux.org



  Teraz zrestartuj system.


  3.4.  Testowanie twojego Linux-a.


  Przede wszystkim obserwuj komunikaty pojawiajce si podczas startu,
  albo zajrzyj do pliku /usr/adm/messages jeli dziaa u ciebie proces
  syslogd(8).

  Powiniene zobaczy mniej wicej takie komunikaty:


                   IP Protocols: ICMP, UDP, TCP
                   PPP: version ...
                   TCP compression ...
                   PPP line discipline registered.
                   SLIP: version ...
                   CSLIP: code copyright ...



  Jeli posiadasz te interfejs Ethernet, to powinien on take zosta
  poprawnie rozpoznany:



                   eth0: 3c509 at 0x280 ...



  Twoja sie powinna by ju aktywna i moesz troch potestowa kilkoma
  poleceniami:


    Uruchom /sbin/ifconfig bez parametrw.
     Powiniene zobaczy aktywny interfejs lo (loopback) wraz z
     przypisanymi mu adresami.
     Jeli masz take sie Ethernet, to zobaczysz dodatkowo informacje
     na temat interfejsu eth0 i powiniene zobaczy znany ci ju adres
     inet addr: 192.168.1.100, itp.

    Uruchom /sbin/route bez argumentw.
     Powiniene zobaczy lini dotyczc loopback i ewentualnie nastpn
     dotyczc sieci "moja-sie".

  Dobra, twj Linux jest gotowy do wsppracy z CSLIP-em.


  3.5.  Instalacja DIP-a.



    moliwe, e na twoim Linux-ie jest ju zainstalowany ten program.
     Byoby dobrze mie wersj 3.3.7n (jest tam uaktualniona
     dokumentacja).

    jeli tak nie jest, zdobd ten program, np. dip337n-uri.tar.gz i
     skompiluj program dip na swoim lokalnym komputerze. Robi si to
     poprzez wydanie polecenia make w katalogu dip-3.3.7n.

    przenie program dip do jakiego odpowiedniejszego katalogu, ktry
     jest w twojej zmiennej $PATH, np. /usr/local/bin/ albo
     $HOME/bin/dip.

    w jakim odpowiednim katalogu, np. w $HOME, stwrz skrypt dip-a -
     slirp.dip

  Skrypt dip-a jest zwykle dugi i skomplikowany. W katalogu samples
  znajduje si kilka przykadw (moe to by np. /usr/doc/dip/samples)
  W kadym razie ja podam tutaj swj skrypt jako przykad:






















  #### slirp.dip file ####
  #
  # slirp.dip     Dialup IP script for use with SLiRP and netcom
  #

  main:
    # Ustaw mask sieci na sl0
    netmask 255.255.255.0

    # Ustaw odpowiedni port szeregowy i jego prdko.
    # Moliwe, e musisz zmieni ttyS2 na inn warto dla twojego modemu.
    # Ja mam take uruchomione "mgetty" na tym porcie dlatego uywam
    # "ttyS2" a nie "cua2"
    port ttyS2
    speed 38400

    # Zresetuj modem i lini terminalow.
    # Tutaj wystpuj u niektrych problemy.
    reset

    # Przygotuj si do dzwonienia.
    # Zauwa, e twj modem moe mie inny acuch incjacyjny.
    # Mj to WordBlazer
    send AT S0=0 S11=70 S50=254 S58=2 Q0 V1 E1 X4\r
    wait OK 2
    if $errlvl != 0 goto modem_trouble

  redial:
    # Wybierz numer.
    # U ciebie bdzie raczej inny numer.
    send ATDT 274 2900\r
    wait CONNECT 50
    if $errlvl != 0 goto dial_trouble

    # Poczylimy si. Zaloguj ten fakt do systemu.
  login:
    sleep 2
    send \n
    wait ogin: 20
    if $errlvl != 0 goto login_trouble
    print got the login prompt, OK
    # zamie ponisze "zenon" na twj identyfikator u dostawcy
    sleep 2
    send \n
  # Nie wiem dlaczego musiaem doda jeszcze "\n" przed wysaniem mojego
  # identyfikatora, ale inaczej nie dziaao
    sleep 2
    send zenon\n
    print sent 'zenon', waiting for 'password' ...

    wait ord: 30
    if $errlvl != 0 goto password_trouble
    # ponisze "blablabla" zamie na swoje haso.
    send blablabla\r

    # Teraz jestemy ju zalogowani - przypuszczalnie.
  loggedin:
    # Zamie ponisze na TWJ prompt (mj to zenon@netcomNN n% )
    wait zenon 15
    if $errlvl != 0 goto prompt_error

    # SLiRP ustawia 10.0.2.2 jako adres odlegego komputera.
    get $remote 10.0.2.2

    # Upewnij si, e "slirp" jest na ciece i e jest wykonywalny.
    # W tym przykadzie zakadam, e slirp zosta zainstalowany w katalogu
    # $HOME/bin
    send exec bin/slirp\n

    # Ustaw parametry CSLIP-a
    get $mtu 1500
    # Upewnij si, e polecenie "route add -net default $remote" jest wykonane
    # W pakiecie dip-3.3.7n wystarczy wpisa "default"
    default

    # Powiedz "Cze" i odpalaj.
  done:
    print CONNECTED local: $locip ---> remote: $rmtip
    mode CSLIP
    goto exit

  prompt_error:
    print TIME-OUT waiting for SLIPlogin to fire up...
    goto error

  login_trouble:
    print Trouble waiting for the Login: prompt...
    goto error

  password_trouble:
    print Trouble waiting for the Password: prompt...
    goto error

  modem_trouble:
    print Trouble occurred with the modem...
    goto error

  dial_trouble:
    print Trouble occurred while dialing...
  error:
    print CONNECT FAILED to $remote
    quit

  exit:
    exit
  #### end



  KOMENTARZ: W powyszym przykadzie niektre pozycje wymagaj podania
  danych specyficznych dla ciebie:


    numer portu (ja uywam ttyS2)

    szybko portu (ja uywam 38400)

    acuch inicjacyjny modemu (ja mam WordBlazer)

    numer telefonu do twojego dostawcy (mam nadziej, e twj jest
     inny)

    twj identyfikator u dostawcy

    twj prompt (aby potwierdzi zalogowanie si)

    lokalizacja "slirp-a" (mj jest w $HOME/bin)





  3.6.  Testowanie DIP-a.


  Polecenie dip -v slirp.dip spowoduje uruchomienie dip-a w trybie
  verbose - czyli na ekranie bd pojawia si informacje co si w danym
  momencie dzieje.

  Komunikaty pojawiajce si na ekranie mog zasugerowa jakie zmiany
  do skryptu slirp.dip.

  Jeli wszystko poszo dobrze, to powiniene zobaczy taki komunikat na
  kocu:


                  CONNECTED local: 192.168.1.100 ---> remote: 10.0.2.2
           (albo  CONNECTED local: 127.0.0.1 ---> remote: 10.0.2.2)



  a dip "zmienia" si teraz w proces-demon, zwracajc ci dostp do
  prompt-a.

  Przy okazji: teraz aby zakoczy dziaanie dip-a, wpisz po prostu dip
  -k a dziaanie dip-a zostanie zakoczone i poczenie modemowe
  zamknite.


  4.  Normalne dziaanie.



    Uruchom swoje poczenie dip+slirp piszc dip slirp.dip

    Po udanym poczeniu si i po komunikacie CONNECTED... masz ju
     dziaajce poaczenie do Internet-u poprzez swojego dostawc.

     Najpierw sprbuj si poczy z serwerem dostawcy poprzez telnet:
     telnet 10.0.2.1

     Dziki konfiguracji z pliku .slirprc, poczenie to powinno wywoa
     tcsh -l i powiniene otrzyma login prompt.
     Piszc ps moesz zobaczy co takiego:


                      6019 s0 S     0:13 slirp
                      6075 sb IW    0:00 -/usr/bin/tcsh (tcsh)
                     16721 t6 R     0:00 ps



    Moesz zakoczy to poczenie telnet-owe, albo z innego
     wirtualnego terminala czy okienka w X-ach sprbowa poczy si
     przez ftp: ftp 148.81.123.100.

  Po udanym (?) poczeniu anonimowym, moesz odkry, e jeste... na
  sunsite.icm.edu.pl - polskiej kopii archiwum Linux-a.

  Jeli zaszede ju tak daleko, to moesz zacz podziwia moliwoci
  poczenia dip+slirp: jeste na SIECI.

  Rozcz si z "sunsitem" tak szybko jak moesz, powracajc do systemu
  "moj-host".

  Teraz pojawia si pytanie:


  Czy moemy po prostu napisa: ftp sunsite.icm.edu.pl?

  Nie przed uaktywnieniem DNS-u (Domain Name Server).

  W tym momencie moesz chcie si rozczy. Wpisz w swoim lokalnym
  prompcie dip -k.


  4.1.  Dodawanie DNS-u.


  Najprzypuszczalniej twj dostawca Internet-u ma serwis DNS (w
  przeciwnym razie nie byby w stanie uywa pocze Internet-owych w
  normalny sposb). Pocz si raz jeszcze z serweremn dostawcy przy
  pomocy dip slirp.dip i telnet 10.0.2.1. Zajrzyj do pliku
  /etc/resolv.conf.

  Powiniene zobaczy tam kilka takich linijek:


                  nameserver  <adres-IP>



  gdzie <adres-IP> bdzie mia konkretn warto.

  Skopiuj przynajmniej jedn z tych linijek do swojego pliku
  /etc/resol.conf.

  Teraz powr do swojego lokalnego komputera (bez zamykania poczenia)
  i sprawd czy serwis DNS dziaa. Wpisz: dnsquery sunsite.icm.edu.pl.

  Jeli na ekranie pojawi si numer IP powyszego adresu, to oznacza, e
  twj DNS dziaa.

  Teraz moesz uywa takich narzdzi jak lynx, mosaic czy netscape
  bezporednio ze swojego Linux-a.


  5.  Komentarze.


  Ten uproszczony dokument zosta napisany raczej jako streszczenie
  podstawowej instalacji dip+slirp, anieli podrcznik.
  Zamysem byo pomc potencjalnym uykownikom CSLIP-a przy starcie.
  Tekst ten jest wysyany jako mini-HOWTO, dlatego, jei zobaczysz w
  nim jakie oczywiste bdy, daj mi zna, prosz.
  Wszystkie wersj s dostpne u mnie w katalogu na ftp:

  ftp.netcom.com
  <ftp://ftp.netcom.com:/pub/ze/zenon/linux/DipSlirpCSLIP/>.

  Chc podzikowa autorom narzdzi dip i slirp za cudowne programy.
  Jestem pod wraeniem i bardzo wdziczny.

  Zenon Fortuna (zenon@netcom.com <mailto:zenon@netcom.com>)


  5.1.  Od tumacza.


  Tumaczenie to jest chronione prawami autorskimi (C) Bartosza
  Maruszewskiego.  Dozwolone jest rozprowadzanie i dystrybucja na
  prawach takich samych jak dokument oryginalny.


  Jeli znalaze jakie race bdy ortograficzne, gramatyczne,
  skadniowe, techniczne to pisz do mnie:

  B.Maruszewski@zsmeie.torun.pl

  Oficjaln stron tumacze HOWTO jest http://www.jtz.org.pl/

  Aktualne wersje przetumaczonych dokumentw znajduj si na teje
  stronie. Dostpne s take poprzez anonimowe ftp pod adresem
  ftp.ippt.gov.pl w katalogu /pub/Linux/JTZ/.

  Przetumaczone przeze mnie dokumenty znajduj si take na mojej
  stronie WWW. <http://www.zsmeie.torun.pl/~bart/tlumaczenie.html> S
  tam te odwoania do Polskiej Strony Tumaczeniowej.

  Kontakt z nasz grup, grup tumaczy moesz uzyska poprzez list
  dyskusyjn jtz@ippt.gov.pl. Jeli chcesz sie na ni zapisa, to wylij
  list o treci subscribe jtz Imi Nazwisko na adres
  listproc@ippt.gov.pl

  Zmiany w tym dokumencie wprowadzone przez tumacza to:

    zmiana NET-2-HOWTO na NET-3-HOWTO

    zmiana polece kompilacji jdra z "make dep make zImage" na "make
     dep && make clean && make zImage"

    info o polskim tumaczeniu NET-3-HOWTO

    zmiana wywoa ifconfig i route na /sbin/ifconfig i /sbin/route

    zmiana adresu IP z sunsite.unc.edu na sunsite.icm.edu.pl (po co
     czy si z USA skoro mona z Polsk?)

































