summaryrefslogtreecommitdiffstats
path: root/tde-i18n-pl/docs/tdenetwork/kppp/dialog-setup.docbook
blob: ea70b4e5eeab874132d3245fc544fffa9e0e3d2d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
<chapter id="dialog-setup">
<title>Ręczna konfiguracja połączenia</title>

<para>Ręczna konfiguracja połączenia nie jest dużo trudniejsze niż z pomocą Asystenta.</para>

<para>Wywołanie okna dialogowego konfiguracji odbywa się podobnie jak uruchamianie asystenta. Należy uruchomić program &kppp; poprzez wybranie w menu <guimenu>K</guimenu> pozycji <guisubmenu>Internet</guisubmenu>, a następnie <guimenuitem>Narzędzie telefonicznego łączenia z Internetem KPPP</guimenuitem></para>

<para>Pojawi się następujące okno dialogowe:</para>

<screenshot>
<screeninfo>Ekran konfiguracji narzędzia do telefonicznego łączenia z Internetem - &kppp;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kppp-dialler-tab.png" format="PNG"/>
</imageobject>
<textobject><phrase>Ekran konfiguracji narzędzia do telefonicznego łączenia z Internetem - &kppp;</phrase>
</textobject>
<caption><para>Ekran konfiguracji narzędzia do telefonicznego łączenia z Internetem - &kppp;</para></caption>
</mediaobject>
</screenshot>

<para>Prawdopodobnie po pierwszym uruchomieniu brak będzie skonfigurowanych połączeń, poniżej przedstawiony zostanie opis jak to zrobić.</para>

<para>Przyciśnięcie przycisku <guibutton>Konfiguruj</guibutton> rozpoczyna procedurę konfiguracji telefonicznego połączenia z Internetem.</para>

<para>Należy nacisnąć przycisk <guilabel>Ustawienia ręczne</guilabel>, co spowoduje pojawienie się następującego okna dialogowego:</para>

<screenshot>
<screeninfo>Okno dialogowe <guilabel>Nowe połączenie</guilabel></screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kppp-account-dial-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Okno dialogowe <guilabel>Nowe połączenie</guilabel></phrase>
</textobject>
<caption>
<para>Okno dialogowe <guilabel>Nowe połączenie</guilabel></para>
</caption>
</mediaobject>
</screenshot>

<!-- Make a screenshot of the actual new Account Dialog with no entries -->

<para>Okno dialogowe <guilabel>Nowe połączenie</guilabel> składa się z następujących kart:</para>

<itemizedlist>
<listitem>
<para><link linkend="account-dial"><guilabel>Dzwonienie</guilabel></link></para>
</listitem>
<listitem>
<para><link linkend="account-ip"><guilabel>Adres IP</guilabel></link></para>
</listitem>
<listitem>
<para><link linkend="account-gateway"><guilabel>Bramka</guilabel></link></para>
</listitem>
<listitem>
<para><link linkend="account-dns"><guilabel>DNS</guilabel></link></para>
</listitem>
<listitem>
<para><link linkend="account-login-script"><guilabel>Skrypt</guilabel></link></para>
</listitem>
<listitem>
<para><link linkend="account-execute"><guilabel>Uruchom</guilabel></link></para>
</listitem>
<listitem>
<para><link
linkend="account-accounting"><guilabel>Koszty</guilabel></link></para>
</listitem>
</itemizedlist>

<para>Zwykle nie trzeba wypełniać wszystkich powyższych informacji, poniżej opisane jednak zostaną wszystkie elementy</para>

<sect1 id="account-dial">
<title>Karta <guilabel>Dzwonienie</guilabel></title>

<screenshot>
<screeninfo>Karta <guilabel>Dzwonienie</guilabel> okna dialogowego Nowe połączenie</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kppp-account-dial-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Karta <guilabel>Dzwonienie</guilabel> okna dialogowego Nowe połączenie</phrase>
</textobject>
<caption><para>Karta <guilabel>Dzwonienie</guilabel> okna dialogowego Nowe połączenie</para>
</caption>
</mediaobject>
</screenshot>

<para>Karta <guilabel>Dzwonienie</guilabel> zawiera następujące opcje:</para>

<variablelist>
<varlistentry>
<term><guilabel>Nazwa połączenia:</guilabel></term>
<listitem>
<para>Należy tu wprowadzić nazwę połączenia. Może to być dowolnie wybrany tekst, jednak w przypadku korzystania z wielu połączeń, nazwy nie mogą się powtarzać.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Numer telefonu</guilabel></term>
<listitem>
<para>Tutaj należy określić numer telefonu, na który ma dzwonić modem. Dla zwiększenia czytelności numeru, można wykorzystać znak<quote>-</quote>. Jeżeli oddzielisz od siebie kilka numerów znakiem dwukropka ((&eg; <userinput>1111111:2222222:3333333</userinput>, program &kppp; będzie próbował dodzwonić się po kolei na każdy z nich, jeżeli otrzyma sygnał zajętości. Można używać przycisków <guibutton>Dodaj</guibutton> w celu dodania kolejnego numeru do listy, <guibutton>Usuń</guibutton> w celu jego usunięcia, oraz ikon <guiicon>do góry</guiicon> i <guiicon>do dołu</guiicon> w celu zmiany kolejności na liście.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Uwierzytelnianie</guilabel></term>
<listitem>
<para>W tej pozycji należy wybrać metodę uwierzytelniania dla konfigurowanego połączenia. Informację o wymaganej metodzie uwierzytelniania, można uzyskać od dostawcy internetowego. Wykorzystanie metod <acronym>PAP</acronym> i <acronym>CHAP</acronym> zostało opisane w rozdziale: <xref linkend="chap-and-pap"/>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zapamiętaj hasło</guilabel></term>
<listitem>
<para>Zaznaczenie tej opcji, spowoduje, że program &kppp; będzie przechowywał wprowadzone hasło pomiędzy kolejnymi połączeniami.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Dostosuj argumenty pppd...</guibutton></term>
<listitem>
<para>Wybranie tej opcji wywołuje okno parametrów demona <application>pppd</application>. Należy wprowadzić tu parametry i opcje, które &kppp; powinno przekazać przy wywoływaniu demona <application>pppd</application>. Ich lista i opis dostępna jest w podręczniku programu <application>pppd</application>. Należy unikać manipulowania tymi parametrami, jeżeli nie jest to konieczne.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="account-ip">
<title>Karta <guilabel>Adres IP</guilabel></title>

<screenshot>
<screeninfo>Karta <guilabel>Adres IP</guilabel> okna dialogowego Nowe połączenie</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kppp-account-ip-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Karta <guilabel>Adres IP</guilabel> okna dialogowego Nowe połączenie</phrase>
</textobject>
<caption><para>Karta <guilabel>Adres IP</guilabel> okna dialogowego Nowe połączenie</para>
</caption>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term><guilabel>Zmienny adres IP</guilabel></term>
<listitem>
<para>Należy zdobyć informację od swojego dostawcy Internetu (<acronym>ISP</acronym>) czy wykorzystywane jest dynamiczne przydzielanie adresów <acronym>IP</acronym>. Jeżeli tak jest, to adres <acronym>IP</acronym> będzie się zmieniał przy każdym połączeniu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Stały adres IP</guilabel></term>
<listitem>
<para>Opcja ta powinna być zaznaczona, w przypadku gdy dostawca Internetu <acronym>ISP</acronym> przydziela użytkownikowi stały adres <acronym>IP</acronym>. W takim wypadku, należy ten adres wprowadzić w polu <guilabel>Adres IP</guilabel>, a także wypełnić Pole <guilabel>Maska podsieci</guilabel>. Informacje te można otrzymać od swojego dostawcy Internetu. Dynamicznie przydzielane zmienne adresy IP, są wykorzystywane przez większość dostawców Internetu, dlatego najczęściej należy pozostawić to pole nie zaznaczone.</para>
</listitem>
</varlistentry>
<varlistentry id="auto-configure-hostname">
<term><guilabel>Skonfiguruj automatycznie nazwę komputera z tego IP</guilabel></term>
<listitem>
<para>Wybranie tej opcji, spowoduje iż &kppp; ustawi nazwę komputera i domenę dla Twojego komputera po nawiązaniu połączenia <acronym>ppp</acronym>.</para>
<para>Ustawianie nazwy następuje po odpytaniu serwera DNS o nazwę hosta dla numeru <acronym>IP</acronym> przydzielonego dla połączenia <acronym>ppp</acronym>.</para>
<para>Opcja, ta może być użyteczna dla użytkowników korzystających z protokołu "talk", wymagającego aby nazwa komputera była identyczna, z nazwą zdefiniowaną dla danego numeru IP. Opcja ta powoduje ignorowanie ustawienia <guilabel>Nazwa domeny</guilabel> w sekcji <guilabel>DNS</guilabel>. Ustawienia domyślne są przywracane do wartości pierwotnych po zakończeniu połączenia <acronym>ppp</acronym>.</para>
<para>Wykorzystanie tej opcji <emphasis>nie</emphasis> jest konieczne, jeżeli użytkownik wykorzystuje połączenie do przeglądania Internetu, czytania e-maili lub pogawędek internetowych. Ma też ona niepożądany skutek uboczny w postaci zablokowania nowych połączeń do X serwera, innymi słowy zablokowana jest możliwość otwierania jakichkolwiek nowych programów wykorzystujących interfejs graficzny.</para>
<para>Opcja ta powinna być włączana tylko gdy jest naprawdę potrzebna.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="account-gateway">
<title>Karta <guilabel>Bramka</guilabel></title>

<screenshot>
<screeninfo>Karta <guilabel>Bramka</guilabel> okna dialogowego Nowe połączenie</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kppp-account-gateway-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Karta <guilabel>Bramka</guilabel> okna dialogowego Nowe połączenie</phrase>
</textobject>
<caption><para>Karta <guilabel>Bramka</guilabel> okna dialogowego Nowe połączenie</para>
</caption>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term><guilabel>Domyślna bramka</guilabel></term>
<listitem>
<para>Opcja domyślnie włączona. Powoduje, iż program demona <application>pppd</application> konfiguruje domyślną bramkę dla połączenia.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Stała Bramka</guilabel></term>
<listitem>
<para>Opcję należy wybrać, jeżeli niezbędne jest podanie adresu bramki innego niż domyślny.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Przypisz domyślny routing dla tej bramki</guilabel></term>
<listitem>
<para>Ustawienie domyślnej bramki. Jest prawie pewne, iż ta opcja powinna być zaznaczona (i jest to ustawienie domyślne).</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="account-dns">
<title>Karta <guilabel>DNS</guilabel></title>

<screenshot>
<screeninfo>Karta <guilabel>DNS</guilabel> okna dialogowego Nowe połączenie</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kppp-account-dns-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Karta <guilabel>DNS</guilabel> okna dialogowego Nowe połączenie</phrase>
</textobject>
<caption><para>Karta <guilabel>DNS</guilabel> okna dialogowego Nowe połączenie</para>
</caption>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term><guilabel>Domena:</guilabel></term>
<listitem>
<para>Należy tu wprowadzić nazwę domeny wykorzystywaną dla komputera. Analogicznie jak w przypadku opcji <acronym>DNS</acronym>, nazwa domeny powraca do wartości bieżącej zdefiniowanej w pliku <filename>/etc/resolv.conf</filename> po zakończeniu połączenia. Jeżeli pole pozostawiono niewypełnione, to program nie ingeruje w nazwę domeny ustawioną w pliku <filename>/etc/resolv.conf</filename></para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Konfiguracja:</guilabel></term>
<listitem>
<para>Należy wybrać pomiędzy opcją: <guilabel>Automatyczna</guilabel> (dostawca Internetu <acronym>ISP</acronym> automatycznie przydziela adresy serwerów <acronym>DNS</acronym> po nawiązaniu połączenia) oraz <guilabel>Ręczna</guilabel>. Po wybraniu drugiej opcji, dostępna staje się sekcja <guilabel>Adres IP dla DNS</guilabel>.</para> 
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Adres IP dla DNS</guilabel></term>
<listitem>
<para>Ta część okna staje się aktywna, w chwili wybrania opcji <guilabel>Ręczna</guilabel>. Należy podać tutaj listę serwerów DNS przydzielonych przez dostawcę Internetu (<acronym>ISP</acronym>). Niezbędne jest podanie co najmniej jednego adresu serwera DNS, aby system operacyjny mógł przetłumaczyć czytelne dla człowieka adresy serwerów (np.: <systemitem>ftp.kde.org</systemitem>) na odpowiadające im numery <acronym>IP</acronym>. Adresy serwerów  <acronym>DNS</acronym> muszą być wprowadzone w ich postaci liczbowej (np. <systemitem>128.231.231.233</systemitem>). Zostają one dodane w trakcie działania programu do pliku  <filename>/etc/resolv.conf</filename>.</para> 
<para>Naciśnięcie przycisku <guibutton>Dodaj</guibutton> spowoduje dodanie nowego adresu serwera <acronym>DNS</acronym> do listy. Przycisk <guibutton>Usuń</guibutton> usuwa pojedynczy adres serwera z listy.</para> 
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Wyłącz istniejące DNS w trakcie połączenia</guilabel></term>
<listitem>
<para>Po zaznaczeniu tej opcji, wszystkie wpisane w pliku <filename>/etc/resolv.conf</filename> serwery DNS zostaną wyłączone w trakcie trwania połączenia.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="account-login-script">
<title>Karta <guilabel>Skrypt</guilabel></title>

<screenshot>
<screeninfo>Karta <guilabel>Skrypt</guilabel> okna dialogowego Nowe połączenie</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kppp-account-login-script-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Karta <guilabel>Skrypt</guilabel> okna dialogowego Nowe połączenie</phrase>
</textobject>
<caption><para>Karta <guilabel>Skrypt</guilabel> okna dialogowego Nowe połączenie</para>
</caption>
</mediaobject>
</screenshot>

<para>W karcie <guilabel>Skrypt</guilabel> możliwe jest stworzenie skryptu logowania, specyficznego dla dostawcy Internetu do którego realizowane jest połączenie. Przed stworzeniem skryptu można skorzystać z terminala oraz informacji uzyskanych od dostawcy internetowego <acronym>ISP</acronym>, aby przeanalizować jaka sekwencja poleceń jest wykonywana przy nawiązywaniu połączenia.</para>

<para>Po lewej stronie okna znajduje się lista wyboru, służąca do wybierania kolejno wykonywanych poleceń skryptu. W polu po prawej stronie należy wprowadzić wymagane dla danego polecenia parametry. Naciśnięcie przycisku <guibutton>Dodaj</guibutton> spowoduje dodanie wpisu <emphasis>na końcu</emphasis> edytowanego skryptu, widocznego w dolnej części okna dialogowego. Przycisk <guibutton>Wstaw</guibutton> powoduje umieszczenie polecenia w dowolnej części skryptu, zaś przycisk <guibutton>Usuń</guibutton> usuwa wybraną linię ze skryptu.</para>

<para>Lista wyboru zawiera następujące polecenia:</para>

<variablelist>
<varlistentry>
<term><guilabel>Expect</guilabel></term>
<listitem>
<para>&kppp; będzie oczekiwał pojawienia się zdefiniowanego ciągu znaków.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Send</guilabel></term>
<listitem>
<para>&kppp; wyśle zdefiniowany ciąg znaków.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Scan</guilabel></term>
<listitem>
<para>&kppp; będzie przeszukiwać wejściowy ciąg znaków, w poszukiwaniu zdefiniowanej sekwencji, a następnie przechowa ciąg znaków następujący po tej sekwencji (do napotkania znaku końca linii) w wewnętrznym buforze. Spacje rozpoczynające i kończące ten ciąg są pomijane.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Save</guilabel></term>
<listitem>
<para>Program przechowuje wprowadzony do bufora tekst do określonego rejestru. Jedynym dostępnym rejestrem jest w chwili obecnej rejestr <varname>password</varname>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Pause</guilabel></term>
<listitem>
<para>Powoduje przerwanie działania skryptu i oczekiwanie przez zdefiniowaną liczbę sekund.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Hangup</guilabel></term>
<listitem>
<para>&kppp; wysyła do modemu polecenie <command>hangup</command> (rozłączenia).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Answer</guilabel></term>
<listitem>
<para>&kppp; ustawia tryb pracy modemu na odpowiadanie na połączenia przychodzące.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Timeout</guilabel></term>
<listitem>
<para>Zmienia domyślny czas oczekiwania na określoną liczbę sekund w trakcie wykonywania skryptu. W razie potrzeby, można to polecenie wykonywać dowolną liczbę razy w trakcie wykonywania skryptu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Prompt</guilabel></term>
<listitem>
<para>Program &kppp; poprosi użytkownika o podanie ciągu znaków, wyświetlając wpisany tekst jako podpowiedź. Użytkownik zobaczy wprowadzany tekst. Jeżeli tekst podpowiedzi, zawierać będzie znacznik <userinput>##</userinput>, to ten fragment zostanie zastąpiony, aktualną zawartością bufora, zapisaną przez polecenie <guilabel>scan</guilabel>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>PWPrompt</guilabel></term>
<listitem>
<para>Program &kppp; prosi użytkownika o wprowadzenie ciągu znaków, wyświetlając podany tekst w pytaniu. Przy wprowadzaniu, zamiast znaków pojawi się gwiazdka "*".</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>ID</guilabel></term>
<listitem>
<para>Jeżeli pole <guilabel>Nazwa użytkownika</guilabel> w głównym oknie programu &kppp; jest wypełnione, to jego zawartość jest wysyłana jako <acronym>ID</acronym>. Jeżeli pole <guilabel>Nazwa użytkownika</guilabel> nie jest wypełnione, to program &kppp; zapyta użytkownika, prosząc o podanie nazwy <acronym>ID</acronym>, wyświetlając wprowadzony tekst jako podpowiedź. Użytkownik, zobaczy wprowadzany przez siebie tekst. Przy kolejnym wykonaniu tego fragmentu skryptu (np. przy wykonywaniu go w pętli lub połączenia zwrotnego) pytanie zostanie wyświetlone niezależnie od tego, czy pole <guilabel>Nazwa użytkownika</guilabel> zostało wypełnione.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Password</guilabel></term>
<listitem>
<para>Jeżeli pole <guilabel>Hasło</guilabel> w głównym oknie programu &kppp; jest wypełnione, to wyślij to hasło. Jeżeli nie, to poproś użytkownika o wprowadzenie hasła, wyświetlając ustawiony tekst jako podpowiedź. Zamiast wprowadzanego tekstu, będą widoczne gwiazdki "*". Przy kolejnym wykonaniu tego fragmentu skryptu (np. przy wykonywaniu go w pętli lub połączenia zwrotnego) pytanie zostanie wyświetlone niezależnie od tego, czy pole <guilabel>Nazwa użytkownika</guilabel> zostało wypełnione.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>LoopStart</guilabel></term>
<listitem>
<para>&kppp; oczekuje na otrzymanie określonego tekstu. Tekst ten zostanie zapamiętany do wykorzystania w poleceniu <varname>LoopEnd</varname>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>LoopEnd</guilabel></term>
<listitem>
<para>Program &kppp; będzie czekać na pojawienie się określonego ciągu znaków, przed zakończeniem pętli. Jeżeli ciąg znaków będący parametrem polecenia <varname>LoopStart</varname> pojawi się, spowoduje to skok do linii następującej po poleceniu <varname>LoopStart</varname>. Pozwala to na powtarzanie wyświetlania pytań o nazwę użytkownika i hasło.</para>
</listitem>
</varlistentry>
</variablelist>

<sect2>
<title>Przykładowe skrypty</title>

<example>
<title>Przykład prostego skryptu logowania</title>
<para>Przykładowy skrypt połączeniowy wykorzystywany przez autora programu: </para>

<screen>Expect      ID:                        <lineannotation># czekaj na ciąg:</lineannotation>
 Send        myid                       <lineannotation># wyślij swoją nazwę użytkownika (zamień myid na rzeczywistą nazwę)</lineannotation>
 Expect      word:                      <lineannotation># czekaj na  'password'</lineannotation>
 Send        4u3fjkl                    <lineannotation># wyślij hasło (tutaj przykładowo '4u3fjkl')</lineannotation>
 Expect      granted                    <lineannotation># Oczekuj na tekst 'Permission granted' po poprawnym zalogowaniu.</lineannotation>
 Send        ppp                        <lineannotation># uruchom sesję ppp po stronie dostawcy Internetu.</lineannotation>
</screen>

</example>

<example>
<title>Skrypt logowania, zadający pytanie o nazwę użytkownika i hasło i wykorzystujący pętle</title>

<para>Poniżej widoczny jest skrypt zawierający pytanie o nazwę użytkownika i hasło. Pytanie pojawi się niezależnie od tego co zostało wprowadzone w polach <guilabel>Nazwa użytkownika</guilabel> oraz <guilabel>Hasło</guilabel> w głównym oknie dialogowym programu &kppp;.</para>

<para>Skrypt ten ilustruje sposób wykorzystania zestawu poleceń LoopStart/LoopEnd. Jeżeli procedura logowania nie powiedzie się (np. z powodu źle wpisanego hasła) dostawca Internetu zwróci komunikat błędu, ponawiając pytanie o nazwę użytkownika i hasło. Jeżeli ciąg znaków <computeroutput>ID:</computeroutput> zostanie wykryty przed wykonaniem polecenia LoopEnd, program &kppp; wróci do linii następującej po poleceniu LoopStart.</para>

<screen>LoopStart   ID:                        <lineannotation># oczekuje na nazwę użytkownika:</lineannotation>
 Prompt      Enter ID:                  <lineannotation># Pyta o nazwę użytkownika i wysyła ją.</lineannotation>
 Expect      word:                      <lineannotation># oczekuje na hasło'</lineannotation>
 PWPrompt    Enter Password:            <lineannotation># Pyta o hasło i wysyła je.</lineannotation>
 LoopEnd     granted                    <lineannotation># Dostawca wysyła tekst 'Permission granted' w przypadku pomyślnego logowania.</lineannotation>
 Send        ppp                        <lineannotation># Uruchamia połączenie ppp po stronie dostawcy Internetu</lineannotation>
</screen>
</example>

<example>
<title>Pytanie o informacje nie wprowadzone w głównym oknie</title>

<para>Widoczny poniżej skrypt, pyta od nazwę użytkownika i hasło w przypadku, ale tylko wtedy, gdy odpowiednie pola w głównym oknie programu  &kppp; nie zostały wypełnione.</para>

<screen>LoopStart   ID:                        <lineannotation># oczekuje na tekst ID:</lineannotation>
 ID          Enter ID:                  <lineannotation># pyta o nazwę użytkownika i wysyła ją.</lineannotation>
 Expect      word:                      <lineannotation># oczekuje na tekst 'password'</lineannotation>
 Password    Enter Password             <lineannotation># Pyta o hasło i wysyła je.</lineannotation>
 LoopEnd     granted                    <lineannotation># dostawca wysyła tekst 'Permission granted' po pomyślnym zalogowaniu.</lineannotation>
 Send        ppp                        <lineannotation># Uruchamia połączenie ppp po stronie dostawcy Internetu</lineannotation>
</screen>

</example>

<example>
<title>Skrypt do połączenia z dostawcą Internetu <acronym>ISP</acronym>, który używa algorytmu challenge/response do uwierzytelniania</title>

<para>Widoczny poniżej skrypt, stosowany jest gdy dostawca Internetu stosuje algorytm challenge/response do uwierzytelniania. Zwykle, wykorzystywany jest sprzętowy klucz (token, coś w rodzaju kalkulatora z wyświetlaczem). Użycie tokenu wymaga znajomości hasła. Po zadzwonieniu na numer dostawcy Internetu, pojawia się ciąg znaków (challenge) który należy wprowadzić do sprzętowego klucza (tokenu). Pojawiające się na wyświetlaczu tokenu dynamicznie przydzielone hasło, należy wprowadzić w celu uzyskania połączenia.</para>

<screen>LoopStart   ID:                        <lineannotation># czekaj na nazwę użytkownika ID:</lineannotation>
 ID          Enter ID:                  <lineannotation># pytanie o nazwę i wysłanie.</lineannotation>
 Scan        Challenge:                 <lineannotation># oczekuj na 'Challenge' i zapamiętaj tekst do napotkania znaku nowej linii.</lineannotation>
 Expect      Password:                  <lineannotation># czekaj na 'password'</lineannotation>
 Prompt      Twój token to ## - Wprowadź hasło  # Pytanie o hasło i przesłanie go.
 LoopEnd     granted                    <lineannotation># Dostawca Internetu wysyła tekst "granted" informujący o sukcesie.</lineannotation>
 Send        ppp                        <lineannotation># uruchamia połączenie ppp po stronie dostawcy Internetu.</lineannotation>
</screen>
</example>

<example>
<title>Wykorzystanie rozkazów "Scan" i "Save" w skryptach</title>

<para>Poniższy skrypt, przedstawia procedurę logowania do fikcyjnego dostawcy Internetu <acronym>ISP</acronym>, który wymaga nowego hasła przy każdym nowym połączeniu. Nowe hasło musi zostać zweryfikowane i zapisane przed następną sesją połączenia. </para>

<screen>University of Lummerland
 
 Login:mylogin
 Password: 
 The password for your next session is: YLeLfkZb
 Please record and enter it for verification.
 Verification:YLeLfkZb
 
 1 = telnet
 2 = SLIP
 3 = PPP
 
 Your choice:
</screen>

<para>Program &kppp; może zrealizować to uciążliwe zadania, za użytkownika, eliminując ryzyko zagubienia kawałka papieru na którym zapisane zostało aktualne hasło. Kluczowym elementem tego skryptu jest kombinacja poleceń: Scan/Save.</para>

<screen>7 Expect      Login:                     <lineannotation># czekaj na pytanie o nazwę użytkownika</lineannotation>
 ID                                     <lineannotation># wyślij nazwę użytkownika</lineannotation>
 Expect      Password:                  <lineannotation># czekaj na pytanie o hasło</lineannotation>
 Password                               <lineannotation># wyślij hasło</lineannotation>
 Scan        is:                        <lineannotation># czekaj na tekst '... next session is:' a następnie
                                        # odczytaj przekazane hasło</lineannotation>
 Save        password                   <lineannotation># zapisz hasło do potrzeb kolejnego logowania</lineannotation>
 Expect      Verification:              <lineannotation># czekaj na tekst 'Verification:'</lineannotation>
 Password                               <lineannotation># prześlij nowe hasło do weryfikacji</lineannotation>
 Expect      choice:                    <lineannotation># poczekaj na pytanie dotyczące wyboru opcji połączenia</lineannotation>
                                        <lineannotation># (telnet, SLIP, PPP)</lineannotation>
 Send        3                          <lineannotation># wybierz opcję 3, np.: PPP</lineannotation>
</screen>
</example>

</sect2>

</sect1>

<sect1 id="account-execute">
<title>Karta <guilabel>Uruchom</guilabel></title>

<screenshot>
<screeninfo>Karta <guilabel>Uruchom</guilabel> okna dialogowego Nowe połączenie</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kppp-account-execute-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Karta <guilabel>Uruchom</guilabel> okna dialogowego Nowe połączenie</phrase>
</textobject>
<caption><para>Karta konta <guilabel>Uruchom</guilabel></para>
</caption>
</mediaobject>
</screenshot>

<para>Można tu wybrać polecenia jakie mają zostać wykonane na pewnych etapach połączenia. Polecenia są wykonywane z Twoim prawdziwym identyfikatorem użytkownika, zatem nie można wykonać programów wymagających uprawnień administratora (o ile sam nim w danym momencie nie jesteś)</para>

<para>Należy podać pełną ścieżkę dostępu do programu, w przeciwnym wypadku &kppp; może go nie znaleźć.</para>

<para>Można tu ustawić polecenia wykonywane na pewnych etapach połączenia modemowego.</para>

<variablelist>
<varlistentry>
<term><guilabel>Przed połączeniem</guilabel></term>
<listitem>
<para>Wykonuje polecenie przez rozpoczęciem dzwonienia do dostawcy internetowego <acronym>ISP</acronym>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Po połączeniu</guilabel></term>
<listitem>
<para>Polecenie wykonywane tylko po zakończonym sukcesem połączeniu do Internetu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Przed rozłączeniem</guilabel></term>
<listitem>
<para>Polecenie wykonywane w czasie trwania połączenia, tuż przed rozłączeniem się modemu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Po rozłączeniu</guilabel></term>
<listitem>
<para>Polecenie wykonywane po zamknięciu połączenia.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Można tutaj uruchamiać na przykład program <application>leafnode</application> tuż po połączeniu, do sprawdzania poczty. Można sprawdzać kolejkę poczty wychodzącej tuż przed rozłączeniem. Można też wykorzystać ze skryptu <quote>czyszczącego</quote> do usunięcia dzienników (logów) oraz pamięci podręcznej po rozłączeniu.</para>

</sect1>

<sect1 id="account-accounting">
<title>Karta <guilabel>Koszty</guilabel></title>

<screenshot>
<screeninfo>Karta <guilabel>Koszty</guilabel> okna dialogowego Nowe połączenie</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kppp-account-accounting-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Karta <guilabel>Koszty</guilabel> okna dialogowego Nowe połączenie</phrase>
</textobject>
<caption><para>Karta <guilabel>Koszty</guilabel> okna dialogowego Nowe połączenie</para>
</caption>
</mediaobject>
</screenshot>

<para>Zaznaczenie opcji <guilabel>Włącz obliczanie kosztów połączenia</guilabel> włącza lub wyłącza funkcję liczenia kosztów.</para>

<para>Z listy należy wybrać sposób liczenia kosztów uzależniony od kraju i dostawcy internetowego.</para>

<para>Jeżeli na liście nie ma żądanego dostawcy Internetu, możliwe jest zdefiniowanie własnego zestawu zasad liczenia kosztów poprzez skopiowanie dostarczonego szablonu. Więcej informacji jako to zrobić znajduje się w <link linkend="appendix-accounting-template">dodatku do dokumentacji</link>.</para>

<para>Ostatnią opcją w tym oknie, jest <guilabel>Podczas połączenia zliczaj</guilabel>, opisana poniżej.</para>

<sect2>
<title>Zliczanie przesłanych danych</title>

<sect3>
<title>Na czym polega funkcja zliczania przesłanych danych?</title>

<para>Zlicza ona po prostu liczbę bajtów przesłanych do i z Internetu przez program &kppp;. Zliczane mogą być bajty wysyłane, odbierane lub wysyłane i odbierane jednocześnie, w zależności od wyboru użytkownika.</para>

</sect3>

<sect3>
<title>Do czego mogę wykorzystywać tę funkcję?</title>

<para>Wielu dostawców internetowych, obciąża użytkowników kosztami połączenia w zależności od przesłanych danych. Czasami dostawca Internetu <acronym>ISP</acronym> oferuje stałą kwotę do wysokości pewnego limitu, a następnie obciąża kosztami przesłania za każdy kolejny megabajt ponad ten limit. Program &kppp; pokazuje użytkownikowi aktualny stan przesłanych danych, co pozwala na dokładną kontrolę kosztów korzystania z Internetu. Nawet jeśli użytkownik nie jest obciążany kosztami dostępu w zależności od przesłanych danych, to może skorzystać z tej opcji dla zaspokojenia własnej ciekawości.</para>

</sect3>

<sect3>
<title>Który rodzaj zliczania wybrać?</title>

<para>W dużej części uzależnione jest to od dostawcy Internetu. Wielu z nich, oblicza jedynie liczbę megabajtów pobranych z Internetu, ignorując ilość danych wysyłanych. W takim wypadku należy wybrać <guilabel>bajty WE</guilabel>. Jeżeli koszty uzależniane są od ruchu w obie stronym należy wybrać <guilabel>bajty WE i WY</guilabel>. Pozycja <guilabel>bajty WY</guilabel>  umieszczona została raczej w celu zachowania kompletności listy, jako że nie jest autorom znany żaden dostawca Internetu, który wykorzystuje ruch wyjściowy do naliczania kosztów. Z tej opcji mogą jednak korzystać osoby, uruchamiające serwer WWW lub &FTP; na komputerze domowym.</para>

</sect3>

<sect3>
<title>Niedogodności</title>

<para>Wykorzystanie opcji zliczania wysłanych i odebranych bajtów nie jest narzędziem doskonałym. Zliczanie dokonywane jest niezależnie od źródła danych, a wielu dostawców ustawia swoje limity przesyłania na dane wysyłane/odbierane poza ich wewnętrzną sieć. Inni ustalają różne poziomy limitów, w zależności od tego czy dane są z sieci dostawcy, w kraju czy z zagranicy. Może się okazać, że jeżeli Internet nie jest intensywnie wykorzystywany do przeglądania sieci, zaś większość stron pobierana jest z serwera pośredniczącego dostawcy Internetu, to dostawca nie pobiera żadnych kosztów za takie połączenie. Program  &kppp; nie jest w stanie kategoryzować pakietów <acronym>IP</acronym> w zależności od źródła ich pochodzenia, tak więc wszystkie będą wliczane do ruchu wychodzącego/przychodzącego. Innym przykładem może być stosowanie przez dostawcę internetowego serwera pośredniczącego dla grup dyskusyjnych, jak np.: <application>nntpcached</application>, wtedy jest pewne iż wartość przesyłania danych wykazana przez &kppp; będzie wyższa od wartości, za którą naliczone będą koszty dostępu do sieci. Z drugiej jednak strony, program &kppp; nigdy nie spowoduje, iż rachunek będzie wyższy niż to wynika z wyliczeń.</para>

</sect3>

</sect2>

</sect1>

</chapter>