Merged from the latest developing branch.
[MacVim.git] / runtime / doc / xxd-pl.1
blob00cbbffee336d67727910f6e7e13c59ddeaaf163
1 .TH XXD 1 "Sierpieñ 1996" "Strona podrêcznika dla xxd"
2 .\"
3 .\" 21st May 1996
4 .\" Man page author:
5 .\"    Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
6 .\"    Changes by Bram Moolenaar <Bram@vim.org>
7 .SH NAZWA
8 .I xxd
9 \- zrzut pliku do hex lub odwrotnie
10 .SH SYNOPSIS
11 .B xxd
12 \-h[elp]
13 .br
14 .B xxd
15 [opcje] [plik_we [plik_wy]]
16 .br
17 .B xxd
18 \-r[evert] [opcje] [plik_we [plik_wy]]
19 .SH OPIS
20 .I xxd
21 tworzy zrzut heksowy podanego pliku na standardowe wyj¶cie.
22 Mo¿e tak¿e przetworzyæ zrzut heksowy z powrotem do oryginalnej,
23 binarnej formy.
24 Podobnie jak
25 .BR uuencode (1)
27 .BR uudecode (1)
28 pozwala na przekazanie danych binarnych w bezpiecznej w poczcie formie
29 ASCII, ale ma zalety dekodowania na standardowe wyj¶cie.
30 Ponadto mo¿na go u¿yæ do przeprowadzenia ³atania plików binarnych.
31 .SH OPCJE
32 Je¶li nie podano
33 .I plik_we
34 xxd czyta ze standardowego wej¶cie.
35 Je¶li okre¶lono
36 .I plik_wy
37 jako znak
38 .RB \` \- '
39 wtedy dane wej¶ciowe czytane s± ze standardowego wej¶cia.
40 Je¶li nie podano
41 .I plik_wy
42 (lub podano jako
43 .RB \` \- '
44 ), wyniki s± wysy³ane na standardowe wyj¶cie.
45 .PP
46 Pamiêtaj, ¿e u¿yty zosta³ "leniwy" parser, który nie sprawdza wiêcej
47 ni¿ pierwszej litery opcji (o ile ta nie zosta³a obdarzona
48 parametrem). Spacje miêdzy jedno literowymi opcjami i ich parametrami
49 s± opcjonalne. Parametry opcji mog± byæ okre¶lone w notacji dziesiêtnej,
50 heksadecymalej lub oktalnej.
51 St±d
52 .BR \-c8 ,
53 .BR "\-c 8" ,
54 .B \-c 010
56 .B \-cols 8
57 s± sobie równowa¿ne.
58 .PP
59 .TP
60 .IR \-a " | " \-autoskip
61 prze³±cza autoskip: pojedyncza '*' zastêpuje linie nul. Domy¶lnie
62 wy³±czone.
63 .TP
64 .IR \-b " | " \-bits
65 Prze³±cza do zrzutu bitowego (cyfr binarnych) zamiast heksowego.
66 Opcja ta zapisuje oktety ajko osiem cyfr 1 lub 0 zamias normalnego
67 zrzutu heksowego. Ka¿da linia jest poprzedzona przez
68 heksadecymalny numer linii a za nim jego reprezentacja w ascii (lub
69 ebcdic). Opcje linii poleceñ \-r, \-p, \-i nie dzia³aj± w tym
70 trybie.
71 .TP
72 .IR "\-c cols " | " \-cols cols"
73 formatuje liczbê
74 .RI < cols >
75 oktetów na wiersz. Domy¶lnie 16 (\-i: 12, \-ps: 30, \-b: 6). Maks.
76 256.
77 .TP
78 .IR \-E " | "\-EBCDIC
79 zmienia kodowanie znaków w prawej kolumnie z ASCII na EBCDIC.
80 Nie zmienia prezentacji heksadecymalej. Opcja nie dzia³a w po³±czeniu
81 z \-r, \-p lub \-i.
82 .TP
83 .IR "\-g bajtów " | " \-groupsize bajtów"
84 oddziela wyj¶cie ka¿dych
85 .RI < bajtów >
86 bajtów (dwa heksowe znaki lub osiem cyfr binarnych ka¿de) przez bia³y
87 znak.
88 Okre¶l
89 .I \-g 0
90 by wy³±czyæ grupowanie.
91 .RI < Bajtów "> domy¶lnie jest " 2
92 w trybie normalnym i \fI1\fP w trybie bitów.
93 Grupowanie nie dzia³a w trybie postscriptu lub w³±czania.
94 .TP
95 .IR \-h " | " \-help
96 wypisuje podsumowanie dostêpnych poleceñ i koñczy dzia³anie. Nie
97 zostaje przeprowadzony ¿aden zrzut.
98 .TP
99 .IR \-i " | " \-include
100 wyj¶cie w stylu w³±czania pliku w C. Zostaje zapisana kompletna
101 statyczna tablica definicji (nazwana wed³ug pliku wej¶cia), o ile xxd
102 nie czyta ze standardowego wej¶cia.
104 .IR "\-l len " | "\-len len"
105 zakoñcz po wypisaniu
106 .RI < len>
107 oktetów.
109 .IR \-p " | " \-ps " | " \-postscript " | " \-plain
110 wyj¶cie w postcriptowym ci±g³ym stylu zrzutu heksowego. Znany tak¿e
111 jako zwyk³y zrzut heksowy.
113 .IR \-r " | " \-revert
114 odwróæ operacjê: przekonwertuj (lub za³ataj) zrzut heksowy w binarkê.
115 Je¶li nie zapisuje na standardowe wyj¶cie, xxd zapisze plik wyj¶ciowy
116 bez obcinania go. U¿yj kombinacji
117 .I \-r \-p
118 by odczytaæ zwyk³y zrzut heksadecymalny bez numerów linii
119 i okre¶lonego uk³adu kolumn. Dodatkowe bia³e znaki i ³amanie wierszy
120 s± dozwolone wszêdzie.
122 .I \-seek offset
123 Kiedy u¿yty po
124 .IR \-r :
125 odwraca z
126 .RI < offset >
127 dodanym do pozycji w pliku odnalezionym w zrzucie heksowym.
129 .I \-s [+][\-]seek
130 zaczyna na
131 .RI < seek >
132 bajtów abs. (lub wzg.) offsecie pliku wej¶ciowego.
133 \fI+ fRwskazuje, ¿e seek jest wzglêdne do bie¿±cej pozycji pliku (bez
134 znaczenia je¶li nie wczytuje ze standardowego wej¶cia). \fI\- \fRwskazuje
135 ¿e seek powinno byæ o tyle znaków od koñca wej¶cia (lub je¶li
136 po³±czone z \fI+\fR: przezhd bie¿±c± pozycj± pliku na standardowym
137 wej¶ciu).
138 Bez opcji \-s xxd zaczyna od bie¿±cej pozycji w pliku.
140 .I \-u
141 u¿yj wielkich liter w znakach heksowych. Domy¶lnie s± ma³e znaki.
143 .IR \-v " | " \-version
144 pokazuje wersjê programu.
145 .SH OSTRZE¯ENIA
147 .I xxd \-r
148 potrafi okre¶liæ numery linii. Je¶li plik wyj¶cia jest mo¿liwy do
149 przeszukania wtedy numery linii na pocz±tku wiersza zrzutu heksowego
150 mog± byæ nie po kolei, mo¿e brakowaæ wierszy lub nak³adaæ siê na
151 siebie. W takich wypadkach xxd u¿yje lseek(2) by znale¼æ nastêpn±
152 pozycjê. Je¶li plik wyj¶ciowy nie jest mo¿liwy do przeszukania mo¿liwe
153 s± tylko przerwy, które zostan± wype³nione bajtami null.
155 .I xxd \-r
156 nigdy nie podaje b³êdów analizy. ¦mieci s± ignorowane.
158 W czasie edycji zrzutów heksowych, proszê zauwa¿yæ ¿e
159 .I xxd \-r
160 pomija wszystko w linii wej¶cia po odczytaniu wystarczaj±cej ilo¶ci
161 kolumn danych heksadecymalnych (zobacz opcjê \-c). Oznacza to tak¿e,
162 ¿e zmiany w drukowanych kolumnach ascii (lub ebcdic) s± zawsze
163 ignorowane. Odwrócenie zwyk³ego (lub postscriptowego) stylu zrzutu
164 poprzez xxd \-r \-p nie zale¿y od kolejno¶ci kolumn. Tutaj cokolwiej
165 co wygl±da jak para cyfr heks jest interpretowane.
167 Zauwa¿ ró¿nicê miêdzy
169 \fI% xxd \-i plik\fR
173 \fI% xxd \-i < plik\fR
175 .I xxd \-s \+seek
176 mo¿e byæ ró¿ne od
177 .IR "xxd \-s seek" ,
178 poniewa¿ lseek(2) jest u¿yty do "przewiniêcie" wej¶cia. '+' robi
179 ró¿nicê je¶li ¼ród³em wej¶cia jest standardowe wej¶cie i je¶li pozycja
180 w pliku ze standardowego wej¶cia nie jest pocz±tkiem pliku w chwili
181 uruchomienia xxd. Nastêpuj±ce przyk³ady mog± wyja¶niæ (lub bardziej
182 zmyliæ!)...
184 Przewiñ standardowe wej¶cie przed przeczytaniem; potrzebne poniewa¿
185 `cat' ju¿ odczyta³ do koñca standardowego wej¶cia.
187 \fI% sh \-c 'cat > zwyk³a_kopia; xxd \-s 0 > hex_kopia' < plik
189 Zrzut heksowy od pozycji pliku 0x480 (=1024+128) w przód.
190 Znak `+' oznacza "wzglêdny wobec bie¿±cej pozycji", st±d `128' dodaje
191 do 1k gdzie zakoñczy³ dd.
193 \fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file
195 Zrzut heksowy od pozycji pliku 0x100 ( = 1024\-768) dalej.
197 \fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file
199 Jakkolwiek, jest to rzadka sytuacja i u¿ycie `+' jest rzadko
200 potrzebne.
201 Autor woli monitorowaæ dzia³anie xxd przy pomocy strace(1) lub truss(1) kiedy \-s jest u¿yte.
202 .SH PRZYK£ADY
205 Wypisz wszystko z wyj±tkiem pierwszych trzech linii (heksowe 0x30 bajtów)
206 .B pliku
209 \fI% xxd \-s 0x30 plik
212 Wypisz trzy linie (heksowe 0x30 bajtów) z koñca
213 .B pliku
216 \fI% xxd \-s \-0x30 plik
219 Wypisz 120 bajtów jako ci±g³y zrzut heksowy z 20 oktetami na liniê.
221 \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR
223 2e54482058584420312022417567757374203139
225 39362220224d616e75616c207061676520666f72
227 20787864220a2e5c220a2e5c222032317374204d
229 617920313939360a2e5c22204d616e2070616765
231 20617574686f723a0a2e5c2220202020546f6e79
233 204e7567656e74203c746f6e79407363746e7567
237 Zrzut heksowy z pierwszymi 120 bajtami tej strony podrêcznika z 12
238 oktetami na liniê.
240 \fI% xxd \-l 120 \-c 12 xxd.1\fR
242 0000000: 2e54 4820 5858 4420 3120 2241  .TH XXD 1 "A
244 000000c: 7567 7573 7420 3139 3936 2220  ugust 1996" 
246 0000018: 224d 616e 7561 6c20 7061 6765  "Manual page
248 0000024: 2066 6f72 2078 7864 220a 2e5c   for xxd"..\\
250 0000030: 220a 2e5c 2220 3231 7374 204d  "..\\" 21st M
252 000003c: 6179 2031 3939 360a 2e5c 2220  ay 1996..\\" 
254 0000048: 4d61 6e20 7061 6765 2061 7574  Man page aut
256 0000054: 686f 723a 0a2e 5c22 2020 2020  hor:..\\"    
258 0000060: 546f 6e79 204e 7567 656e 7420  Tony Nugent 
260 000006c: 3c74 6f6e 7940 7363 746e 7567  <tony@sctnug
263 Poka¿ tylko datê z pliku xxd.1
265 \fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
267 0000036: 3231 7374 204d 6179 2031 3939 36  21st May 1996
270 Kopiuj
271 .B plik_we
273 .B plik_wy
274 i poprzed¼ 100 bajtami o warto¶ci 0x00.
276 \fI% xxd plik_we | xxd \-r \-s 100 \> plik_wy\fR
280 Podmieñ datê w pliku xxd.1
282 \fI% echo '0000037: 3574 68' | xxd \-r \- xxd.1\fR
284 \fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
286 0000036: 3235 7468 204d 6179 2031 3939 36  25th May 1996
289 Utwórz plik o 65537 bajtach, wszystkich równych 0x00,
290 z wyj±tkiem ostatniego, który ma byæ 'A' (hex 0x41).
292 \fI% echo '010000: 41' | xxd \-r \> plik\fR
295 Zrzut heksowy tego pliku z autoskipem.
297 \fI% xxd \-a \-c 12 plik\fR
299 0000000: 0000 0000 0000 0000 0000 0000  ............
303 000fffc: 0000 0000 40                   ....A
305 Utwórz jedno bajtowy plik zawieraj±cy pojedncz± literê 'A'.
306 Liczba po '\-r \-s' dodaje numery linii znalezione w pliku;
307 w efekcie poprzedzaj±ce bajty s± ukryte.
309 \fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> plik\fR
311 U¿yj xxd jako filtra wewn±trz edytora takiego jak
312 .B vim(1)
313 aby uzyskaæ zrzut heksowy zakresu miêdzy markerami `a' i `z'.
315 \fI:'a,'z!xxd\fR
317 U¿yj xxd jako filtra wewn±trz edytora takiego jak
318 .B vim(1)
319 by odzyskaæ binarny zrzut heksowy zakresu pomiêdzy markerami `a'
320 i `z'.
322 \fI:'a,'z!xxd \-r\fR
324 U¿yj xxd jako filtra wewn±trz edytora takiego jak
325 .B vim(1)
326 by odzyskaæ jedn± liniê zrzutu heksowego. Przejd¼ z kursorem na liniê
327 i wpisz:
329 \fI!!xxd \-r\fR
331 Odczytaj pojednycze znaki z portu szeregowego
333 \fI% xxd \-c1 < /dev/term/b &\fR
335 \fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR
337 \fI% echo \-n foo > /dev/term/b\fR
339 .SH "ZWRACANE WARTO¦CI"
340 Zwracane s± nastêpuj±ce warto¶ci b³êdów:
343 nie znaleziono b³êdów.
346 operacja nie jest wspierana (
347 .I xxd \-r \-i
348 ca³y czas niemo¿liwa).
351 b³±d w czasie analizowania opcji.
354 problemy z plikiem wej¶ciowym.
357 problemy z plikiem wyj¶ciowym.
360 ¿±dana pozycja jest nieosi±galna.
361 .SH "ZOBACZ TAK¯E"
362 uuencode(1), uudecode(1), patch(1)
364 .SH OSTRZE¯ENIA
365 Dziwaczno¶æ narzêdzi dorównuje dziwaczno¶ci mózgu twórcy.
366 U¿ywaj wy³±cznie na w³asn± odpowiedzialno¶æ. Kopiuj pliki. Analizuj
367 je. Stañ siê czarodziejem.
369 .SH WERSJA
370 Strona podrêcznika opisuje xxd w wersji 1.7
371 .SH AUTOR
373 (c) 1990-1997 by Juergen Weigert
375 <jnweiger@informatik.uni-erlangen.de>
377 Kopiuj do woli i podaj moje dane,
379 zarabiaj pieni±dze i dziel siê ze mn±,
381 traæ pieni±dze i nie miej do mnie pretensji.
383 Strona podrêcznika zapocz±tkowana przez Tony'ego Nugenta
385 <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
387 Ma³e zmiany: Bram Moolenaar.
388 Redakcja: Juergen Weigert.