.TH XXD 1 "Sierpie 1996" "Strona podrcznika 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 wejcia.
Moe take 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 wyjcie.
Ponadto mona go uy do binarnego atania plikw.
.SH OPCJE
Jeli nie podano
.I plik_we
xxd czyta ze standardowego wejcia.
Jeli okrelono
.I plik_we
jako znak
.RB \` \- '
wtedy dane wejciowe czytane s ze standardowego wejcia.
Jeli nie podano
.I plik_wy
(lub podano jako
.RB \` \- '
), wyniki s wysyane na standardowe wyjcie.
.PP
Pamitaj, e uyty zosta "leniwy" parser, ktry nie sprawdza wicej
ni pierwszej litery opcji (o ile ta nie zostaa obdarzona
parametrem). Spacje midzy jedno literowymi opcjami i ich parametrami
s opcjonalne. Parametry opcji mog by okrelone w notacji dziesitnej,
heksadecymalej lub oktalnej.
Std
.BR \-c8 ,
.BR "\-c 8" ,
.B \-c 010
i
.B \-cols 8
s sobie rwnowane.
.PP
.TP
.IR \-a " | " \-autoskip
przecza autoskip: pojedyncza '*' zastpuje linie nul. Domylnie
wyczone.
.TP
.IR \-b " | " \-bits
Przecza do zrzutu bitowego (cyfr binarnych) zamiast heksowego.
Opcja ta zapisuje oktety jako osiem cyfr 1 lub 0 zamiast normalnego
zrzutu heksowego. Kada linia jest poprzedzona przez
heksadecymalny numer linii a po nim jego reprezentacj w ascii (lub
ebcdic). Opcje linii polece \-r, \-p, \-i nie dziaaj w tym
trybie.
.TP
.IR "\-c cols " | " \-cols cols"
formatuje liczb
.RI < cols >
oktetw na wiersz. Domylnie 16 (\-i: 12, \-ps: 30, \-b: 6). Maks.
256.
.TP
.IR \-E " | "\-EBCDIC
zmienia kodowanie znakw w prawej kolumnie z ASCII na EBCDIC.
Nie zmienia prezentacji heksadecymalej. Opcja nie dziaa w poczeniu
z \-r, \-p lub \-i.
.TP
.IR "\-g bajtw " | " \-groupsize bajtw"
oddziela wyjcie kadych
.RI < bajtw >
bajtw (dwa heksowe znaki lub osiem cyfr binarnych kade) przez biay
znak.
Okrel
.I \-g 0
by wyczy grupowanie.
.RI < Bajtw "> domylnie jest " 2
w trybie normalnym i \fI1\fP w trybie bitw.
Grupowanie nie dziaa w trybie postscriptu lub wczania.
.TP
.IR \-h " | " \-help
wypisuje podsumowanie dostpnych polece i koczy dziaanie. Nie
zostaje przeprowadzony aden zrzut.
.TP
.IR \-i " | " \-include
wyjcie w stylu wczania pliku w C. Zostaje zapisana kompletna
statyczna tablica definicji (nazwana wedug pliku wejcia), o ile xxd
nie czyta ze standardowego wejcia.
.TP
.IR "\-l len " | "\-len len"
zakocz po wypisaniu
.RI < len >
oktetw.
.TP
.IR \-p " | " \-ps " | " \-postscript " | " \-plain
wyjcie w postcriptowym cigym stylu zrzutu heksowego. Znany take
jako zwyky zrzut heksowy.
.TP
.IR \-r " | " \-revert
odwr operacj: przekonwertuj (lub zaataj) zrzut heksowy w binark.
Jeli nie zapisuje na standardowe wyjcie, xxd zapisze plik wyjciowy
bez obcinania go. Uyj kombinacji
.I \-r \-p
by odczyta zwyky zrzut heksadecymalny bez numerw linii
i okrelonego ukadu kolumn. Dodatkowe biae znaki i amanie wierszy
s wszdzie dozwolone.
.TP
.I \-seek offset
Kiedy uyty po
.IR \-r :
odwraca z
.RI < offset >
dodanym do pozycji w pliku odnalezionym w zrzucie heksowym.
.TP
.I \-s [+][\-]seek
zaczyna na
.RI < seek >
bajtw bezwgldnego (lub wzgldnego) offsetu pliku wejciowego.
\fI+ \fRwskazuje, e seek jest wzgldne do biecej pozycji pliku (bez
znaczenia jeli nie wczytuje ze standardowego wejcia). \fI\- \fRwskazuje
e seek powinno by o tyle znakw od koca wejcia (lub jeli
poczone z \fI+\fR: przed biec pozycj pliku na standardowym
wejciu).
Bez opcji \-s xxd zaczyna od biecej pozycji w pliku.
.TP
.I \-u
uyj wielkich liter w znakach heksowych. Domylnie s mae znaki.
.TP
.IR \-v " | " \-version
pokazuje wersj programu.
.SH OSTRZEENIA
.PP
.I xxd \-r
potrafi okreli numery linii. Jeli plik wyjcia jest moliwy do
przeszukania wtedy numery linii na pocztku wiersza zrzutu heksowego
mog by nie po kolei, moe brakowa wierszy lub nakada si na
siebie. W takich wypadkach xxd uyje lseek(2) by znale nastpn
pozycj. Jeli plik wyjciowy nie jest moliwy do przeszukania moliwe
s tylko przerwy, ktre zostan wypenione bajtami null.
.PP
.I xxd \-r
nigdy nie podaje bdw analizy. mieci s po cichu ignorowane.
.PP
W czasie edycji zrzutw heksowych, prosz zauway e
.I xxd \-r
pomija wszystko w linii wejcia po odczytaniu wystarczajcej iloci
kolumn danych heksadecymalnych (zobacz opcj \-c). Oznacza to take,
e zmiany w drukowanych kolumnach ascii (lub ebcdic) s zawsze
ignorowane. Odwrcenie zwykego (lub postscriptowego) stylu zrzutu
poprzez xxd \-r \-p nie zaley od kolejnoci kolumn. Tutaj cokolwiek
co wyglda jak para znakw heks jest interpretowane.
.PP
Zauwa rnic midzy
.br
\fI% xxd \-i plik\fR
.br
i
.br
\fI% xxd \-i < plik\fR
.PP
.I xxd \-s \+seek
moe by rne od
.IR "xxd \-s seek" ,
poniewa lseek(2) jest uyty do "przewinicie" wejcia. '+' stanowi
rnic jeli rdem wejcia jest standardowe wejcie i jeli pozycja
w pliku ze standardowego wejcia nie jest pocztkiem pliku w chwili
uruchomienia xxd. Nastpujce przykady mog wyjani (lub bardziej
zmyli!)...
.PP
Przewi standardowe wejcie przed przeczytaniem; potrzebne poniewa
`cat' ju odczyta do koca standardowego wejcia.
.br
\fI% sh \-c 'cat > zwyka_kopia; xxd \-s 0 > hex_kopia' < plik\fR
.PP
Zrzut heksowy od pozycji pliku 0x480 (=1024+128) w przd.
Znak `+' oznacza "wzgldny wobec biecej pozycji", std `128' dodaje
do 1k gdzie zakoczy 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 uycie `+' jest rzadko
potrzebne.
Autor woli monitorowa dziaanie xxd przy pomocy strace(1) lub truss(1) kiedy \-s jest uyte.
.SH PRZYKADY
.PP
.br
Wypisz wszystko z wyjtkiem pierwszych trzech linii (heksowe 0x30 bajtw)
.B pliku
\.
.br
\fI% xxd \-s 0x30 plik\fR
.PP
.br
Wypisz trzy linie (heksowe 0x30 bajtw) z koca
.B pliku
\.
.br
\fI% xxd \-s \-0x30 plik\fR
.PP
.br
Wypisz 120 bajtw jako cigy 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 podrcznika 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 wartoci 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
Utwrz plik o 65537 bajtach, wszystkich rwnych 0x00,
z wyjtkiem ostatniego, ktry 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
Utwrz jedno bajtowy plik zawierajcy pojedncz liter 'A'.
Liczba po '\-r \-s' dodaje numery linii znalezione w pliku;
w efekcie poprzedzajce bajty s ukryte.
.br
\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> plik\fR
.PP
Uyj xxd jako filtra wewntrz edytora takiego jak
.B vim(1)
aby uzyska zrzut heksowy zakresu midzy markerami `a' i `z'.
.br
\fI:'a,'z!xxd\fR
.PP
Uyj xxd jako filtra wewntrz edytora takiego jak
.B vim(1)
by odzyska binarny zrzut heksowy zakresu pomidzy markerami `a'
i `z'.
.br
\fI:'a,'z!xxd \-r\fR
.PP
Uyj xxd jako filtra wewntrz 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 WARTOCI"
Zwracane s nastpujce wartoci bdw:
.TP
0
nie znaleziono bdw.
.TP
\-1
operacja nie jest wspierana (
.I xxd \-r \-i
cay czas niemoliwa).
.TP
1
bd w czasie analizowania opcji.
.TP
2
problemy z plikiem wejciowym.
.TP
3
problemy z plikiem wyjciowym.
.TP
4,5
dana pozycja jest nieosigalna.
.SH "ZOBACZ TAKE"
uuencode(1), uudecode(1), patch(1)
.br
.SH OSTRZEENIA
Dziwaczno narzdzi dorwnuje dziwacznoci mzgu twrcy.
Uywaj wycznie na wasn odpowiedzialno. Kopiuj pliki. Analizuj
je. Sta si czarodziejem.
.br
.SH WERSJA
Strona podrcznika 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 pienidze i dziel si ze mn,
.br
tra pienidze i nie miej do mnie pretensji.
.PP
Strona podrcznika zapocztkowana przez Tony'ego Nugenta
.br
<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
.br
Mae zmiany: Bram Moolenaar.
Redakcja: Juergen Weigert.
.PP