Man page - hexdump(1)

Packages contains this manual

Available languages:

en pl ja ro sr de

Manual

HEXDUMP

BEZEICHNUNG
ÜBERSICHT
BESCHREIBUNG
OPTIONEN
FORMATE
Konversionszeichenketten
Farben
ZĂ€hler
EXIT-STATUS
KONFORM ZU
BEISPIELE
FARBEN
FEHLER MELDEN
VERFÜGBARKEIT

BEZEICHNUNG

hexdump - Dateiinhalte hexadezimal, dezimal, oktal oder in ASCII ausgeben

ÜBERSICHT

hexdump Optionen Datei ...

hd Optionen Datei ...

BESCHREIBUNG

Das Dienstprogramm hexdump ist ein Filter, der in einem benutzerspezifischen Format die angegebenen Dateien oder den Inhalt der Standardeingabe anzeigt (falls keine Dateien angegeben sind).

OPTIONEN

Nachfolgend kann den Argumenten GrĂ¶ĂŸe und Versatz eines der multiplikativen Suffixe KiB (=1024), MiB (=1024*1024) und so weiter fĂŒr GiB, TiB, PiB, EiB, ZiB und YiB folgen (das »iB« ist optional, zum Beispiel ist »K« gleichbedeutend mit »KiB«) oder die Suffixe KB (=1000), MB (=1000*1000) und so weiter fĂŒr GB, TB, PB, EB, ZB und YB folgen.

-b , --one-byte-octal

Oktale Ein-Byte-Anzeige . Dies zeigt den Eingabeversatz in hexadezimaler Form, gefolgt von sechzehn durch LeerrĂ€ume getrennten, dreispaltigen, mittels Nullen aufgefĂŒllten Zeichen der Eingabedaten in oktaler Notation pro Zeile an.

-X , --one-byte-hex

Hexadezimale Ein-Byte-Anzeige . Dies zeigt den Eingabeversatz in hexadezimaler Form, gefolgt von sechzehn durch LeerrĂ€ume getrennten, zweispaltigen, mittels Nullen aufgefĂŒllten Zeichen der Eingabedaten in hexadezimaler Notation pro Zeile an.

-c , --one-byte-char

Zeichenbasierte Ein-Byte-Anzeige . Dies zeigt den Eingabeversatz in hexadezimaler Form, gefolgt von sechzehn durch LeerrĂ€ume getrennten, dreispaltigen, mittels LeerrĂ€umen aufgefĂŒllten Zeichen der Eingabedaten pro Zeile an.

-C , --canonical

Kanonische Hex+ASCII-Anzeige . Dies zeigt den Eingabeversatz in hexadezimaler Form , gefolgt von sechzehn durch LeerrÀume getrennten, zweispaltigen hexadezimalen Bytes an, gefolgt von den gleichen sechzehn Bytes im Format %_p , in | eingeschlossen. Der Aufruf des Programms als hd impliziert diese Option.

-d , --two-bytes-decimal

Dezimale Zwei-Byte-Anzeige . Dies zeigt den Eingabeversatz in hexadezimaler Form an, gefolgt von acht durch LeerrĂ€ume getrennten, fĂŒnfspaltigen, mittels Nullen aufgefĂŒllten Zwei-Byte-Einheiten der Eingabedaten und in vorzeichenloser dezimaler Notation pro Zeile an.

-e , --format Formatzeichenkette

gibt eine Formatzeichenkette an, die fĂŒr die Anzeige der Daten verwendet werden soll.

-f , --format-file Datei

gibt eine Datei an, die eine oder mehrere durch ZeilenvorschĂŒbe getrennte Formatzeichenketten enthĂ€lt. Leere Zeilen und solche, deren erstes auf eventuellen Leerraum folgende Zeichen eine Raute ist (#), werden ignoriert.

-L , --color [ = when ]

akzeptiert Farbeinheiten fĂŒr die Ausgabe. Das optionale Argument wann kann auto (automatisch), never (niemals) oder always (immer) sein. Falls das Argument wann nicht angegeben wird, dann wird standardmĂ€ĂŸig auto verwendet. Die Farben können deaktiviert werden; die aktuelle eingebaute Voreinstellung finden Sie in der Ausgabe der Option --help . Siehe auch den Unterabschnitt Farben und den nachfolgenden Abschnitt FARBEN .

-n , --length LĂ€nge

wertet nur die angegebene LĂ€nge an Bytes der Eingabe aus.

-o , --two-bytes-octal

Oktale Zwei-Byte-Anzeige . Dies zeigt den Eingabeversatz in hexadezimaler Form, gefolgt von acht durch LeerrĂ€ume getrennten, sechsspaltigen, mittels Nullen aufgefĂŒllten Zwei-Byte-Einheiten der Eingabedaten und in oktaler Notation pro Zeile an.

-s , --skip Versatz

ĂŒberspringt den angegebenen Versatz an Bytes vom Beginn der Eingabe.

-v , --no-squeezing

veranlasst hexdump , alle Eingabedaten anzuzeigen. Ohne die Option -v wird sĂ€mtliche Anzahl Ausgabezeilengruppen, die identisch zur unmittelbar vorausgehenden Ausgabezeilengruppe wĂ€ren (außer den EingabeversĂ€tzen), durch eine aus einem einzelnen Stern bestehende Zeile ersetzt.

-x , --two-bytes-hex

Hexadezimale Zwei-Byte-Anzeige . Dies zeigt den Eingabeversatz in hexadezimaler Form, gefolgt von acht durch LeerrĂ€ume getrennten, vierspaltigen, mittels Nullen aufgefĂŒllten Zwei-Byte-Einheiten der Eingabedaten und in hexadezimaler Notation pro Zeile an.

-h , --help

zeigt einen Hilfetext an und beendet das Programm.

-V , --version

Display version and exit.

FĂŒr jede Eingabedatei kopiert hexdump die Eingabe sequenziell in die Standardausgabe, wobei die Daten anhand der in den Optionen -e und -f angegebenen Formatzeichenketten in deren angegebener Reihenfolge umgewandelt werden.

FORMATE

Eine Formatzeichenkette enthÀlt eine beliebige Anzahl an Formatierungseinheiten, die durch Leerzeichen getrennt sind. Eine Formatierungseinheit einhÀlt bis zu drei EintrÀge: Einen IterationszÀhler, einen Byte-ZÀhler und ein Format.

Der IterationszÀhler ist eine optionale positive Ganzzahl, deren Vorgabe 1 ist. Jedes Format wird so oft angewendet, wie der IterationszÀhler angibt.

Der Byte-ZĂ€hler ist eine optionale positive Ganzzahl. Falls diese angegeben wird, gibt sie die Anzahl an Bytes an, die bei jeder Iteration des Formats interpretiert werden sollen.

Falls ein Iterations- oder Byte-ZÀhler angegeben ist, muss nach dem IterationszÀhler und/oder vor dem Byte-ZÀhler ein einzelner SchrÀgstrich gesetzt werden, um die beiden Angaben eindeutig voneinander zu trennen. SÀmtlicher Leerraum vor oder nach dem SchrÀgstrich wird ignoriert.

Das Format ist verpflichtend und muss in doppelte AnfĂŒhrungszeichen (" ") eingeschlossen werden. Es wird als eine Formatzeichenkette im Fprintf-Stil (siehe fprintf (3)) mit den folgenden Ausnahmen interpretiert:

1.

Ein Stern (*) darf nicht zur Angabe der Feldbreite oder Genauigkeit verwendet werden.

2.

Ein Byte-ZĂ€hler oder eine Feldgenauigkeit ist fĂŒr jedes s -Konversionszeichen erforderlich (im Gegensatz zur Standardeinstellung in fprintf (3), wo die gesamte Zeichenkette ausgegeben wird, falls keine Genauigkeit angegeben ist).

3.

Die Konversionszeichen h , l , n , p und q werden nicht unterstĂŒtzt.

4.

Die im C-Standard beschriebenen aus einem Zeichen bestehenden Escape-Sequenzen werden unterstĂŒtzt:

Konversionszeichenketten

Das Dienstprogramm hexdump unterstĂŒtzt auch die folgenden zusĂ€tzlichen Konversionszeichenketten.

_a[dox]

zeigt den Eingabeversatz des nĂ€chsten anzuzeigenden Bytes kumulativ fĂŒr alle Eingabedateien an. Die angehĂ€ngten Zeichen d , o und x geben die Basis der Anzeige als dezimal, oktal beziehungsweise hexadezimal an.

_A[dox]

ist weitgehend identisch mit der Konversionszeichenkette _a , mit der Ausnahme, dass es nur einmal ausgefĂŒhrt wird, wenn sĂ€mtliche Eingabedateien verarbeitet wurden.

_c

gibt Zeichen im Standard-Zeichensatz aus. Nicht darstellbare Zeichen werden in einer aus drei Zeichen bestehenden, mit Nullen aufgefĂŒllten oktalen Schreibweise dargestellt. Das gilt nicht fĂŒr jene, die in der Standard-Escape-Notation dargestellt werden können (siehe oben), wo die Anzeige in aus zwei Zeichen bestehenden Zeichenketten erfolgt.

_p

gibt Zeichen im Standard-Zeichensatz aus. Nicht darstellbare Zeichen werden als einzelner » . « angezeigt.

_u

gibt US-ASCII-Zeichen aus, mit der Ausnahme, dass Steuerzeichen in den folgenden, klein geschriebenen Namen angezeigt werden. Zeichen grĂ¶ĂŸer als 0xff hexadezimal werden als hexadezimale Zeichenketten angezeigt.

Farben

Wenn an das Ende eines Formatbezeichners gesetzt, hebt hexdump die jeweilige Zeichenkette in der angegebenen Farbe hervor. Bedingungen werden, sofern vorhanden, bei der Anwendung der Hervorhebung bevorzugt.

_L[Farbeinheit_1,Farbeinheit_2,...,Farbeinheit_n]

Die vollstÀndige Syntax einer Farbeinheit ist wie folgt:

[!]FARBE[:WERT][@VERSATZ_BEGINN[-ENDE]]

!

negiert die Bedingung. Bitte beachten Sie, dass die Negierung einer Einheit nur Sinn ergibt, wenn sowohl Wert/Zeichenkette als auch Versatz angegeben sind. In einem solchen Fall wird die entsprechende Ausgabezeichenkette nur dann hervorgehoben, wenn Wert/Zeichenkette nicht zu jener passt, die im Versatz angegeben ist.

FARBE

Eine der acht grundlegenden Shell-Farben.

WERT

Ein Wert, der auf Übereinstimmung geprĂŒft wird, dargestellt in hexadezimaler oder oktaler Basis oder als Zeichenkette. Bitte beachten Sie, dass die ĂŒblichen C-Escape-Sequenzen innerhalb von Farbeinheiten von hexdump nicht interpretiert werden.

VERSATZ

Ein Versatz oder Versatzbereich, in dem auf Übereinstimmung geprĂŒft werden soll. Bitte beachten Sie, dass ein einzelner VERSATZ_BEGINN den gleichen Wert fĂŒr ENDE verwendet.

ZĂ€hler

Die vorgegebenen und unterstĂŒtzten Byte-ZĂ€hler fĂŒr die Konversionszeichen sind wie folgt:

%_c , %_p , %_u , %c

Nur Ein-Byte-ZĂ€hler.

%d , %i , %o , %u , %X , %x

Vier Byte als Standard, aber auch ein, zwei und vier Byte werden unterstĂŒtzt.

%E , %e , %f , %G , %g

Acht Byte als Standard, aber auch Vier-Byte-ZĂ€hler werden unterstĂŒtzt.

Die Menge der von jeder Formatzeichenkette interpretierten Daten ist die Summe der fĂŒr jede Formateinheit erforderlichen Daten, welches das Produkt aus dem IterationszĂ€hler mit dem Byte-ZĂ€hler oder, falls der Byte-ZĂ€hler nicht angegeben ist, das Produkt aus dem IterationszĂ€hler mit der Anzahl vom Format benötigten Bytes ist.

Die Eingabe wird in Blöcken verarbeitet, wobei ein Block als die grĂ¶ĂŸte Menge der von einer Formatzeichenkette bezeichneten Daten definiert ist. Bei Formatzeichenketten, die weniger als eine EingabeblockgrĂ¶ĂŸe an Daten auswerten und deren letzte Formateinheit sowohl einen Anteil an Bytes interpretiert und als auch keinen angegebenen IterationszĂ€hler haben, wird der IterationszĂ€hler erhöht, bis der gesamte Eingabeblock verarbeitet wurde oder es nicht mehr genug verbleibende Daten im Block gibt, um der Formatzeichenkette zu entsprechen.

Falls ein IterationszĂ€hler grĂ¶ĂŸer als 1 ist, entweder als Ergebnis der Benutzerangabe oder wenn hexdump den IterationszĂ€hler wie oben beschrieben verĂ€ndert hat, werden wĂ€hrend der letzten Iteration keine abschließenden Leerzeichen ausgegeben.

Es ist ein Fehler, sowohl einen Byte-ZĂ€hler als auch mehrere Konversionszeichen oder -zeichenketten anzugeben, es sei denn, alle Konversionszeichen oder -zeichenketten bis auf eine sind _a oder _A .

Falls, als Ergebnis der Angabe der Option -n oder wenn das Ende der Datei erreicht ist, die Eingabedaten einer Formatzeichenkette nur teilweise entsprechen, wird der Eingabeblock mit Nullen aufgefĂŒllt, um alle verfĂŒgbaren Daten anzuzeigen (das heißt, jede Formateinheit, die ĂŒber das Ende der Daten hinausgeht, zeigt einige NULL-Bytes an).

Weitere Ausgaben solcher Formatzeichenketten werden durch die Ă€quivalente Anzahl Leerzeichen ersetzt. Eine Ă€quivalente Anzahl Leerzeichen ist als die Anzahl der durch das Konversionszeichen s ausgegebenen Leerzeichen definiert. Diese haben die gleiche Feldbreite und Genauigkeit wie das ursprĂŒngliche Konversionszeichen oder die ursprĂŒngliche Konversionszeichenkette, aber bei allen werden die Konversionszeichen »+«, » « und »#« entfernt und referenzieren eine NULL-Zeichenkette.

Falls keine Formatzeichenketten angegeben sind, ist die standardmĂ€ĂŸige Anzeige sehr Ă€hnlich zum Ausgabeformat mit der Option -x (die Option -x verursacht mehr Platzverbrauch zwischen den Formateinheiten als in der standardmĂ€ĂŸigen Ausgabe).

EXIT-STATUS

hexdump gibt 0 bei Erfolg und > 0 zurĂŒck, wenn ein Fehler aufgetreten ist.

KONFORM ZU

Der Befehl hexdump sollte zu IEEE Std 1003.2 (»POSIX.2«) kompatibel sein.

BEISPIELE

Die Eingabe im Durchsichtsformat anzeigen:

"%06.6_ao " 12/1 "%3_u "
"\t" "%_p "
"\n"

Die Option -x implementieren:

"%07.7_Ax\n"
"%07.7_ax " 8/2 "%04x " "\n"

Beispiel fĂŒr MBR-Bootsignatur: Die Adressen in Cyan hervorheben und die Bytes an Position 510 und 511 grĂŒn hervorheben, falls deren Wert 0xAA55 ist, anderenfalls rot.

"%07.7_Ax_L[cyan]\n"
"%07.7_ax_L[cyan] " 8/2 " %04x_L[green:0xAA55@510-511,!red:0xAA55@510-511] " "\n"

FARBEN

Die farbige Darstellung der Ausgabe wird ĂŒber die Funktionen in terminal-colors.d (5) gesteuert. Die implizierte EinfĂ€rbung kann deaktiviert werden, indem Sie folgende (leere) Datei anlegen:

/etc/terminal-colors.d/hexdump.disable

fĂŒr den Befehl hexdump oder fĂŒr alle Befehle mit

/etc/terminal-colors.d/disable

Since version 2.41, the $NO_COLOR environment variable is also supported to disable output colorization unless explicitly enabled by a command-line option.

Die benutzerspezifischen Dateien $XDG_CONFIG_HOME/terminal−colors.d oder $HOME/.config/terminal−colors.d setzen die globale Einstellung außer Kraft.

Beachten Sie, dass die EinfĂ€rbung der Ausgabe standardmĂ€ĂŸig aktiviert sein könnte und in diesem Fall die terminal-colors.d -Verzeichnisse noch nicht zwangslĂ€ufig vorhanden sein mĂŒssen.

FEHLER MELDEN

For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.

VERFÜGBARKEIT

Der Befehl hexdump ist Teil des Pakets util-linux, welches aus dem Linux-Kernel-Archiv <https://www.kernel.org/pub/linux/utils/util-linux/> heruntergeladen werden kann.