vim

Fork of vim, an acceptable text editor
git clone git://git.laack.co/vim.git
Log | Files | Refs | README | LICENSE

xxd-pl.1 (10407B)


      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ń \-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
    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