| blob | d9fa9be203d072ec371a791be746aa432c356ec9 |
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 lub standardowego wej¶cia.
22 Mo¿e tak¿e przetworzyæ zrzut heksowy z powrotem do oryginalnej,
23 binarnej formy.
24 Podobnie jak
25 .BR uuencode (1)
26 i
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 binarnego ³atania plików.
31 .SH OPCJE
32 Je¶li nie podano
33 .I plik_we
34 xxd czyta ze standardowego wej¶cia.
35 Je¶li okre¶lono
36 .I plik_we
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
55 i
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 jako osiem cyfr 1 lub 0 zamiast normalnego
67 zrzutu heksowego. Ka¿da linia jest poprzedzona przez
68 heksadecymalny numer linii a po nim jego reprezentacj± 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.
103 .TP
104 .IR "\-l len " | "\-len len"
105 zakoñcz po wypisaniu
106 .RI < len >
107 oktetów.
108 .TP
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.
112 .TP
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± wszêdzie dozwolone.
121 .TP
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.
128 .TP
129 .I \-s [+][\-]seek
130 zaczyna na
131 .RI < seek >
132 bajtów bezwglêdnego (lub wzglêdnego) offsetu 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: przed bie¿±c± pozycj± pliku na standardowym
137 wej¶ciu).
138 Bez opcji \-s xxd zaczyna od bie¿±cej pozycji w pliku.
139 .TP
140 .I \-u
141 u¿yj wielkich liter w znakach heksowych. Domy¶lnie s± ma³e znaki.
142 .TP
143 .IR \-v " | " \-version
144 pokazuje wersjê programu.
145 .SH OSTRZE¯ENIA
146 .PP
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.
154 .PP
155 .I xxd \-r
156 nigdy nie podaje b³êdów analizy. ¦mieci s± po cichu ignorowane.
157 .PP
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 cokolwiek
165 co wygl±da jak para znaków heks jest interpretowane.
166 .PP
167 Zauwa¿ ró¿nicê miêdzy
168 .br
169 \fI% xxd \-i plik\fR
170 .br
171 i
172 .br
173 \fI% xxd \-i < plik\fR
174 .PP
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. '+' stanowi
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æ!)...
183 .PP
184 Przewiñ standardowe wej¶cie przed przeczytaniem; potrzebne poniewa¿
185 `cat' ju¿ odczyta³ do koñca standardowego wej¶cia.
186 .br
187 \fI% sh \-c 'cat > zwyk³a_kopia; xxd \-s 0 > hex_kopia' < plik\fR
188 .PP
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.
192 .br
193 \fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file\fR
194 .PP
195 Zrzut heksowy od pozycji pliku 0x100 ( = 1024\-768) dalej.
196 .br
197 \fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file\fR
198 .PP
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
203 .PP
204 .br
205 Wypisz wszystko z wyj±tkiem pierwszych trzech linii (heksowe 0x30 bajtów)
206 .B pliku
207 \.
208 .br
209 \fI% xxd \-s 0x30 plik\fR
210 .PP
211 .br
212 Wypisz trzy linie (heksowe 0x30 bajtów) z koñca
213 .B pliku
214 \.
215 .br
216 \fI% xxd \-s \-0x30 plik\fR
217 .PP
218 .br
219 Wypisz 120 bajtów jako ci±g³y zrzut heksowy z 20 oktetami na liniê.
220 .br
221 \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR
222 .br
223 2e54482058584420312022417567757374203139
224 .br
225 39362220224d616e75616c207061676520666f72
226 .br
227 20787864220a2e5c220a2e5c222032317374204d
228 .br
229 617920313939360a2e5c22204d616e2070616765
230 .br
231 20617574686f723a0a2e5c2220202020546f6e79
232 .br
233 204e7567656e74203c746f6e79407363746e7567
234 .br
236 .br
237 Zrzut heksowy z pierwszymi 120 bajtami tej strony podrêcznika z 12
238 oktetami na liniê.
239 .br
240 \fI% xxd \-l 120 \-c 12 xxd.1\fR
241 .br
242 0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A
243 .br
244 000000c: 7567 7573 7420 3139 3936 2220 ugust 1996"
245 .br
246 0000018: 224d 616e 7561 6c20 7061 6765 "Manual page
247 .br
248 0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\
249 .br
250 0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M
251 .br
252 000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\"
253 .br
254 0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut
255 .br
256 0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\"
257 .br
258 0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent
259 .br
260 000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug
261 .PP
262 .br
263 Poka¿ tylko datê z pliku xxd.1
264 .br
265 \fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
266 .br
267 0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996
268 .PP
269 .br
270 Kopiuj
271 .B plik_we
272 do
273 .B plik_wy
274 i poprzed¼ 100 bajtami o warto¶ci 0x00.
275 .br
276 \fI% xxd plik_we | xxd \-r \-s 100 \> plik_wy\fR
277 .br
279 .br
280 Podmieñ datê w pliku xxd.1
281 .br
282 \fI% echo '0000037: 3574 68' | xxd \-r \- xxd.1\fR
283 .br
284 \fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
285 .br
286 0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996
287 .PP
288 .br
289 Utwórz plik o 65537 bajtach, wszystkich równych 0x00,
290 z wyj±tkiem ostatniego, który ma byæ 'A' (hex 0x41).
291 .br
292 \fI% echo '010000: 41' | xxd \-r \> plik\fR
293 .PP
294 .br
295 Zrzut heksowy tego pliku z autoskipem.
296 .br
297 \fI% xxd \-a \-c 12 plik\fR
298 .br
299 0000000: 0000 0000 0000 0000 0000 0000 ............
300 .br
301 *
302 .br
303 000fffc: 0000 0000 40 ....A
304 .PP
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.
308 .br
309 \fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> plik\fR
310 .PP
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'.
314 .br
315 \fI:'a,'z!xxd\fR
316 .PP
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'.
321 .br
322 \fI:'a,'z!xxd \-r\fR
323 .PP
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:
328 .br
329 \fI!!xxd \-r\fR
330 .PP
331 Odczytaj pojednycze znaki z portu szeregowego
332 .br
333 \fI% xxd \-c1 < /dev/term/b &\fR
334 .br
335 \fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR
336 .br
337 \fI% echo \-n foo > /dev/term/b\fR
338 .PP
339 .SH "ZWRACANE WARTO¦CI"
340 Zwracane s± nastêpuj±ce warto¶ci b³êdów:
341 .TP
342 0
343 nie znaleziono b³êdów.
344 .TP
345 \-1
346 operacja nie jest wspierana (
347 .I xxd \-r \-i
348 ca³y czas niemo¿liwa).
349 .TP
350 1
351 b³±d w czasie analizowania opcji.
352 .TP
353 2
354 problemy z plikiem wej¶ciowym.
355 .TP
356 3
357 problemy z plikiem wyj¶ciowym.
358 .TP
359 4,5
360 ¿±dana pozycja jest nieosi±galna.
361 .SH "ZOBACZ TAK¯E"
362 uuencode(1), uudecode(1), patch(1)
363 .br
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.
368 .br
369 .SH WERSJA
370 Strona podrêcznika opisuje xxd w wersji 1.7
371 .SH AUTOR
372 .br
373 (c) 1990-1997 by Juergen Weigert
374 .br
375 <jnweiger@informatik.uni-erlangen.de>
376 .LP
377 Kopiuj do woli i podaj moje dane,
378 .br
379 zarabiaj pieni±dze i dziel siê ze mn±,
380 .br
381 traæ pieni±dze i nie miej do mnie pretensji.
382 .PP
383 Strona podrêcznika zapocz±tkowana przez Tony'ego Nugenta
384 .br
385 <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
386 .br
387 Ma³e zmiany: Bram Moolenaar.
388 Redakcja: Juergen Weigert.
389 .PP