Mercurial > vim
annotate runtime/doc/xxd-pl.1 @ 20915:a3853794a768 v8.2.1009
patch 8.2.1009: Vim9: some failures not checked for
Commit: https://github.com/vim/vim/commit/c5b1c20b6b1968873ea31edac1db659773b3b93d
Author: Bram Moolenaar <Bram@vim.org>
Date: Thu Jun 18 22:43:27 2020 +0200
patch 8.2.1009: Vim9: some failures not checked for
Problem: Vim9: some failures not checked for.
Solution: Add test cases. Remove unused code.
| author | Bram Moolenaar <Bram@vim.org> |
|---|---|
| date | Thu, 18 Jun 2020 22:45:03 +0200 |
| parents | de5a43c5eedc |
| children | 33cbd544dc46 |
| rev | line source |
|---|---|
| 809 | 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 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
21 tworzy zrzut heksowy podanego pliku lub standardowego wejścia. |
| 809 | 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. | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
30 Ponadto można go użyć do binarnego łatania plików. |
| 809 | 31 .SH OPCJE |
| 32 Jeśli nie podano | |
| 33 .I plik_we | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
34 xxd czyta ze standardowego wejścia. |
| 809 | 35 Jeśli określono |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
36 .I plik_we |
| 809 | 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. | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
66 Opcja ta zapisuje oktety jako osiem cyfr 1 lub 0 zamiast normalnego |
| 809 | 67 zrzutu heksowego. Każda linia jest poprzedzona przez |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
68 heksadecymalny numer linii a po nim jego reprezentacją w ascii (lub |
| 809 | 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 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
106 .RI < len > |
| 809 | 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 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
120 są wszędzie dozwolone. |
| 809 | 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 > | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
132 bajtów bezwględnego (lub względnego) offsetu pliku wejściowego. |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
133 \fI+ \fRwskazuje, że seek jest względne do bieżącej pozycji pliku (bez |
| 809 | 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 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
136 połączone z \fI+\fR: przed bieżącą pozycją pliku na standardowym |
| 809 | 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 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
156 nigdy nie podaje błędów analizy. Śmieci są po cichu ignorowane. |
| 809 | 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 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
164 poprzez xxd \-r \-p nie zależy od kolejności kolumn. Tutaj cokolwiek |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
165 co wygląda jak para znaków heks jest interpretowane. |
| 809 | 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" , | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
178 ponieważ lseek(2) jest użyty do "przewinięcie" wejścia. '+' stanowi |
| 809 | 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 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
187 \fI% sh \-c 'cat > zwykła_kopia; xxd \-s 0 > hex_kopia' < plik\fR |
| 809 | 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 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
193 \fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file\fR |
| 809 | 194 .PP |
| 195 Zrzut heksowy od pozycji pliku 0x100 ( = 1024\-768) dalej. | |
| 196 .br | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
197 \fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file\fR |
| 809 | 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 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
209 \fI% xxd \-s 0x30 plik\fR |
| 809 | 210 .PP |
| 211 .br | |
| 212 Wypisz trzy linie (heksowe 0x30 bajtów) z końca | |
| 213 .B pliku | |
| 214 \. | |
| 215 .br | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1120
diff
changeset
|
216 \fI% xxd \-s \-0x30 plik\fR |
| 809 | 217 .PP |
| 218 .br | |
| 1120 | 219 Wypisz 120 bajtów jako ciągły zrzut heksowy z 20 oktetami na linię. |
| 809 | 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 | |
| 235 | |
| 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 | |
| 278 | |
| 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 |