'\" t
.\"     Title: hexdump
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-04-09
.\"    Manual: Polecenia użytkownika
.\"    Source: util-linux 2.41
.\"  Language: English
.\"
.TH "HEXDUMP" "1" "2025-04-09" "util\-linux 2.41" "Polecenia użytkownika"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAZWA"
hexdump \- zrzuca zawartość pliku szesnastkowo, dziesiętnie, ósemkowo lub w ascii
.SH "SKŁADNIA"
.sp
\fBhexdump\fP \fIopcje plik\fP ...
.sp
\fBhd\fP \fIopcje plik\fP ...
.SH "OPIS"
.sp
Narzędzie \fBhexdump\fP jest filtrem, który wyświetla podane pliki \- lub standardowe wejście, jeśli nie podano plików \- używając do tego celu podanego przez użytkownika formatu.
.SH "OPCJE"
.sp
Poniżej, po argumentach \fIrozmiar\fP i \fIprzesunięcie\fP mogą występować przyrostki binarne (2^N): KiB (=1024), MiB (=1024*1024) i tak dalej dla GiB, TiB, PiB, EiB, ZiB oraz YiB (część "iB" jest opcjonalna, na przykład "K" ma to samo znaczenie, co "KiB") lub dziesiętne (10^N): KB (=1000), MB (=1000*1000) i podobnie dla GB, TB, PB, EB, ZB oraz YB.
.sp
\fB\-b\fP, \fB\-\-one\-byte\-octal\fP
.RS 4
\fIJednobajtowe wyświetlanie ósemkowe\fP. Wyświetla szesnastkowo przesunięcie wejściowe, a za nim szesnaście trójkolumnowych, oddzielonych spacjami, uzupełnionych zerami bajtów wejściowych w formacie ósemkowym, na wiersz.
.RE
.sp
\fB\-X\fP, \fB\-\-one\-byte\-hex\fP
.RS 4
\fIJednobajtowe wyświetlanie szesnastkowe\fP. Wyświetla szesnastkowo przesunięcie wejściowe, a za nim szesnaście dwukolumnowych, oddzielonych spacjami, uzupełnionych zerami bajtów wejściowych w formacie szesnastkowym, na wiersz.
.RE
.sp
\fB\-c\fP, \fB\-\-one\-byte\-char\fP
.RS 4
\fIJednobajtowe wyświetlanie znakowe\fP. Wyświetla szesnastkowo przesunięcie wejściowe, a za nim szesnaście, trójkolumnowych, oddzielonych spacjami znaków wejściowych, na wiersz.
.RE
.sp
\fB\-C\fP, \fB\-\-canonical\fP
.RS 4
\fITradycyjne wyświetlanie szesnastkowe+ASCII\fP. Wyświetla szesnastkowo przesunięcie wejściowe, a za nim szesnaście dwukolumnowych, oddzielonych spacjami, bajtów w formacie ósemkowym; po których występuje tych samych szesnaście bajtów w formacie \fB%_p\fP ujętym znakami \fB|\fP. Wywołanie programu jako \fBhd\fP wymusza tę opcję.
.RE
.sp
\fB\-d\fP, \fB\-\-two\-bytes\-decimal\fP
.RS 4
\fIDwubajtowe wyświetlanie dziesiętne\fP. Wyświetla szesnastkowo przesunięcie wejściowe, a za nim osiem pięciokolumnowych, oddzielonych spacjami, uzupełnionych zerami jednostek dwubajtowych, zawierających dane wejściowe, w formacie dziesiętnym, na wiersz.
.RE
.sp
\fB\-e\fP, \fB\-\-format\fP \fIłańcuch\-formatu\fP
.RS 4
Określa łańcuch formatu, który ma posłużyć do wyświetlania danych.
.RE
.sp
\fB\-f\fP, \fB\-\-format\-file\fP \fIplik\fP
.RS 4
Podaje plik, który zawiera jeden, lub więcej, oddzielonych nowym wierszem łańcuchów formatujących. Puste wiersze oraz wiersze zaczynające się od kratki (#) są ignorowane.
.RE
.sp
\fB\-L\fP, \fB\-\-color\fP[\fB=\fP\fIkiedy\fP]
.RS 4
Koloryzuje wynik. Opcjonalnym argumentem \fIkiedy\fP może być \fBauto\fP, \fBnever\fP (nigdy) lub \fBalways\fP (zawsze). Gdy nie poda się argumentu \fIkiedy\fP, domyślnym ustawieniem jest \fBauto\fP. Kolory mogą być wyłączone, aktualne wbudowane ustawienie domyślne pokaże opcja \fB\-\-help\fP. Zob. również podrozdział \fBKolory\fP oraz rozdział \fBKOLORY\fP poniżej.
.RE
.sp
\fB\-n\fP, \fB\-\-length\fP \fIdługość\fP
.RS 4
Interpretuje tylko \fIdługość\fP bajtów wejścia.
.RE
.sp
\fB\-o\fP, \fB\-\-two\-bytes\-octal\fP
.RS 4
\fIDwubajtowe wyświetlanie ósemkowe\fP. Wyświetla szesnastkowo przesunięcie wejściowe, a za nim osiem sześciokolumnowych, oddzielonych spacjami, uzupełnionych zerami, dwubajtowych fragmentów danych wejściowych, w formacie ósemkowym, na wiersz.
.RE
.sp
\fB\-s\fP, \fB\-\-skip\fP \fIprzesunięcie\fP
.RS 4
Pomija \fIprzesunięcie\fP bajtów, licząc od początku wejścia.
.RE
.sp
\fB\-v\fP, \fB\-\-no\-squeezing\fP
.RS 4
Opcja \fB\-v\fP powoduje wyświetlenie przez \fBhexdump\fP zrzutu wszystkich danych wejściowych. Bez opcji \fB\-v\fP, dowolna liczba grup wierszy wyjściowych, która będzie identyczna z bezpośrednio poprzedzającą grupą wierszy (poza przesunięciami wejściowymi), będzie zamieniana wierszem z pojedynczą gwiazdką.
.RE
.sp
\fB\-x\fP, \fB\-\-two\-bytes\-hex\fP
.RS 4
\fIDwubajtowe wyświetlanie szesnastkowe\fP. Wyświetla szesnastkowo przesunięcie wejściowe, a za nim osiem oddzielonych spacjami, czterokolumnowych, uzupełnionych zerami, dwubajtowych fragmentów danych wejściowych, w formacie szesnastkowym, na wiersz.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.sp
Dla każdego pliku wejściowego \fBhexdump\fP kopiuje sekwencyjnie dane wejściowe na standardowe wyjście, przekształcając dane według łańcuchów formatujących, podanych w opcjach \fB\-e\fP i \fB\-f\fP, w kolejności, w jakiej były podane.
.SH "FORMATY"
.sp
Łańcuch formatujący składa się z dowolnej ilości jednostek formatujących, oddzielonych białą spacją. Jednostka formatująca składa się z maksymalnie trzech elementów: licznika iteracji, licznika bajtów i formatu.
.sp
Licznik iteracji jest opcjonalną dodatnią liczbą całkowitą, której wartość domyślna to jeden. Każdy format jest załączany tyle razy, ile wskazano w liczniku iteracji.
.sp
Licznik bajtów jest opcjonalną dodatnią liczbą całkowitą. Jeśli zostanie podana, to definiuje liczbę bajtów, które należy zinterpretować w każdej iteracji formatu.
.sp
Jeśli podano licznik iteracji i/lub bajtów, to po liczniku iteracji i/lub przed licznikiem bajtów trzeba umieścić ukośnik, aby móc je rozróżnić. Białe spacje przed i za ukośnikiem są ignorowane.
.sp
Format jest częścią wymaganą i musi być ujęty w podwójne cudzysłowy (" "). Jest on interpretowany jak łańcuch formatujący fprintf (zob. \fBfprintf\fP(3)), lecz z następującymi wyjątkami:
.sp
1.
.RS 4
Gwiazdka (*) nie może być używana do określania precyzji lub szerokości pola.
.RE
.sp
2.
.RS 4
Liczba bajtów lub dokładność pola \fIjest\fP wymagana dla każdego znaku konwersji \fBs\fP (w przeciwieństwie do \fBfprintf\fP(3) gdzie domyślnie, bez podanej precyzji, drukowany jest cały łańcuch).
.RE
.sp
3.
.RS 4
Znaki konwersji \fBh\fP, \fBl\fP, \fBn\fP, \fBp\fP i \fBq\fP nie są obsługiwane.
.RE
.sp
4.
.RS 4
Obsługiwane są następujące sekwencje specjalne pojedynczych znaków, opisane w standardzie C:
.RE
.RS 3
.ll -.6i
.TS
allbox tab(:);
lt lt.
T{
.sp
NULL
T}:T{
.sp
\(rs0
T}
T{
.sp
<alarm>
T}:T{
.sp
\(rsa
T}
T{
.sp
<backspace>
T}:T{
.sp
\(rsb
T}
T{
.sp
<wysuw\-strony>
T}:T{
.sp
\(rsf
T}
T{
.sp
<nowy\-wiersz>
T}:T{
.sp
\(rsn
T}
T{
.sp
<powrót\-karetki>
T}:T{
.sp
\(rsr
T}
T{
.sp
<tabulator>
T}:T{
.sp
\(rst
T}
T{
.sp
<tabulator\-pionowy>
T}:T{
.sp
\(rsv
T}
.TE
.sp
.br
.RE
.ll
.SS "Łańcuchy konwersji"
.sp
Polecenie \fBhexdump\fP obsługuje również następujące dodatkowe łańcuchy konwersji:
.sp
\fB_a[dox]\fP
.RS 4
Wyświetla przesunięcie wejścia, kumulujące się na przestrzeni plików wejściowych, wskazujące następny wyświetlany bajt. Dodane znaki \fBd\fP, \fBo\fP, i \fBx\fP wskazują format wyświetlenia jako dziesiętny, ósemkowy lub szesnastkowy.
.RE
.sp
\fB_A[dox]\fP
.RS 4
Identyczne z łańcuchem konwersji \fB_a\fP z tą tylko różnicą, że jest dokonywane tylko raz, po przetworzeniu wszystkich danych wejściowych.
.RE
.sp
\fB_c\fP
.RS 4
Wypisuje znaki z domyślnego zestawu znaków. Znaki niedrukowalne są wyświetlane w trójznakowych, uzupełnionych zerami sekwencjach ósemkowych, poza tymi, które są reprezentowane standardową notacją specjalną (zob. wyżej) \- te są wyświetlane jako łańcuchy dwuznakowe.
.RE
.sp
\fB_p\fP
.RS 4
Wypisuje znaki z domyślnego zestawu znaków. Niedrukowane znaki są wyświetlane jako pojedyncza kropka "\fB.\fP".
.RE
.sp
\fB_u\fP
.RS 4
Wyświetla znaki US ASCII, z wyjątkiem znaków sterujących, które są wyświetlane za pomocą następujących nazw, pisanych małymi literami. Znaki większe niż szesnastkowe 0xff, są wyświetlane jako łańcuchy szesnastkowe.
.RE
.RS 3
.ll -.6i
.TS
allbox tab(:);
lt lt lt lt lt lt.
T{
.sp
000 nul
T}:T{
.sp
001 soh
T}:T{
.sp
002 stx
T}:T{
.sp
003 etx
T}:T{
.sp
004 eot
T}:T{
.sp
005 enq
T}
T{
.sp
006 ack
T}:T{
.sp
007 bel
T}:T{
.sp
008 bs
T}:T{
.sp
009 ht
T}:T{
.sp
00A lf
T}:T{
.sp
00B vt
T}
T{
.sp
00C ff
T}:T{
.sp
00D cr
T}:T{
.sp
00E so
T}:T{
.sp
00F si
T}:T{
.sp
010 dle
T}:T{
.sp
011 dc1
T}
T{
.sp
012 dc2
T}:T{
.sp
013 dc3
T}:T{
.sp
014 dc4
T}:T{
.sp
015 nak
T}:T{
.sp
016 syn
T}:T{
.sp
017 etb
T}
T{
.sp
018 can
T}:T{
.sp
019 em
T}:T{
.sp
01A sub
T}:T{
.sp
01B esc
T}:T{
.sp
01C fs
T}:T{
.sp
01D gs
T}
T{
.sp
01E rs
T}:T{
.sp
01F us
T}:T{
.sp
0FF del
T}:T{
.sp

T}:T{
.sp

T}:T{
.sp

T}
.TE
.sp
.br
.RE
.ll
.SS "Kolory"
.sp
Gdy umieści się je na końcu łańcucha formatu, \fBhexdump\fP podświetla odpowiedni łańcuch zadanym kolorem. Warunki, jeśli są obecne, są sprawdzane przed podświetlaniem.
.sp
\fB_L[jednostka_koloru_1,jednostka_koloru_2,...,jednostka_koloru_n]\fP
.sp
Pełna definicja jednostki koloru jest następująca:
.sp
\fB[!]KOLOR[:WARTOŚĆ][@PRZESUNIĘCIA_POCZĄTEK[\-KONIEC]]\fP
.sp
\fB!\fP
.RS 4
Zaprzecza warunkowi. Proszę zauważyć, zaprzeczenie jednostce ma sens tylko wówczas, gdy poda się zarówno wartość/łańcuch oraz przesunięcie. W takim przypadku, dany łańcuch wyjściowy zostanie podświetlony wtedy i tylko wtedy, gdy wartość/łańcuch nie odpowiada tej/temu na przesunięciu.
.RE
.sp
\fBKOLOR\fP
.RS 4
Jeden z 8 podstawowych kolorów powłoki.
.RE
.sp
\fBWARTOŚĆ\fP
.RS 4
Wartość, która ma być dopasowana, podana szesnastkowo lub ósemkowo, albo jako łańcuch. Proszę zauważyć, że zwykłe sekwencje specjalne C nie są interpretowane przez \fBhexdump\fP w jednostkach_koloru.
.RE
.sp
\fBPRZESUNIĘCIE\fP
.RS 4
Przesunięcie lub zakres przesunięcie, wobec którego zostanie sprawdzone dopasowanie. Proszę zauważyć, że sam PRZESUNIĘCIA_POCZĄTEK używa tej samej wartości, co KONIEC przesunięcia.
.RE
.SS "Liczniki"
.sp
Domyślne i obsługiwane liczniki bajtów dla znaków konwersji są następujące:
.sp
\fB%_c\fP, \fB%_p\fP, \fB%_u\fP, \fB%c\fP
.RS 4
Tylko liczniki jednobajtowe.
.RE
.sp
\fB%d\fP, \fB%i\fP, \fB%o\fP, \fB%u\fP, \fB%X\fP, \fB%x\fP
.RS 4
Domyślnie cztery bajty; obsługiwane są liczniki jedno\-, dwu\- i czterobajtowe.
.RE
.sp
\fB%E\fP, \fB%e\fP, \fB%f\fP, \fB%G\fP, \fB%g\fP
.RS 4
Domyślnie osiem bajtów, obsługiwane są też liczniki czterobajtowe.
.RE
.sp
Ilość danych, interpretowanych przez każdy łańcuch formatujący jest sumą danych wymaganych przez każdą jednostką formatującą, która jest obliczana jako iteracja razy licznik bajtów; albo iteracja razy licznik bajtów wymaganych przez format, jeśli nie podano licznika bajtów.
.sp
Wejście jest obsługiwane w \fIblokach\fP, gdzie blok jest zdefiniowany jako największa porcja danych, podanych przez dowolny z łańcuchów formatujących. Łańcuchy formatujące, które interpretują mniej danych niż zawartych jest w bloku wejściowym, w którym ostatnia jednostka formatująca interpretuje pewną liczbę bajtów i nie ma ustawionego określonego licznika iteracji, mają zwiększany licznik iteracji, aż cały blok nie zostanie przetworzony, lub aż zabraknie danych do zadowolenia łańcucha formatującego.
.sp
Jeśli w wyniku określenia przez użytkownika, lub modyfikacji licznika iteracji przez \fBhexdump\fP, licznik iteracji jest większy niż jeden, to podczas ostatniej iteracji nie są wyświetlane końcowe białe spacje.
.sp
Błędem jest podawanie licznika bajtów razem z wieloma znakami/łańcuchami konwersji, chyba że wszystkie, poza jednym znakiem/łańcuchem konwersji, to \fB_a\fP lub \fB_A\fP.
.sp
Jeśli w wyniku podania opcji \fB\-n\fP lub osiągnięcia końca pliku, dane wejściowe zadowolą łańcuch formatujący tylko częściowo, blok wejściowy jest wypełniony zerami, wystarczająco aby wyświetlić wszystkie dostępne dane (tj. wszystkie jednostki formatujące, zachodzące za koniec danych będą wyświetlały jakąś liczbę bajtów zerowych).
.sp
Dalsze wyjście takich łańcuchów formatujących jest zamieniane odpowiadającą liczbą spacji. Odpowiadająca liczba spacji jest zdefiniowana jako liczba wyjścia spacji przez znak konwersji \fBs\fP z tym samym polem i precyzją co oryginalny znak konwersji, lub napis konwersji, lecz z usuniętymi wszelkimi znakami flag "\fB+\fP", " ", "*#"\*(Aq i wskazującym na łańcuch NULL.
.sp
Jeśli nie poda się łańcucha formatującego, domyślne wyświetlanie jest bardzo zbliżone do formatu wyjściowego \fB\-x\fP (opcja \fB\-x\fP powoduje, że pomiędzy jednostkami formatu jest więcej miejsca, niż w domyślnym wyjściu).
.SH "STATUS ZAKOŃCZENIA"
.sp
\fBhexdump\fP wychodzi z 0 przy powodzeniu i z > 0 jeśli wystąpił błąd.
.SH "ZGODNE Z"
.sp
Polecenie \fBhexdump\fP powinno być zgodne z IEEE Std 1003.2 ("POSIX.2").
.SH "PRZYKŁADY"
.sp
Wyświetla wejście w przestudiowanym formacie:
.sp
.if n .RS 4
.nf
.fam C
   "%06.6_ao "\&  12/1 "%3_u "
   "\(rst" "%_p "
   "\(rsn"
.fam
.fi
.if n .RE
.sp
Implementuje opcję \fB\-x\fP:
.sp
.if n .RS 4
.nf
.fam C
   "%07.7_Ax\(rsn"
   "%07.7_ax\&  " 8/2 "%04x " "\(rsn"
.fam
.fi
.if n .RE
.sp
Przykład sygnatury rozruchu MBR: Podświetla adresy na błękitno, a bajty w przesunięciach 510 i 511 na zielono, jeśli ich wartość to 0xAA55 lub na czerwono w innym przypadku.
.sp
.if n .RS 4
.nf
.fam C
   "%07.7_Ax_L[cyan]\(rsn"
   "%07.7_ax_L[cyan]\&  " 8/2 "\&   %04x_L[green:0xAA55@510\-511,!red:0xAA55@510\-511] " "\(rsn"
.fam
.fi
.if n .RE
.SH "KOLORY"
.sp
Kolorowanie wyjściowe zaimplementowano poprzez \fBterminal\-colors.d\fP(5). Jawne kolorowanie można wyłączyć za pomocą pustego pliku
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/hexdump.disable\fP
.br
.RE
.ll
.sp
dla polecenia \fBhexdump\fP albo dla wszystkich narzędzi plikiem
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/disable\fP
.br
.RE
.ll
.sp
Since version 2.41, the $NO_COLOR environment variable is also supported to disable output colorization unless explicitly enabled by a command\-line option.
.sp
Globalne ustawienie przesłonią \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP lub \fI$HOME/.config/terminal\-colors.d\fP danego użytkownika.
.sp
Proszę zauważyć, że kolorowanie wyjścia może być domyślnie włączone i wówczas katalogi \fIterminal\-colors.d\fP mogą jeszcze nie istnieć.
.SH "ZGŁASZANIE BŁĘDÓW"
.sp
Problemy należy zgłaszać w \c
.URL "https://github.com/util\-linux/util\-linux/issues" "systemie śledzenia błędów" "."
.SH "DOSTĘPNOŚĆ"
.sp
Polecenie \fBhexdump\fP jest częścią pakietu util\-linux, który można pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."
