dxpc.1.pl

   1 .\" {PTM/RM//31-08-2000}
   2 .\" Autor troche miesza w konwencji nazw klient|klient proxy|serwer|Serwer proxy
   3 .TH DXPC 1 "19 sierpnia 1999" "dxpc"
   4 .ad b
   5 .SH NAZWA
   6 \fBdxpc\fR - ró¿nicowy kompresor protoko³u X
   7
   8 .SH WERSJA
   9 3.8.0
  10
  11 .SH SK£ADNIA
  12 .BR dxpc
  13 \fB[wspólne] [klient | serwer] [po³±czenie]\fR
  14 .br
  15
  16 \fB[wspólne]\fR opcje:
  17 .br
  18         -p \fInumer_portu\fR -f -k -v -s \fIpoziom_debugowania\fR -l \fIlog_file\fR
  19 .br
  20
  21 \fB[klient]\fR opcje (dla procesu KLIENT-a):
  22 .br
  23         -i \fIpoziom_kopresji\fR -d \fInumer_dispalya\fR -u
  24 .br
  25
  26 \fB[serwer]\fR opcje (dla procesu SERWER-a):
  27 .br
  28         -D \fIdisplay\fR
  29 .br
  30
  31 \fB[po³±czenie]\fR opcje:
  32 .br
  33         \fInazwa_hosta\fR -w
  34 .SH OPIS
  35 \fBdxpc\fR jest kompresorem protoko³u X stworzonym w celu zwiêkszenia
  36 szybko¶ci "transmisji" aplikacji X11 uruchamianych przez wolne ³±cza (np.:
  37 telefoniczne po³±czenia PPP).
  38 .sp
  39 \fBdxpc\fR musi byæ uruchomiony po obu stronach ³±cza. Na jednym z hostów -
  40 gdzie pracuje rzeczywisty X serwer - \fBdxpc\fR pracuje w trybie "serwera proxy",
  41 na drugim w trybie "klienta proxy". "Klient proxy" musi byæ uruchomiony
  42 jako pierwszy. W czasie startu "serwer proxy" nawi±zuje po³±czenie
  43 z "klientem". (Zauwa¿, ¿e wersje \fBdxpc\fR sprzed 3.3.1 u¿ywaj± odwrotnej
  44 konwencji.) Kiedy jeden z procesów \fBdxpc\fR jest przerywany, drugi
  45 automatycznie wy³±cza siê równie¿.
  46 .sp
  47 "Klient proxy" na¶laduje X-serwer. Aplikacje X-klienta ³±cz± sie
  48 z "klientem proxy" u¿ywaj±c displaya "unix:8" (lub <nazwa_hosta>:8 ;
  49 \fBdxpc\fR wspomaga zarówno domeny UNIX-owe jak i gniazda TCP). "Klient
  50 proxy" przechwytuje wywo³ania X-owe od aplikacji, kompresuje je
  51 i wysy³a do "serwera proxy". "Serwer" dekompresuje je i przesy³a
  52 do rzeczywistego serwera X. Podobnie "serwer proxy" otrzymuje
  53 zdarzenia, odpowiedzi i b³êdy od rzeczywistego X-serwera, kompresuje
  54 i przesy³a do "klienta proxy", który po dekompresji ¶le je do
  55 aplikacji klienta.
  56 .sp
  57 Stopieñ kompresji \fBdxpc\fR zale¿y od typu aplikacji X-owej. Dla wiêkszo¶ci
  58 aplikacji \fBdxpc\fR uzyskuje wyniki kompresji od 3:1 do 6:1.
  59 .sp
  60 .SH MODY PRACY
  61 \fBdxpc\fR mo¿e pracowaæ w jednym z dwóch stanów: stanie
  62 nawi±zywania po³±czenia (\fInas³uchiwanie\fR lub \fI³±czenie\fR)
  63 i stanie pracy w Systemie X (\fIklient\fR lub \fIserwer\fR). Ka¿da sesja
  64 pracy w \fBdxpc\fR zawsze zaczyna sie od stanu nawi±zywnia po³±czenia
  65 po czym - je¿eli po³±czenie jest nawi±zane - przechodzi do stanu
  66 pracy w Systemie X.
  67 .sp
  68 \fINas³uchiwanie\fR oczekuje na inicjacjê po³±czenia TCP - miêdzy
  69 dwoma procesami - przez \fI³±czenie\fR. \fINas³uchiwanie\fR musi byæ
  70 zawsze uruchamiane jako pierwsze. \fI£±czenie\fR jest inicjatorem po³±czenie
  71 TCP
  72 z \fInas³uchiwaniem\fR. \fBdxpc\fR startuje w trybie \fI³±czenia\fR je¿eli
  73 podany jest argument \fInazwa_hosta\fR (zobacz: opcje \fBpo³±czenie\fR, powy¿ej).
  74 W innym przypadku startuje w trybie \fInas³uchiwania\fR.
  75 .sp
  76 Proces \fIserwera\fR jest zwykle umiejscowiony na tej samej maszynie,
  77 na której pracuje rzeczywisty X-serwer i odpowiada za wy¶wietlanie
  78 aplikacji, proces \fIklienta\fR
  79 za¶ na maszynie, gdzie jest uruchomiona aplikacja X i odpowiada on za
  80 przekazywanie wyniku pracy aplikacji do procesu \fIserwera\fR.
  81 Domy¶lna kolejno¶æ pracy \fBdxpc\fR jest nastêpujaca: tryb \fInas³uchiwania\fR,
  82 a po zestawieniu po³±czenia tryb \fIklienta\fR (je¿eli nie u¿yto argumentu
  83 \fInazwa_hosta\fR)
  84 lub tryb \fI³±czenia\fR, a po po³±czeniu tryb \fIserwera\fR. Opcja -w
  85 zmienia ta kolejno¶æ (tj.: \fInas³uchiwanie\fR-\fIserwer\fR lub
  86 \fI³±czenie\fR-\fIklient\fR).
  87 .sp
  88 Na przyk³ad komenda \fBdxpc host.w_pracy.com\fR startuje \fBdxpc\fR w trybie
  89 \fI³±czenia\fR (poniewa¿ jest u¿yty argument \fInazwa_hosta\fR)
  90 i potem \fIserwera\fR (bo opcja -w nie zostala u¿yta).
  91 Komenda \fBdxpc -w\fR startuje \fBdxpc\fR w trybie \fInas³uchiwania\fR
  92 (bo nie ma argumentu \fInazwa_hosta\fR) i potem \fIserwera\fR
  93 (bo opcja -w zmienia standardowe wywolanie)
  94 .sp
  95 .SH Opcje
  96 .TP 12
  97 .B -d \fInumer_displaya\fR
  98 Ustawia numer displaya, który \fBdxpc\fR imituje. Domy¶lnie \fBdxpc\fR przyjmuje
  99 warto¶æ 8 (opcja ignorowna w trybie "serwer proxy").
 100
 101 .TP 12
 102 .B -f
 103 Powoduje powielenie siê (forkowanie) \fBdxpc\fR i start jako daemon. Drukowanie
 104 komunikatów na wyj¶cie standardowe (poza b³êdami) jest wstrzymane, statystyki
 105 równie¿.
 106 Proces daemona mo¿e byæ wy³±czony przez (kolejne) u¿ycie \fBdxpc\fR z opcj± \
 107 fB-k\fR.
 108
 109 .TP 12
 110 .B -k
 111 Powoduje przeczytanie numeru PID z pliku blokuj±cego w katalogu domowym
 112 u¿ytkownika (~/.dxpc.pid-HOST-USER-PORT) i przes³anie sygna³u SIGKILL do
 113 pracuj±cego procesu \fBdxpc\fR. Plik blokuj±cy istnieje jedynie je¿eli
 114 \fBdxpc\fR zosta³o uruchomione z opcja \fB-f\fR.
 115
 116 .TP 12
 117 .B -l \fIlog_file\fR
 118 Z t± opcj± \fBdxpc\fR zapisuje komunikaty i informacje statystyczne do
 119 pliku dziennika \fIlog_file\fR.
 120 Opcja szczególnie u¿yteczna z \fB-f\fR.
 121
 122 .TP 12
 123 .B -p \fInumer_portu\fR
 124 Ta opcja ustawia port TCP, który bêdzie u¿ywany do komunikacji miêdzy
 125 "klientem proxy" i "serwerem proxy". Warto¶æ domy¶lna 4000.
 126
 127 .TP 12
 128 .B -s(1|2)
 129 Wy¶wietla raport o poziomie kompresji. W trybie "klienta proxy" \fBdxpc\fR
 130 wypisuje raport o kompresji na podstawie komunikatów od X-klienta,
 131 w trybie "serwera proxy" na podstawie komunikatów X-serwera.
 132 Z opcj± \fB-s1\fR \fBdxpc\fR informuje o poziomie kompresji w postaci
 133 skróconej, z \fB-s2\fR w postaci szczegó³owej. Wiêkszo¶ci u¿ytkowników
 134 z pewno¶ci± wystarczy opcja \fB-s1\fR.
 135
 136 .TP 12
 137 .B "-u -t"
 138 Normalnie \fBdxpc\fR w trybie "klienta proxy" imituje display :8 (zarówno
 139 w przypadku gniazd TCP jak i domen UNIX-owych). Opcja \fB-u\fR
 140 zabrania \fBdxpc\fR u¿ywania domen UNIX-owych, a \fB-t\fR gniazd TCP.
 141 (Opcje s± ignorowane w trybie "serwer proxy").
 142
 143 .TP 12
 144 .B "-v"
 145 \fBdxpc\fR z opcj± \fB-v\fR wypisuje numer wersji, informacje o prawach autorskich
 146 i koñczy pracê.
 147
 148 .TP 12
 149 .B "-w"
 150 Odwraca kolejno¶æ "sluchania" i "inicjowania" w stanie nawi±zywania po³±czenia.
 151 Oznacza to, ¿e klient bêdzie inicjowa³ po³±czenia z serwerem.
 152 W miejsce komend uruchamiaj±cych: klienta \fBdxpc -f\fR i serwera
 153 \fBdxpc -f serwer.w_pracy.com\fR mo¿na u¿yæ: \fBdxpc -w -f serwer.w_domu.priv\fR
 154 - start klienta i \fBdxpc -w -f\fR - start serwera. Opcja \fB-w\fR
 155 jest u¿yteczna dla startu "klienta proxy" za firewallem.
 156
 157 .TP 12
 158 .B "nazwa_hosta"
 159 Argument \fInazwa_hosta\fR musi byæ u¿yty w trybie "serwera proxy"
 160 w celu identyfikacji maszyny (po nazwie b±d¼ po adresie IP), na której
 161 uruchomiony jest \fBdxpc\fR w trybie "klienta proxy". (Obecno¶æ tego argumentu
 162 implikuje start w trybie "serwera proxy", jego brak w trybie "klienta proxy").
 163
 164 .TP 12
 165 .B "-D display"
 166 Ustawia (display) hosta, na który przesy³ane bêd± aplikacje X.
 167 Domy¶lnie jest to zmienna ¶rodowiska DISPLAY.
 168
 169 .TP 12
 170 .B "-i(0..9|99|999)"
 171 Kontrola kompresji bitmap. (Opcja \fB-i\fR mo¿e byæ u¿ywana na kliencie albo
 172 - je¿eli podano opcje \fB-w\fR - na serwerze, w pozosta³ych przypadkach jest
 173 ignorowana.) Numer odpowiada za poziom kompresji; wy¿sze poziomy daj± lepsz±
 174 kompresjê ale kosztem CPU i pamiêci (g³ównie na "kliencie proxy").
 175 Aktulna lista poziomów i typów kompresji jest podana ponizej.
 176
 177 0 : Bez kompresji (oprócz \fBdxpc\fR 3.7.0, gdzie daje bardzo s³ab± kompresjê).
 178
 179 1 : kompresja LZO lzo1x_1; bardzo szybka, ma³e zu¿ycie CPU, rozs±dny poziom
 180 kompresji.
 181
 182 2-9: kompresja LZO wariant lzo1c_n . lzo1c_2 wydaje sie byæ gorsza ni¿ lzo1x_1.
 183
 184 99: kompresja LZO lzo1c_99. Wolna ale bardzo dobra kompresja. Zanotowano
 185 niespodziewane b³êdy. Nie zalecana.
 186
 187 999: kompresja LZO lzo1x_999. Wolna (ale wystarczaj±co szybka dla po³±czeñ
 188 128k ISDN, przy korzystaniu z Pentium II/300 nie u¿ywa - nawet chwilowo - pe³nej mocy
 189 procesora). Warto¶æ domy¶lna i zalecana.
 190
 191
 192 .SH PRZYK£ADY
 193 W przypadku u¿ycia rzeczywistego X-serwera na lokalnej maszynie (pc_w_domu)
 194 i korzystania z aplikacji na zdalnym systemie (serwer.praca.com) wy¶wietlanych
 195 na lokalnej maszynie.
 196 .sp
 197 Na zdalnej maszynie serwer.praca.com
 198 .nf
 199     $ export DISPLAY=pc_w_domu:0 (sh lub bash)
 200 lub $ setenv DISPLAY pc_w_domu:0 (csh lub tcsh)
 201     $ \fBdxpc\fR -f
 202     $ export DISPLAY=unix:8      (sh lub bash)
 203 lub $ setenv DISPLAY unix:8      (csh lub tcsh)
 204 .fi
 205
 206 Na lokalnej maszynie
 207 .nf
 208     $ export DISPLAY=unix:0      (sh lub bash)
 209 lub $ setenv DISPLAY unix:0      (csh lub tcsh)
 210     $ \fBdxpc\fR -f serwer.praca.com
 211 .fi
 212
 213 Teraz znów na zdalnej maszynie
 214 .nf
 215     $ xterm&
 216     $ xemacs&
 217     itd...
 218 .fi
 219
 220 .SH "DXPC I XAUTH"
 221 Je¿eli u¿ywasz autoryzacji X z plikiem .Xauthority na lokalnej maszynie,
 222 gdzie pracuje rzeczywisty X-serwer powiniene¶ dostosowaæ plik .Xauthority
 223 na maszynie, gdzie \fBdxpc\fR jest uruchomione w trybie "klienta proxy".
 224 Jedn± z dróg do tego prowadz±cych jest:
 225  .sp
 226 Skopiowanie pliku ~/.Xauthority z lokalnej maszyny na zdaln± (gdzie
 227 jest "klient proxy").
 228  .sp
 229 Wydanie polecenia
 230 .nf
 231     $ \fBxauth\fR list
 232 .fi
 233 w celu obejrzenia kluczy autoryzacyjnych. Jedna z linijek
 234 w wydruku powinna zawieraæ Twój display X i wygl±daæ podobnie do:
 235 .nf
 236     <Twoj_host>/unix:0   MIT-MAGIC-COOKIE-1   <HEX>
 237 .fi
 238 Na maszynie, na której pracuje "klient proxy" nale¿y "dodaæ" tê liniê
 239 do pliku .Xauthority, ale z "oszukanym" X-displayem (DISPLAY
 240 z serwera, gdzie "klient proxy" nas³uchuje). Opcja "add"
 241 komendy \fBxauth\fR realizuje to nastêpuj±co
 242 .nf
 243     $ \fBxauth\fR add <host>/unix:8 MIT-MAGIC-COOKIE-1  <HEX>
 244 .fi
 245 gdzie <host> jest nazw± maszyny, gdzie jest uruchomiony "klient proxy".
 246 Po wykonaniu tego polecenia powinno byæ mo¿liwe bezproblemowe u¿ywanie \fBdxpc\fR.
 247 .sp
 248 Uwaga: W przypadku po³±czeñ przez slogin (ssh) wydruk z komendy
 249 .nf
 250     $ \fBxauth\fR list
 251 .fi
 252 mo¿e byæ inny. Warto przed podaniem w/w komendy skorzystaæ z
 253 .nf
 254     $ echo $DISPLAY
 255 .fi
 256
 257 .SH AUTOR
 258 Brian Pane
 259
 260 .SH POMOC
 261 Kevin Vigor (kevin@vigor.nu)
 262
 263 .SH PODZIÊKOWANIA
 264 \fBdxpc\fR zaadoptowa³o wiele koncepcji z systemu \fBHBX\fR i \fBFHBX\fR
 265  (http://www.cs.dartmouth.edu/~jmd/decs/DECSpage.html).
 266 .sp
 267 Dziekujê wszystkim u¿ytkownikom, którzy przesy³ali sugestie i uwagi.
 268
 269 .SH ZOBACZ TAK¯E
 270 xauth(1), plik README z dytrybucji dxpc.
 271
 272 .SH OD T£UMACZA
 273 Dodano kilka s³ów w sekcji \fBPRZYK£ADY\fR.