Provided by: manpages-pl_0.7-1_all 
NAZWA
chat - zautomatyzowany skrypt dialogu z modemem
SKŁADNIA
chat [ opcje ] skrypt
OPIS
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 plik
Odczytuje skrypt rozmowy z pliku plik. Używanie tej opcji wyklucza parametry
skryptowe rozmowy. Użytkownik musi mieć prawa do odczytu tego pliku. Dozwolonych
jest wiele wierszy w pliku. Do oddzielania napisów powinny być używana spacja lub
tabulacja.
-t czas-oczekiwania
Ustawia czas oczekiwania dla odbioru oczekiwanego łańcucha. Jeśli łańcuch nie
zostanie odebrany w limicie czasowym, to łańcuch odpowiedzi nie jest wysyłany. Może
być natomiast wysłana alternatywna odpowiedź, lub skrypt może zostać przerwany w
wypadku braku takiej alternatywy. Program chat zakończy wtedy działanie, zwracając
niezerowy kod błędu. Można również podać łańcuch czas-oczekiwania, aby go określić.
-r plik-raportu
Ustaw plik dla wyjścia napisów raportujących. Jeżeli używa się słowa kluczowego
REPORT, napisy wynikowe są zapisywane do tego pliku. Jeśli opcja ta nie jest
używana, można i tak używać słów REPORT, które użyją pliku stderr.
-e Zaczyna z włączoną opcją echo. Można ją również włączyć lub wyłączyć w danym
miejscu skryptu chat za pomocą słowa kluczowego ECHO. Przy włączeniu opcji echo,
całe wyjście z modemu jest przekierowane na standardowe wyjście błędów.
-E Włącza podmianę zmiennych środowiskowych w skryptach chat za pomocą standardowej
składni $xxx
-v Żąda uruchomienia skryptu chat w trybie szczegółowym. Program chat będzie wtedy
logował wszystkie teksty uzyskane od modemu, a także te, które sam wysyła.
Domyślnie logi wysyłane są do SYSLOG, metodę logowania można zmienić opcjami -S lub
-s.
-V Żąda uruchomienia skryptu chat w trybie szczegółowym, ale na standardowe wyjście
błędów. Program będzie wówczas logował wszelki tekst otrzymany z modemu i łańcuchy
wyjściowe wysyłane do modemu do urządzenia stderr. Urządzenie to jest zwykle
lokalną konsolą stacji uruchamiającej program chat lub pppd.
-s Używa standardowego wyjścia błędów. Wszystkie komunikaty loga z -v wraz z
komunikatami o błędach będą wysyłane na stderr.
-S Nie używa SYSLOG. Domyślnie, komunikaty o błędach są wysyłane do SYSLOG-a. Opcja -S
powoduje, że komunikaty z opcji -v i wiadomości o błędach nie będą tam wysyłane.
-T numer telefonu
Przekazuje dowolny łańcuch, zwykle numer telefonu, który zostanie wstawiony w
miejsce metaznaku \T w wysyłanym łańcuchu.
-U numer telefonu 2
Przekazuje drugi łańcuch, zwykle numer telefonu, który zostanie wstawiony w miejsce
metaznaku \U w wysyłanym łańcuchu. Jest to przydatne przy wybieraniu adaptera
terminala ISDN wymagającego dwóch numerów.
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 (minie czas
oczekiwania), 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 znak zachęty logowania, chat spróbuje wysłać napis ppp i oczekiwać na
"ssword:". Gdy go odczyta, to wyśle hasło hello2u2.
Na zakończenie łańcucha odpowiedzi zwykle wysyłany jest znak powrotu karetki. 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
łańcucha. Ponieważ normalnie jest przechowywana na dysku, nie powinna zawierać informacji
zmiennych. Generalnie nie jest akceptowane podglądanie łańcuchów czasu, 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żna 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. Powinno się przynajmniej załączyć
sekwencje "pod-oczekiwania". Proszę na przykład rozważyć następujący skrypt:
ogin:--ogin: ppp ssword: hello2u2
Byłby to lepszy skrypt niż poprzedni. Oczekiwałby na ten sam znak zachęty login:, lecz
gdyby go nie odebrał, wysłałby sekwencję powrotu i oczekiwał dalej. Gdyby więc szum linii
zniekształcił pierwszy znak zachęty, to późniejsze przesłanie pustej linii zazwyczaj
wygeneruje nowe.
KOMENTARZE
Komentarze można osadzić w skrypcie programu chat. Komentarz to wiersz zaczynający się
znakiem # (kratką) w kolumnie 1. Są ignorowane przez program chat. Jeśli znak "#" ma
znaleźć się jako pierwszy znak oczekiwanej sekwencji, oczekiwany łańcuch należy ująć w
cudzysłów. Aby czekać na zachętę rozpoczynającą się # (kratką) można użyć składni podobnej
do poniższej:
# Teraz czekaj na zachętę i wyślij łańcuch wylogowania
'# ' logout
WYSYŁANIE DANYCH Z PLIKU
Jeśli łańcuch przeznaczony do wysłania zaczyna się małpą (@), to reszta łańcucha jest
traktowana jako nazwa pliku do odczytania, z którego wzięty jest łańcuch do wysłania.
Jeśli ostatnim znakiem odczytanych danych jest znak nowego wiersza, to jest on usuwany.
Plik może być nazwanym potokiem (lub fifo), a nie tylko zwykłym plikiem. W ten sposób chat
może komunikować się z innym programem np. z programem pytającym użytkownika o hasło i
otrzymującym wpisane hasło.
ŁAŃCUCHY PRZERWANIA (ABORT)
Wiele modemów raportuje status połączenia jako łańcuch. Łańcuchy 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 łańcuchy "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 łańcuch ATDT5551212, wykręcający numer telefonu.
Oczekiwanym napisem jest CONNECT. Jeśli odebrany zostanie łańcuch CONNECT, to reszta
skryptu jest wykonywana. Jednak jeśli modem spotka się z zajętą linią, to wyśle napis
BUSY. Łańcuch ten będzie odpowiadał sekwencji przerwania. Skrypt wtedy zakończy działanie,
ponieważ uzyskał rozkaz przerwania. Podobnie będzie, gdy skrypt uzyska łańcuch NO CARRIER.
ŁAŃCUCHY CLR_ABORT
Sekwencja ta pozwala cofnąć wcześniej ustawiony łańcuch ABORT. Łańcuchy ABORT są
przechowywane w tablicy o z góry zdefiniowanym rozmiarze (w trakcie kompilacji), CLR_ABORT
odzyskają przestrzeń usuniętych wpisów, dzięki czemu nowe łańcuchy będą mogły jej użyć.
ŁAŃCUCHY "POWIEDZ" (SAY)
Dyrektywa SAY pozwala skryptowi na wysłanie łańcucha do użytkownika i na terminal przez
standardowe wyjście błędów. Jeśli chat został uruchomiony przez pppd działającego jako
demona (odłączonego od kontrolującego go terminala), to standardowe wyjście błędów jest
zwykle przekierowywane do pliku /etc/ppp/connect-errors.
Łańcuchy SAY muszą być ujęte w pojedynczy lub podwójny cudzysłów. Jeśli w łańcuchu ma
pojawić się wyświetlany powrót karetki i wysuw wiersza, to trzeba dodać je jawnie do
łańcucha.
Łańcuchy SAY można wykorzystać do przekazania wiadomości o postępie w sekcjach skryptu z
włączoną opcją "ECHO OFF", lecz gdzie wciąż istotne jest powiadomienie użytkownika o tym
co się dzieje. Oto przykład:
ABORT BUSY
ECHO OFF
SAY "Wybieranie numeru dostawcy...\n"
” ATDT5551212
TIMEOUT 120
SAY "Czekanie do 2 minut na połączenie... "
CONNECT ”
SAY "Połączono, teraz nastąpi zalogowanie...\n"
ogin: account
ssword: pass
$ \c
SAY "OK. Zalogowano...\n" etc ...
Ta sekwencja wypisze użytkownikowi same łańcuchy SAY, a wszystkie detale skryptu pozostaną
ukryte. W powyższym przykładzie użytkownik zobaczy:
Wybieranie numeru dostawcy...
Czekanie do 2 minut na połączenie... Połączono, teraz nastąpi zalogowanie...
OK. Zalogowano...
ŁAŃCUCHY RAPORTOWE
Napis raportowy jest bardzo podobny do napisu przerywania. Różnica polega na tym, że
łańcuchy i wszystkie znaki do następującego znaku sterującego, takiego jak CR, są
wypisywane w pliku raportu.
Łańcuchy 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.
Łańcuchy 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 łańcuch 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.
ŁAŃCUCHY CLR_REPORT
Sekwencja ta pozwala cofnąć wcześniej ustawiony łańcuch REPORT. Łańcuchy REPORT są
przechowywane w tablicy o z góry zdefiniowanym rozmiarze (w trakcie kompilacji),
CLR_REPORT odzyskają przestrzeń usuniętych wpisów, dzięki czemu nowe łańcuchy będą mogły
jej użyć.
ECHO
Opcje echo kontrolują czy wyjście z modemu jest przekierowywane na standardowe wyjście
błędów. Opcje tę można ustawić za pomocą -e, lecz można ją kontrolować również słowem
kluczowych ECHO. Para "oczekuj-wysyłaj" ECHO ON włącza ją, a ECHO OFF - wyłącza. Słowo
kluczowe pozwala wybranie części konwersacji która ma być widoczna. Przykładowo w
poniższym skrypcie:
ABORT 'BUSY'
ABORT 'NO CARRIER'
” ATZ
OK\r\n ATD1234567
\r\n \c
ECHO ON
CONNECT \c
ogin: account
niewidoczne są komunikaty wynikające z konfiguracji modemu i wybierania numeru, lecz
poczynając od wiadomości CONNECT (lub BUSY) wszystko jest widoczne.
HANGUP
Opcja HANGUP kontroluje, czy rozłączenie modemu ma być traktowane jako błąd, czy też nie.
Przydatne w skryptach do systemów telefonicznych, które rozłączają się i później
oddzwaniają. Opcja HANGUP może być włączona (ON) lub wyłączona (OFF).
Gdy HANGUP jest ustawione na OFF i modem rozłącza się (np. po pierwszej fazie logowania do
systemu oddzwaniającego) chat kontynuuje wykonywanie skryptu (np. oczekując na połączenie
przychodzące i drugą fazę logowania). Zaraz po zawiązaniu połączenia przychodzącego
powinno się użyć dyrektywy HANGUP ON w celu ponownego przywrócenia zwykłego zachowania.
Oto (prosty) przykładowy skrypt:
ABORT 'BUSY'
” ATZ
OK\r\n ATD1234567
\r\n \c
CONNECT \c
'Callback login:' call_back_ID
HANGUP OFF
ABORT "Bad Login"
'Callback Password:' Call_back_password
TIMEOUT 120
CONNECT \c
HANGUP ON
ABORT "NO CARRIER"
ogin:--BREAK--ogin: real_account
etc ...
CZAS OCZEKIWANIA
Początkowa wartość czasu oczekiwania to 45 sekund. Może to być zmienione przy użyciu
parametru -t. Można również podać "TIMEOUT 0".
Aby zmienić wartość czasu oczekiwania 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 assword: hello2u2
Zmieni to czas oczekiwania na 10 sekund podczas oczekiwania zachęty login:. Następnie czas
oczekiwania jest zmieniany na 5 sekund, podczas oczekiwania na czas oczekiwania password.
Zmieniony czas oczekiwania 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 (koniec pliku). Nie przesyłany jest
po niej znak return. EOT można umieścić w wysyłanym łańcuchu za pomocą sekwencji ^D.
GENEROWANIE PRZERWANIA (BREAK)
Specjalny łańcuch 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 znak zachęty logowania. Przerwanie można umieścić w
wysyłanym łańcuchu za pomocą sekwencji \K.
SEKWENCJE UCIECZKI
Łańcuchy oczekiwania i odpowiedzi mogą zawierać sekwencje ucieczki. Wszystkie sekwencje są
poprawne w łańcuchu odpowiedzi. Wiele jest prawidłowe w napisie oczekiwania. Te, które nie
są poprawne w sekwencji oczekiwania, są zaznaczone.
” Oczekuje lub wysyła łańcuch zerowy. W takim przypadku wysyłany jest znak return.
Sekwencja ta może być zarówno parą apostrofów, jak i cudzysłowów.
\b reprezentuje znak backspace.
\c Powstrzymuje generowanie nowego wiersza na końcu łańcucha 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.
(nieprawidłowe w łańcuchu oczekiwania).
\d Zatrzymuje się na sekundę. Program używa sleep(1), który zatrzyma się maksymalnie
na sekundę. (nieprawidłowe w łańcuchu oczekiwania)
\K Wstawia BREAK (nieprawidłowe w łańcuchu oczekiwania)
\n Przesyła znak nowego wiersza lub powrotu wysuwu wiersza.
\N Przesyła znak null. Ta sama sekwencja może być reprezentowana przez \0.
(nieprawidłowe w łańcuchu oczekiwania)
\p Pauzuje na część sekundy. Opóźnienie wynosi 1/10 sekundy. (nieprawidłowe w łańuchu
oczekiwania)
\q Zabrania zapisywania napisu do pliku SYSLOG. Do dziennika w jego miejscu wpisywany
jest napis ???????. (nieprawidłowe w łańuchu oczekiwania)
\r Wysyła lub oczekuje znak powrotu karetki.
\s Reprezentuje znak spacji w łańuchu. Może to być używane, gdy nie jest pożądanym
cytowanie łańcuchów zawierających spacje. Sekwencje 'HI TIM' i HI\sTIM są
identyczne.
\t Wysyła lub oczekuje znaku tabulacji.
\T Wysyła łańcuch numeru telefonu podany opcją -T. (nieprawidłowe w łańuchu
oczekiwania)
\U Wysyła łańcuch numeru telefonu 2 podany opcją -U. (nieprawidłowe w łańuchu
oczekiwania)
\\ Wysyła lub oczekuje znak odwrotnego ukośnika.
\ddd Przekształca ósemkowe cyfry (ddd) w pojedynczy znak ASCII i wysyła ten znak.
(niektóre znaki nie są używane w sekwencji oczekiwania)
^C Podmienia 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)
ZMIENNE ŚRODOWISKOWE
Zmienne środowiskowe są dostępne w skryptach chat, jeśli w wierszu polecenia podano opcję
-E. Metaznak $ jest używany do wprowadzenia nazwy zmiennej środowiskowej do podmiany.
Jeśli zamiana zawiedzie, ponieważ taka zmienna nie jest ustawiona, nic nie jest zamieniane
zmienną.
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 minięcie czasu oczekiwania dla napisu oczekiwania, który nie miał napisu
"pod-wysłania". Może to oznaczać, że nie zaprogramowano 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 łańcuch oznaczony jako warunek ABORT.
5 Pojawił się drugi łańcuch oznaczony jako warunek ABORT.
6 Pojawił się trzeci łańcuch oznaczony jako warunek ABORT.
7 Pojawił się czwarty łańcuch oznaczony jako warunek ABORT.
... Inne kody wyjścia są również łańcuchami oznaczonymi 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 DIAL TONE". 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. Skrypty programu
chat powstały z idei zaproponowanych przy skrypt programu uucico.
uucico(1), uucp(1)
PRAWA AUTORSKIE
Program chat jest znajduje się w domenie publicznej. Nie jest to publiczna licencja GNU.
Autorzy nie udzielają żadnej gwarancji.
TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika man są: Przemek Borys (PTM)
<pborys@dione.ids.pl> i Michał Kułach <michal.kulach@gmail.com>.
Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na
stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją 2.4.6
oryginału.