Provided by: manpages-pl_0.5-1_all 
NAZWA
chat - Zautomatyzowany skrypt dialogu z modemem
SKŁADNIA
chat [ options ] script
OPIS
Uwaga! To tłumaczenie może być nieaktualne!
Program chat definiuje wymianę rozmów między komputerem a modemem. Jego głównym celem
jest zestawianie połączeń pomiędzy demonem Point-To-Point (pppd), a procesem pppd drugiego
końca.
OPCJE
-f <chat file>
Odczytaj skrypt rozmowy z pliku file. Używanie tej opcji wyklucza parametry
skryptowe rozmowy. Użytkownik musi mieć prawa do odczytu tego pliku. Dozwolonych
jest wiele linii w pliku. Do oddzielania napisów powinny być używana spacja lub
tabulacja.
-t <timeout>
Ustaw timeout dla odbioru oczekiwanego napisu. Jeśli napis nie zostanie odebrany w
limicie czasowym, to napis odpowiedzi nie jest wysyłany. Może być natomiast wysłana
alternatywna odpowiedź, lub skrypt może zostać przerwany w wypadku braku takiej
alternatywy. Chat zakończy wtedy działanie, zwracając niezerowy kod błędu.
-r <report file>
Ustaw plik dla wyjścia napisów raportujących. Jeżeli używasz słowa kluczowego
REPORT, napisy wynikowe są zapisywane do tego pliku. Jeśli opcja ta nie jest
używana, możesz i tak używać słów REPORT, które użyją pliku stderr.
-v Żądaj uruchomienia skryptu chat w trybie verbose (gadatliwym). Program chat będzie
wtedy logował wszystkie teksty uzyskane od modemu, a także te, które sam wysyła.
Logi wysyłane są do SYSLOG.
-V Żądaj uruchomienia skryptu chat w trybie verbose (gadatliwym), ale na stderr. (tym
się to różni od powyższego). Urządzenie to jest zwykle lokalną konsolą stacji
uruchamiającej program chat lub pppd. Opcja ta nie będzie działać prawidłowo, jeśli
stderr jest przekierowane na /dev/null, co ma miejsce gdy pppd działa w trybie
`detached' (odłączonym od konsoli). W tym wypadku użyj opcji `-v' do zapisywania
sesji na urządzeniu SYSLOG.
script Jeśli skrypt nie jest podany opcją -f w pliku, to skrypt script jest włączany jako
parametry programu chat.
SKRYPT ROZMOWY
Skrypt rozmowy definiuje komunikację.
Skrypt składa się z jednej lub większej ilości par napisów "oczekuj-wysyłaj", oddzielonych
spacjami z ewentualnymi dodatkowymi parami "podoczekuj-podwysyłaj", oddzielonymi kreską,
jak w przykładzie:
ogin:-BREAK-ogin: ppp ssword: hello2u2
Znaczy to, że chat powinien oczekiwać napisu "ogin:". Jeśli to zawiedzie (nastąpi
timeout), to wysyła na drugi koniec sekwencję przerwania (break) i oczekuje napisu
"ogin:". Jeśli jednak pierwszy "ogin:" zostanie odebrany, sekwencja przerwania nie jest
wysyłana.
Gdy już uzyskaliśmy prompt logina, chat spróbuje wysłać napis ppp i oczekiwać na prompt
"ssword:". Gdy odczyta ten prompt, to wyśle hasło, hello2u2.
Na zakończenie napisu odpowiedzi zwykle wysyłany jest CR. Nie jest on oczekiwany w napisie
"oczekiwania", chyba że jest specyficznie wskazany, przez użycie sekwencji \r.
Sekwencja oczekiwania powinna zawierać tylko to, co potrzebne do zidentyfikowania napisu.
Ponieważ normalnie jest przechowywana na dysku, nie powinna zawierać informacji zmiennych.
Generalnie nie jest akceptowane podglądanie napisów czasowych, identyfikacji sieci, lub
innych zmiennych jako sekwencji oczekiwanej.
Aby pomóc poprawić znaki, które mogą być zmienione w sekwencji początkowej, oczekuj raczej
napisu "ogin:" niż "login:". Jest możliwe, że początkowy znak będzie odebrany z błędem, a
wtedy możesz nigdy nie znaleźć oczekiwanego napisu, chociaż został on wysłany przez
system. Z tego powodu, skrypty oczekują "ogin:" zamiast "login:" i "ssword:" zamiast
"password".
Bardzo prosty skrypt może wyglądać następująco:
ogin: ppp ssword: hello2u2
Innymi słowy, oczekuj ....ogin:, wyślij ppp, oczekuj ...ssword:, wyślij hello2u2.
W rzeczywistości proste skrypty są raczej rzadkie. Przynajmniej powinieneś załączyć
sekwencje "pod-oczekiwania". Np. rozważ następujący skrypt:
ogin:--ogin: ppp ssword: hello2u2
Byłby to lepszy skrypt niż poprzedni. Oczekiwałby na ten sam prompt login:, lecz gdyby go
nie odebrał, wysłałby sekwencję powrotu i oczekiwał dalej. Gdyby więc szum linii
zniekształcił pierwszy prompt, to późniejsze przesłanie pustej linii zazwyczaj wygeneruje
nowy prompt.
STRINGI PRZERWANIA (ABORT)
Wiele modemów raportuje status połączenia jako napisy. Napisy te to np. CONNECTED, NO
CARRIER, lub BUSY. Często jest właściwym wyłączenie skryptu, jeśli modem nie połączy się z
drugim końcem. Przy jednej próbie może odebrać BUSY, podczas gdy następnym razem zdarzyć
się może NO CARRIER.
Te napisy "przerywania" mogą być podane w skrypcie przy użyciu sekwencji ABORT. Jest to
zapisane w poniższym przykładzie:
ABORT BUSY ABORT 'NO CARRIER' '' ATZ OK ATDT5551212 CONNECT
Sekwencja ta nie będzie niczego oczekiwać; później wyśle ATZ. Oczekiwaną odpowiedzią jest
OK. Po odebraniu OK, wysyłany jest napis ATDT5551212, wykręcający numer telefonu.
Oczekiwanym napisem jest CONNECT. Jeśli odebrany zostanie napis CONNECT, to reszta skryptu
jest wykonywana. Jednak jeśli modem spotka się z zajętą linią, to wyśle napis BUSY. Napis
ten będzie odpowiadał sekwencji przerwania. Skrypt wtedy zakończy działanie, ponieważ
uzyskał rozkaz przerwania. Podobnie będzie, gdy skrypt uzyska napis NO CARRIER.
STRINGI RAPORTOWE
Napis raportowy jest bardzo podobny do napisu przerywania. Różnica polega na tym, że
napisy i wszystkie znaki do następującego znaku sterującego, takiego jak CR, są wypisywane
w pliku raportu.
Napisy raportu mogą być używane do izolowania ze napisu połączenia ciągu określającego
szybkość transmisji i zwracania wartości użytkownikowi. Analiza logiki napisu raportowego
występuje w połączeniu z innym przetwarzaniem napisu, takim jak podglądanie napisu
oczekiwanego. Użycie tego samego napisu jako przerywający i raportowy, prawdopodobnie nie
jest zbyt użyteczne, jednak jest możliwe.
Napisy raportowe nie wpływają na kod zakończenia programu.
Napisy raportowe mogą być podawane w skrypcie przy użyciu sekwencji REPORT. Jest to
zapisywane w skrypcie jak w następującym przykładzie.
REPORT CONNECT ABORT BUSY '' ATDT5551212 CONNECT '' ogin: account
Sekwencja ta nie będzie oczekiwać niczego; a potem wyśle napis ATDT5551212, wykręcający
numer telefonu. Oczekiwanym napisem jest CONNECT. Jeśli napis ten jest odebrany,
wykonywana jest reszta skryptu. Dodatkowo, program wydrukuje do oczekującego pliku napis
CONNECT plus dodatkowo znaki, które za nim podążały, takie jak szybkość połączenia.
TIMEOUT
Początkowa wartość timeoutu to 45 sekund. Może to być zmienione przy użyciu parametru -t.
Aby zmienić wartość timeoutu dla następnego z oczekiwanych napisów, można użyć
następującego przykładu:
ATZ OK ATDT5551212 CONNECT TIMEOUT 10 ogin:--ogin: TIMEOUT 5 assowrd: hello2u2
Zmieni to timeout na 10 sekund podczas oczekiwania promptu login:. Następnie timeout jest
zmieniany na 5 sekund, podczas oczekiwania na prompt password:.
Zmieniony timeout pozostaje efektywny aż do następnej zmiany.
WYSYŁANIE EOT
Specjalny napis odpowiedzi, EOT, wskazuje, że program chat powinien wysłać znak EOT na
drugi koniec. Normalnie jest to sekwencja End-of-file. Nie przesyłany jest po niej znak
return.
Sekwencja EOT może być załączona do wysyłanego napisu przy użyciu sekwencji ^D.
GENEROWANIE PRZERWANIA (BREAK)
Specjalny napis odpowiedzi, BREAK, spowoduje wysłanie warunku przerwania. Sygnał ten jest
specjalnym sygnałem. Normalną akcją u odbierającego go jest zmiana szybkości transmisji.
Może być używany do przeskakiwania przez dostępne szybkości transmisji, aż będzie można
odebrać prawidłowy prompt logina.
Sekwencja przerwania może być załączona do wysyłanego napisu przy użyciu sekwencji \K.
SEKWENCJE ESKEJPOWE
Napisy oczekiwania i odpowiedzi mogą zawierać sekwencje eskejpowe. Wszystkie sekwencje są
legalne w napisie odpowiedzi. Wiele jest legalnych w napisie oczekiwania. Te, które nie są
legalne w sekwencji oczekiwania, są zaznaczone.
'' Oczekuje lub wysyła napis zerowy. Jeśli wysyłasz napis zerowy, to wysyłany będzie
znak return. Sekwencja ta może być zarówno parą apostrofów, jak i znaków cytowania.
\b reprezentuje znak backspace.
\c Powstrzymuje generowanie nowej linii na końcu napisu odpowiedzi. Jest to jedyna
metoda wysyłania napisu bez kończącego go znaku return. Musi być wysyłana na końcu
napisu. Na przykład sekwencja hello\c prześle po prostu znaki h, e, l, l, o. (nie
używane w napisie oczekiwania)
\d Zatrzymaj się na sekundę. Program użyj sleep(1), który zatrzyma się maksymalnie na
sekundę. (nie używane w napisie oczekiwania)
\K Wstaw BREAK (nie używane w napisie oczekiwania)
\n Prześlij znak nowej linii.
\N Prześlij znak null. Ta sama sekwencja może być reprezentowana przez \0. (nie
używane w napisie oczekiwania)
\p Pauzuj na część sekundy. Opóźnienie wynosi 1/10 sekundy. (nie używane w sekwencji
oczekiwania)
\q Zabroń zapisywania napisu do pliku SYSLOG. Do logu w jego miejscu wpisywany jest
napis ???????. (nie używane w sekwencji oczekiwania)
\r Wyślij lub oczekuj CR.
\s Reprezentuje znak spacji w napisie. Może to być używane, gdy nie jest pożądanym
cytowanie napisów zawierających spacje. Sekwencje 'HI TIM' i HI\sTIM są identyczne.
\t Wyślij lub oczekuj znaku tabulacji.
\\ Wyślij lub oczekuj znaku odwrotnego ukośnika.
\ddd Przekształć ósemkowe cyfry (ddd) w pojedynczy znak ASCII i wyślij ten znak.
(niektóre znaki nie są używane w sekwencji oczekiwania)
^C Podmień sekwencję znakiem sterującym (z Ctrl) reprezentowanym przez C. Na przykład
znak DC1 (17) jest pokazywany jako ^Q. (niektóre znaki nie są używane w sekwencji
oczekiwania)
KODY ZAKOŃCZENIA
Program chat kończy swoje działanie z następującymi kodami wyjścia.
0 Normalne zakończenie programu. Znaczy to, że skrypt został wykonany bez błędów.
1 Jeden, lub więcej parametrów było nieprawidłowych, lub napis oczekiwania był zbyt
duży dla buforów wewnętrznych. Wskazuje to, że program nie był prawidłowo
uruchomiony.
2 Pojawił się błąd podczas uruchomiania programu. Może to być spowodowane błędem
operacji odczytu lub zapisu, lub odebraniem przez program sygnału takiego, jak
SIGINT.
3 Nastąpiło zdarzenie timeoutu dla napisu oczekiwania, który nie miał napisu "pod-
wysłania". Może to oznaczać, że nie zaprogramowałeś właściwie skryptu na ten
warunek, lub że pojawiło się jakieś nieoczekiwane zdarzenie i oczekiwany napis nie
mógł zostać znaleziony.
4 Pojawił się pierwszy napis zaznaczony jako warunek ABORT.
5 Pojawił się drugi napis zaznaczony jako warunek ABORT.
6 Pojawił się trzeci napis zaznaczony jako warunek ABORT.
7 Pojawił się czwarty napis zaznaczony jako warunek ABORT.
... Inne kody wyjścia są również napisami zaznaczonymi jako ABORT.
Używając kodu wyjścia, możliwym jest określenie, które zdarzenie zakończyło skrypt. Jest
możliwym określenie czy modem otrzymał np. napis "BUSY" czy "NO DIALTONE". Podczas gdy
pierwsze zdarzenie wymaga drugiej próby, drugie w ten sposób może mieć mniejsze szanse.
ZOBACZ TAKŻE
Dodatkowe informacje o skryptach chat można znaleźć w dokumentacji UUCP.
uucico(1), uucp(1)
COPYRIGHT
Program chat jest w public domain. Nie jest to licencja GNU.
INFORMACJE O TŁUMACZENIU
Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może
nie być aktualne. W razie zauważenia różnic między powyższym opisem a rzeczywistym
zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie się z oryginalną
(angielską) wersją strony podręcznika za pomocą polecenia:
man --locale=C 8 chat
Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.