.\" -*- coding: UTF-8 -*- '\" t .\" Title: hexdump .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.15 .\" Date: 2022-05-11 .\" Manual: User Commands .\" Source: util-linux 2.38.1 .\" Language: English .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH HEXDUMP 1 "11. Mai 2022" "util\-linux 2.38.1" "Dienstprogramme für Benutzer" .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 BEZEICHNUNG hexdump \- Dateiinhalte hexadezimal, dezimal, oktal oder in ASCII ausgeben .sp \fBhexdump\fP \fIOptionen Datei\fP … .sp \fBhd\fP \fIOptionen Datei\fP … .SH BESCHREIBUNG .sp Das Dienstprogramm \fBhexdump\fP ist ein Filter, der in einem benutzerspezifischen Format die angegebenen Dateien oder den Inhalt der Standardeingabe anzeigt (falls keine Dateien angegeben sind). .SH OPTIONEN .sp Nachfolgend können den Argumenten \fIGröße\fP und \fIVersatz\fP die 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. .sp \fB\-b\fP, \fB\-\-one\-byte\-octal\fP .RS 4 \fIOktale Ein\-Byte\-Anzeige\fP. 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. .RE .sp \fB\-c\fP, \fB\-\-one\-byte\-char\fP .RS 4 \fIZeichenbasierte Ein\-Byte\-Anzeige\fP. 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. .RE .sp \fB\-C\fP, \fB\-\-canonical\fP .RS 4 \fIKanonische Hex+ASCII\-Anzeige\fP. 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 \fB%_p\fP, in \fB|\fP eingeschlossen. Der Aufruf des Programms als \fBhd\fP impliziert diese Option. .RE .sp \fB\-d\fP, \fB\-\-two\-bytes\-decimal\fP .RS 4 \fIDezimale Zwei\-Byte\-Anzeige\fP. 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. .RE .sp \fB\-e\fP, \fB\-\-format\fP \fIFormatzeichenkette\fP .RS 4 gibt eine Formatzeichenkette an, die für die Anzeige der Daten verwendet werden soll. .RE .sp \fB\-f\fP, \fB\-\-format\-file\fP \fIDatei\fP .RS 4 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. .RE .sp \fB\-L\fP, \fB\-\-color\fP[=\fIWANN\fP] .RS 4 akzeptiert Farbeinheiten für die Ausgabe. Das optionale Argument \fIwann\fP kann \fBauto\fP (automatisch), \fBnever\fP (niemals) oder \fBalways\fP (immer) sein. Falls das Argument \fIwann\fP nicht angegeben wird, dann wird standardmäßig \fBauto\fP verwendet. Die Farben können deaktiviert werden; die aktuelle eingebaute Voreinstellung finden Sie in der Ausgabe der Option \fB\-\-help\fP. Siehe auch den Unterabschnitt \fBFarben\fP und den nachfolgenden Abschnitt \fBFARBEN\fP. .RE .sp \fB\-n\fP, \fB\-\-length\fP \fILänge\fP .RS 4 wertet nur die angegebene \fILänge\fP an Bytes der Eingabe aus. .RE .sp \fB\-o\fP, \fB\-\-two\-bytes\-octal\fP .RS 4 \fIOktale Zwei\-Byte\-Anzeige\fP. 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. .RE .sp \fB\-s\fP, \fB\-\-skip\fP \fIVersatz\fP .RS 4 überspringt den angegebenen \fIVersatz\fP an Bytes vom Beginn der Eingabe. .RE .sp \fB\-v\fP, \fB\-\-no\-squeezing\fP .RS 4 Die Option \fB\-v\fP veranlasst \fBhexdump\fP, alle Eingabedaten anzuzeigen. Ohne die Option \fB\-v\fP werden sämtliche Ausgabezeilengruppen, die identisch zur unmittelbar vorausgehenden Ausgabezeilengruppe wären (außer den Eingabeversätzen), durch eine aus einem einzelnen Stern bestehende Zeile ersetzt. .RE .sp \fB\-x\fP, \fB\-\-two\-bytes\-hex\fP .RS 4 \fIHexadezimale Zwei\-Byte\-Anzeige\fP. 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. .RE .sp \fB\-h\fP, \fB\-\-help\fP .RS 4 zeigt einen Hilfetext an und beendet das Programm. .RE .sp \fB\-V\fP, \fB\-\-version\fP .RS 4 zeigt die Versionsnummer an und beendet das Programm. .RE .sp Für jede Eingabedatei kopiert \fBhexdump\fP die Eingabe sequenziell in die Standardausgabe, wobei die Daten anhand der in den Optionen \fB\-e\fP und \fB\-f\fP angegebenen Formatzeichenketten in deren angegebener Reihenfolge umgewandelt werden. .SH FORMATE .sp 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. .sp Der Iterationszähler ist eine optionale positive Ganzzahl, deren Vorgabe 1 ist. Jedes Format wird so oft angewendet, wie der Iterationszähler angibt. .sp 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. .sp 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. .sp Das Format ist verpflichtend und muss in doppelte Anführungszeichen (" ") eingeschlossen werden. Es wird als eine Formatzeichenkette im Fprintf\-Stil (siehe \fBfprintf\fP(3)) mit den folgenden Ausnahmen interpretiert: .sp 1. .RS 4 Ein Stern (*) darf nicht zur Angabe der Feldbreite oder Genauigkeit verwendet werden. .RE .sp 2. .RS 4 Ein Byte\-Zähler oder eine Feldgenauigkeit \fIist\fP für jedes \fBs\fP\-Konversionszeichen erforderlich (im Gegensatz zur Standardeinstellung in \fBfprintf\fP(3), wo die gesamte Zeichenkette ausgegeben wird, falls keine Genauigkeit angegeben ist). .RE .sp 3. .RS 4 Die Konversionszeichen \fBh\fP, \fBl\fP, \fBn\fP, \fBp\fP und \fBq\fP werden nicht unterstützt. .RE .sp 4. .RS 4 Die im C\-Standard beschriebenen aus einem Zeichen bestehenden Escape\-Sequenzen werden unterstützt: .RE .RS 3 .ll -.6i .TS allbox tab(:); lt lt. T{ .sp NULL T}:T{ .sp \(rs0 T} T{ .sp T}:T{ .sp \(rsa T} T{ .sp T}:T{ .sp \(rsb T} T{ .sp T}:T{ .sp \(rsf T} T{ .sp T}:T{ .sp \(rsn T} T{ .sp T}:T{ .sp \(rsr T} T{ .sp T}:T{ .sp \(rst T} T{ .sp T}:T{ .sp \(rsv T} .TE .sp .br .RE .ll .SS Konversionszeichenketten .sp Das Dienstprogramm \fBhexdump\fP unterstützt auch die folgenden zusätzlichen Konversionszeichenketten. .sp \fB_a[dox]\fP .RS 4 zeigt den Eingabeversatz des nächsten anzuzeigenden Bytes kumulativ für alle Eingabedateien an. Die angehängten Zeichen \fBd\fP, \fBo\fP und \fBx\fP geben die Basis der Anzeige als dezimal, oktal beziehungsweise hexadezimal an. .RE .sp \fB_A[dox]\fP .RS 4 ist weitgehend identisch mit der Konversionszeichenkette \fB_a\fP, mit der Ausnahme, dass es nur einmal ausgeführt wird, wenn sämtliche Eingabedateien verarbeitet wurden. .RE .sp \fB_c\fP .RS 4 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. .RE .sp \fB_p\fP .RS 4 gibt Zeichen im Standard\-Zeichensatz aus. Nicht darstellbare Zeichen werden als einzelner »\fB.\fP« angezeigt. .RE .sp \fB_u\fP .RS 4 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. .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 Farben .sp Wenn an das Ende eines Formatbezeichners gesetzt, hebt \fBhexdump\fP die jeweilige Zeichenkette in der angegebenen Farbe hervor. Bedingungen werden, sofern vorhanden, bei der Anwendung der Hervorhebung bevorzugt. .sp \fB_L[Farbeinheit_1,Farbeinheit_2,…,Farbeinheit_n]\fP .sp Die vollständige Syntax einer Farbeinheit ist wie folgt: .sp \fB[!]FARBE[:WERT][@VERSATZ_BEGINN[\-ENDE]]\fP .sp \fB!\fP .RS 4 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. .RE .sp \fBFARBE\fP .RS 4 Eine der acht grundlegenden Shell\-Farben. .RE .sp \fBWERT\fP .RS 4 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 \fBhexdump\fP nicht interpretiert werden. .RE .sp \fBVERSATZ\fP .RS 4 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. .RE .SS Zähler .sp Die vorgegebenen und unterstützten Byte\-Zähler für die Konversionszeichen sind wie folgt: .sp \fB%_c\fP, \fB%_p\fP, \fB%_u\fP, \fB%c\fP .RS 4 Nur Ein\-Byte\-Zähler. .RE .sp \fB%d\fP, \fB%i\fP, \fB%o\fP, \fB%u\fP, \fB%X\fP, \fB%x\fP .RS 4 Vier Byte als Standard, aber auch ein, zwei und vier Byte werden unterstützt. .RE .sp \fB%E\fP, \fB%e\fP, \fB%f\fP, \fB%G\fP, \fB%g\fP .RS 4 Acht Byte als Standard, aber auch Vier\-Byte\-Zähler werden unterstützt. .RE .sp 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. .sp Die Eingabe wird in \fIBlöcken\fP 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. .sp Falls ein Iterationszähler größer als 1 ist, entweder als Ergebnis der Benutzerangabe oder wenn \fBhexdump\fP den Iterationszähler wie oben beschrieben verändert hat, werden während der letzten Iteration keine abschließenden Leerzeichen ausgegeben. .sp 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 \fB_a\fP oder \fB_A\fP. .sp Falls, als Ergebnis der Angabe der Option \fB\-n\fP 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 Nullbytes an). .sp Weitere Ausgaben solcher Formatzeichenketten werden durch die äquivalente Anzahl Leerzeichen ersetzt. Eine äquivalente Anzahl Leerzeichen ist als die Anzahl der durch das Konversionszeichen \fBs\fP 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. .sp Falls keine Formatzeichenketten angegeben sind, ist die standardmäßige Anzeige sehr ähnlich zum Ausgabeformat mit der Option \fB\-x\fP (die Option \fB\-x\fP verursacht mehr Platzverbrauch zwischen den Formateinheiten als in der standardmäßigen Ausgabe). .SH EXIT\-STATUS .sp \fBhexdump\fP gibt 0 bei Erfolg und >0 zurück, wenn ein Fehler aufgetreten ist. .SH "KONFORM ZU" .sp Der Befehl \fBhexdump\fP sollte zu IEEE Std 1003.2 (»POSIX.2«) kompatibel sein. .SH BEISPIELE .sp Die Eingabe im Durchsichtsformat anzeigen: .sp .if n .RS 4 .nf .fam C "%06.6_ao " 12/1 "%3_u " "\(rst" "%_p " "\(rsn" .fam .fi .if n .RE .sp Die Option \fB\-x\fP implementieren: .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 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. .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 FARBEN .sp Die farbige Darstellung der Ausgabe wird über die Funktionen in \fBterminal\-colors.d\fP(5) gesteuert. Die implizierte Einfärbung kann deaktiviert werden, indem Sie folgende (leere) Datei anlegen: .RS 3 .ll -.6i .sp \fI/etc/terminal\-colors.d/hexdump.disable\fP .br .RE .ll .sp Dies gilt für den Befehl \fBhexdump\fP. Die farbige Darstellung bei allen Werkzeugen erreichen Sie mit .RS 3 .ll -.6i .sp \fI/etc/terminal\-colors.d/disable\fP .br .RE .ll .sp Die benutzerspezifischen \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP oder \fI$HOME/.config/terminal\-colors.d\fP setzen die globale Einstellung außer Kraft. .sp Beachten Sie, dass die Einfärbung der Ausgabe standardmäßig aktiviert sein könnte und in diesem Fall die \fIterminal\-colors.d\fP\-Verzeichnisse noch nicht zwangsläufig vorhanden sein müssen. .SH "FEHLER MELDEN" .sp Verwenden Sie zum Melden von Fehlern das Fehlererfassungssystem auf .URL https://github.com/util\-linux/util\-linux/issues "" . .SH VERFÜGBARKEIT .sp Der Befehl \fBhexdump\fP ist Teil des Pakets util\-linux, welches heruntergeladen werden kann von: .URL https://www.kernel.org/pub/linux/utils/util\-linux/ "Linux Kernel Archive" . .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .