diff options
Diffstat (limited to 'runtime/doc/xxd-pl.1')
-rw-r--r-- | runtime/doc/xxd-pl.1 | 389 |
1 files changed, 0 insertions, 389 deletions
diff --git a/runtime/doc/xxd-pl.1 b/runtime/doc/xxd-pl.1 deleted file mode 100644 index d9fa9be203..0000000000 --- a/runtime/doc/xxd-pl.1 +++ /dev/null @@ -1,389 +0,0 @@ -.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 |