summaryrefslogtreecommitdiff
path: root/runtime/doc/xxd-pl.1
blob: d9fa9be203d072ec371a791be746aa432c356ec9 (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
.TH XXD 1 "Sierpień 1996" "Strona podręcznika dla xxd"
.\"
.\" 21st May 1996
.\" Man page author:
.\"    Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
.\"    Changes by Bram Moolenaar <Bram@vim.org>
.SH NAZWA
.I xxd
\- zrzut pliku do hex lub odwrotnie
.SH SYNOPSIS
.B xxd
\-h[elp]
.br
.B xxd
[opcje] [plik_we [plik_wy]]
.br
.B xxd
\-r[evert] [opcje] [plik_we [plik_wy]]
.SH OPIS
.I xxd
tworzy zrzut heksowy podanego pliku lub standardowego wejścia.
Może także przetworzyć zrzut heksowy z powrotem do oryginalnej,
binarnej formy.
Podobnie jak
.BR uuencode (1)
i
.BR uudecode (1)
pozwala na przekazanie danych binarnych w bezpiecznej w poczcie formie
ASCII, ale ma zalety dekodowania na standardowe wyjście.
Ponadto można go użyć do binarnego łatania plików.
.SH OPCJE
Jeśli nie podano
.I plik_we
xxd czyta ze standardowego wejścia.
Jeśli określono
.I plik_we
jako znak
.RB \` \- '
wtedy dane wejściowe czytane są ze standardowego wejścia.
Jeśli nie podano
.I plik_wy
(lub podano jako
.RB \` \- '
), wyniki są wysyłane na standardowe wyjście.
.PP
Pamiętaj, że użyty został "leniwy" parser, który nie sprawdza więcej
niż pierwszej litery opcji (o ile ta nie została obdarzona
parametrem). Spacje między jedno literowymi opcjami i ich parametrami
są opcjonalne. Parametry opcji mogą być określone w notacji dziesiętnej,
heksadecymalej lub oktalnej.
Stąd
.BR \-c8 ,
.BR "\-c 8" ,
.B \-c 010
i
.B \-cols 8
są sobie równoważne.
.PP
.TP
.IR \-a " | " \-autoskip
przełącza autoskip: pojedyncza '*' zastępuje linie nul. Domyślnie
wyłączone.
.TP
.IR \-b " | " \-bits
Przełącza do zrzutu bitowego (cyfr binarnych) zamiast heksowego.
Opcja ta zapisuje oktety jako osiem cyfr 1 lub 0 zamiast normalnego
zrzutu heksowego. Każda linia jest poprzedzona przez
heksadecymalny numer linii a po nim jego reprezentacją w ascii (lub
ebcdic). Opcje linii poleceń \-r, \-p, \-i nie działają w tym
trybie.
.TP
.IR "\-c cols " | " \-cols cols"
formatuje liczbę
.RI < cols >
oktetów na wiersz. Domyślnie 16 (\-i: 12, \-ps: 30, \-b: 6). Maks.
256.
.TP
.IR \-E " | "\-EBCDIC
zmienia kodowanie znaków w prawej kolumnie z ASCII na EBCDIC.
Nie zmienia prezentacji heksadecymalej. Opcja nie działa w połączeniu
z \-r, \-p lub \-i.
.TP
.IR "\-g bajtów " | " \-groupsize bajtów"
oddziela wyjście każdych
.RI < bajtów >
bajtów (dwa heksowe znaki lub osiem cyfr binarnych każde) przez biały
znak.
Określ
.I \-g 0
by wyłączyć grupowanie.
.RI < Bajtów "> domyślnie jest " 2
w trybie normalnym i \fI1\fP w trybie bitów.
Grupowanie nie działa w trybie postscriptu lub włączania.
.TP
.IR \-h " | " \-help
wypisuje podsumowanie dostępnych poleceń i kończy działanie. Nie
zostaje przeprowadzony żaden zrzut.
.TP
.IR \-i " | " \-include
wyjście w stylu włączania pliku w C. Zostaje zapisana kompletna
statyczna tablica definicji (nazwana według pliku wejścia), o ile xxd
nie czyta ze standardowego wejścia.
.TP
.IR "\-l len " | "\-len len"
zakończ po wypisaniu
.RI < len >
oktetów.
.TP
.IR \-p " | " \-ps " | " \-postscript " | " \-plain
wyjście w postcriptowym ciągłym stylu zrzutu heksowego. Znany także
jako zwykły zrzut heksowy.
.TP
.IR \-r " | " \-revert
odwróć operację: przekonwertuj (lub załataj) zrzut heksowy w binarkę.
Jeśli nie zapisuje na standardowe wyjście, xxd zapisze plik wyjściowy
bez obcinania go. Użyj kombinacji
.I \-r \-p
by odczytać zwykły zrzut heksadecymalny bez numerów linii
i określonego układu kolumn. Dodatkowe białe znaki i łamanie wierszy
są wszędzie dozwolone.
.TP
.I \-seek offset
Kiedy użyty po
.IR \-r :
odwraca z
.RI < offset >
dodanym do pozycji w pliku odnalezionym w zrzucie heksowym.
.TP
.I \-s [+][\-]seek
zaczyna na
.RI < seek >
bajtów bezwględnego (lub względnego) offsetu pliku wejściowego.
\fI+ \fRwskazuje, że seek jest względne do bieżącej pozycji pliku (bez
znaczenia jeśli nie wczytuje ze standardowego wejścia). \fI\- \fRwskazuje
że seek powinno być o tyle znaków od końca wejścia (lub jeśli
połączone z \fI+\fR: przed bieżącą pozycją pliku na standardowym
wejściu).
Bez opcji \-s xxd zaczyna od bieżącej pozycji w pliku.
.TP
.I \-u
użyj wielkich liter w znakach heksowych. Domyślnie są małe znaki.
.TP
.IR \-v " | " \-version
pokazuje wersję programu.
.SH OSTRZEŻENIA
.PP
.I xxd \-r
potrafi określić numery linii. Jeśli plik wyjścia jest możliwy do
przeszukania wtedy numery linii na początku wiersza zrzutu heksowego
mogą być nie po kolei, może brakować wierszy lub nakładać się na
siebie. W takich wypadkach xxd użyje lseek(2) by znaleźć następną
pozycję. Jeśli plik wyjściowy nie jest możliwy do przeszukania możliwe
są tylko przerwy, które zostaną wypełnione bajtami null.
.PP
.I xxd \-r
nigdy nie podaje błędów analizy. Śmieci są po cichu ignorowane.
.PP
W czasie edycji zrzutów heksowych, proszę zauważyć że
.I xxd \-r
pomija wszystko w linii wejścia po odczytaniu wystarczającej ilości
kolumn danych heksadecymalnych (zobacz opcję \-c). Oznacza to także,
że zmiany w drukowanych kolumnach ascii (lub ebcdic) są zawsze
ignorowane. Odwrócenie zwykłego (lub postscriptowego) stylu zrzutu
poprzez xxd \-r \-p nie zależy od kolejności kolumn. Tutaj cokolwiek
co wygląda jak para znaków heks jest interpretowane.
.PP
Zauważ różnicę między
.br
\fI% xxd \-i plik\fR
.br
i
.br
\fI% xxd \-i < plik\fR
.PP
.I xxd \-s \+seek
może być różne od
.IR "xxd \-s seek" ,
ponieważ lseek(2) jest użyty do "przewinięcie" wejścia. '+' stanowi
różnicę jeśli źródłem wejścia jest standardowe wejście i jeśli pozycja
w pliku ze standardowego wejścia nie jest początkiem pliku w chwili
uruchomienia xxd. Następujące przykłady mogą wyjaśnić (lub bardziej
zmylić!)...
.PP
Przewiń standardowe wejście przed przeczytaniem; potrzebne ponieważ
`cat' już odczytał do końca standardowego wejścia.
.br
\fI% sh \-c 'cat > zwykła_kopia; xxd \-s 0 > hex_kopia' < plik\fR
.PP
Zrzut heksowy od pozycji pliku 0x480 (=1024+128) w przód.
Znak `+' oznacza "względny wobec bieżącej pozycji", stąd `128' dodaje
do 1k gdzie zakończył dd.
.br
\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file\fR
.PP
Zrzut heksowy od pozycji pliku 0x100 ( = 1024\-768) dalej.
.br
\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file\fR
.PP
Jakkolwiek, jest to rzadka sytuacja i użycie `+' jest rzadko
potrzebne.
Autor woli monitorować działanie xxd przy pomocy strace(1) lub truss(1) kiedy \-s jest użyte.
.SH PRZYKŁADY
.PP
.br
Wypisz wszystko z wyjątkiem pierwszych trzech linii (heksowe 0x30 bajtów)
.B pliku
\.
.br
\fI% xxd \-s 0x30 plik\fR
.PP
.br
Wypisz trzy linie (heksowe 0x30 bajtów) z końca
.B pliku
\.
.br
\fI% xxd \-s \-0x30 plik\fR
.PP
.br
Wypisz 120 bajtów jako ciągły zrzut heksowy z 20 oktetami na linię.
.br
\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR
.br
2e54482058584420312022417567757374203139
.br
39362220224d616e75616c207061676520666f72
.br
20787864220a2e5c220a2e5c222032317374204d
.br
617920313939360a2e5c22204d616e2070616765
.br
20617574686f723a0a2e5c2220202020546f6e79
.br
204e7567656e74203c746f6e79407363746e7567
.br

.br
Zrzut heksowy z pierwszymi 120 bajtami tej strony podręcznika z 12
oktetami na linię.
.br
\fI% xxd \-l 120 \-c 12 xxd.1\fR
.br
0000000: 2e54 4820 5858 4420 3120 2241  .TH XXD 1 "A
.br
000000c: 7567 7573 7420 3139 3936 2220  ugust 1996" 
.br
0000018: 224d 616e 7561 6c20 7061 6765  "Manual page
.br
0000024: 2066 6f72 2078 7864 220a 2e5c   for xxd"..\\
.br
0000030: 220a 2e5c 2220 3231 7374 204d  "..\\" 21st M
.br
000003c: 6179 2031 3939 360a 2e5c 2220  ay 1996..\\" 
.br
0000048: 4d61 6e20 7061 6765 2061 7574  Man page aut
.br
0000054: 686f 723a 0a2e 5c22 2020 2020  hor:..\\"    
.br
0000060: 546f 6e79 204e 7567 656e 7420  Tony Nugent 
.br
000006c: 3c74 6f6e 7940 7363 746e 7567  <tony@sctnug
.PP
.br
Pokaż tylko datę z pliku xxd.1
.br
\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
.br
0000036: 3231 7374 204d 6179 2031 3939 36  21st May 1996
.PP
.br
Kopiuj
.B plik_we
do
.B plik_wy
i poprzedź 100 bajtami o wartości 0x00.
.br
\fI% xxd plik_we | xxd \-r \-s 100 \> plik_wy\fR
.br

.br
Podmień datę w pliku xxd.1
.br
\fI% echo '0000037: 3574 68' | xxd \-r \- xxd.1\fR
.br
\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
.br
0000036: 3235 7468 204d 6179 2031 3939 36  25th May 1996
.PP
.br
Utwórz plik o 65537 bajtach, wszystkich równych 0x00,
z wyjątkiem ostatniego, który ma być 'A' (hex 0x41).
.br
\fI% echo '010000: 41' | xxd \-r \> plik\fR
.PP
.br
Zrzut heksowy tego pliku z autoskipem.
.br
\fI% xxd \-a \-c 12 plik\fR
.br
0000000: 0000 0000 0000 0000 0000 0000  ............
.br
*
.br
000fffc: 0000 0000 40                   ....A
.PP
Utwórz jedno bajtowy plik zawierający pojednczą literę 'A'.
Liczba po '\-r \-s' dodaje numery linii znalezione w pliku;
w efekcie poprzedzające bajty są ukryte.
.br
\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> plik\fR
.PP
Użyj xxd jako filtra wewnątrz edytora takiego jak
.B vim(1)
aby uzyskać zrzut heksowy zakresu między markerami `a' i `z'.
.br
\fI:'a,'z!xxd\fR
.PP
Użyj xxd jako filtra wewnątrz edytora takiego jak
.B vim(1)
by odzyskać binarny zrzut heksowy zakresu pomiędzy markerami `a'
i `z'.
.br
\fI:'a,'z!xxd \-r\fR
.PP
Użyj xxd jako filtra wewnątrz edytora takiego jak
.B vim(1)
by odzyskać jedną linię zrzutu heksowego. Przejdź z kursorem na linię
i wpisz:
.br
\fI!!xxd \-r\fR
.PP
Odczytaj pojednycze znaki z portu szeregowego
.br
\fI% xxd \-c1 < /dev/term/b &\fR
.br
\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR
.br
\fI% echo \-n foo > /dev/term/b\fR
.PP
.SH "ZWRACANE WARTOŚCI"
Zwracane są następujące wartości błędów:
.TP
0
nie znaleziono błędów.
.TP
\-1
operacja nie jest wspierana (
.I xxd \-r \-i
cały czas niemożliwa).
.TP
1
błąd w czasie analizowania opcji.
.TP
2
problemy z plikiem wejściowym.
.TP
3
problemy z plikiem wyjściowym.
.TP
4,5
żądana pozycja jest nieosiągalna.
.SH "ZOBACZ TAKŻE"
uuencode(1), uudecode(1), patch(1)
.br
.SH OSTRZEŻENIA
Dziwaczność narzędzi dorównuje dziwaczności mózgu twórcy.
Używaj wyłącznie na własną odpowiedzialność. Kopiuj pliki. Analizuj
je. Stań się czarodziejem.
.br
.SH WERSJA
Strona podręcznika opisuje xxd w wersji 1.7
.SH AUTOR
.br
(c) 1990-1997 by Juergen Weigert
.br
<jnweiger@informatik.uni-erlangen.de>
.LP
Kopiuj do woli i podaj moje dane,
.br
zarabiaj pieniądze i dziel się ze mną,
.br
trać pieniądze i nie miej do mnie pretensji.
.PP
Strona podręcznika zapoczątkowana przez Tony'ego Nugenta
.br
<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
.br
Małe zmiany: Bram Moolenaar.
Redakcja: Juergen Weigert.
.PP