Man page - xxd(1)

Packages contains this manual

    Package:  xxd
    apt-get install xxd
    Manuals in package:
    Documentations in package:

Available languages:

en fr it pl ja ru zh_TW zh_CN

Manual

XXD

NOM
SYNOPSIS
DESCRIPTION
OPTIONS
MISE EN GARDE
EXEMPLES
VALEURS DE RETOUR
VOIR AUSSI
AVERTISSEMENTS
VERSION
AUTEUR
TRADUCTION

NOM

xxd - convertit en représentation hexadécimale et inversement.

SYNOPSIS

xxd -h[elp]
xxd [options] [fichier_entree [fichier_sortie]]
xxd -r[evert] [options] [fichier_entree [fichier_sortie]]

DESCRIPTION

xxd crĂ©e un fichier contenant la reprĂ©sentation hexadĂ©cimale d’un fichier binaire ou de l’entrĂ©e standard. Il peut Ă©galement convertir un fichier de codes hexadĂ©cimaux en un fichier binaire. Comme uuencode (1) et uudecode (1) il permet la transmission de donnĂ©es binaires dans une reprĂ©sentation ASCII compatible avec le courrier Ă©lectronique, mais a l’avantage de dĂ©coder la sortie standard. De plus, il peut ĂȘtre utilisĂ© pour appliquer des rustines Ă  des fichiers binaires.

OPTIONS

Si aucun fichier_entree n’est spĂ©cifiĂ©, l’entrĂ©e standard est utilisĂ©e. Si fichier_entree correspond au caractĂšre ’-’ l’entrĂ©e standard est employĂ©e comme source des donnĂ©es en entrĂ©e. Si aucun fichier_sortie n’est spĂ©cifiĂ© (ou qu’un caractĂšre ’-’ est donnĂ© Ă  sa place), le rĂ©sultat est envoyĂ© sur la sortie standard.

NOTE : un analyseur paresseux est utilisĂ©. Il ne vĂ©rifie pas au-delĂ  de la premiĂšre lettre de l’option, Ă  moins que cette derniĂšre ne requiert un paramĂštre. L’espace entre l’option et son paramĂštre est optionnel. Les paramĂštres des options peuvent ĂȘtre spĂ©cifiĂ©s en notation dĂ©cimale, hexadĂ©cimale ou octale. Ainsi -c8 , -c 8 , -c 010 et -cols 8 sont tous Ă©quivalents.
-a | -autoskip

active la fonctionnalitĂ© "autoskip" : le caractĂšre ’*’ remplace les lignes d’octets nuls. DĂ©sactivĂ©e par dĂ©faut.

-b | -bits

Convertit en binaires plutĂŽt qu’en hexadĂ©cimal. Cette option Ă©crit les octets comme une sĂ©quence de "1" et de "0" au lieu d’une conversion en hexadĂ©cimal traditionnel. Chaque ligne est prĂ©cĂ©dĂ©e par un numĂ©ro de ligne en hexadĂ©cimal et suivie de la reprĂ©sentation ASCII (ou EBCDIC) correspondante. Les options -p, -i ne fonctionnent pas dans ce mode.

-c cols | -cols cols

place < cols > octets par ligne. 16 par défaut (-i : 12, -ps : 30, -b : 6). Maximum 256.

-E | -EBCDIC

Passe le codage des caractÚres de la colonne de droite de ASCII à EBCDIC. Cela ne change pas la représentation hexadécimale. Cette option est sans effet quand elle est utilisée avec -r, -p or -i.

-g octets | -groupsize octets

Regroupe les octets (deux chiffres hexadĂ©cimaux ou huit chiffres binaires) par groupe de < octets > sĂ©parĂ©s par des espaces blancs. SpĂ©cifiez -g 0 pour supprimer le regroupement. < octets > vaut 2 par dĂ©faut dans le mode normal et 1 en reprĂ©sentation binaire. Le regroupement ne s’applique pas aux styles Postscript et Include.

-h | -help

Affiche un rĂ©sumĂ© des commandes disponibles et quitte. Aucune conversion n’est effectuĂ©e.

-i | -include

produit une sortie dans le style #include (fichier C Ă  inclure). La dĂ©finition complĂšte d’un tableau statique est Ă©crite et est nommĂ©e d’aprĂšs le fichier d’origine, Ă  moins que xxd lise depuis l’entrĂ©e standard.

-l long | -len long

ArrĂȘte aprĂšs l’écriture de < long > octets.

-p | -ps | -postscript | -plain

Produit une conversion continue dans le style Postscript (postscript continuous hexdump style). Également connu sous le nom de « conversion brute » (plain hexdump style).

-r | -revert

OpĂ©ration inverse : convertit un fichier hexadĂ©cimal en un fichier binaire (ou applique une rustine Ă  un fichier binaire). Si l’écriture n’a pas lieu sur la sortie standard, xxd Ă©crit dans le fichier qu’il produit sans le tronquer. Utilisez la combinaison -r -p pour lire de l’hexadĂ©cimal brut sans information sur le numĂ©ro des lignes et sans format de colonnes particulier. Des espaces blancs et coupures de lignes supplĂ©mentaires sont autorisĂ©s Ă  n’importe quel endroit.

-seek décalage

UtilisĂ© aprĂšs l’option -r : inverse la conversion en ajoutant < dĂ©calage > aux positions dans le fichier donnĂ©es dans le code hexadĂ©cimal.

-s [+][-]décalage

DĂ©bute au < dĂ©calage > absolu ou relatif dans fichier_entree. + indique que le dĂ©calage est relatif Ă  la position courante dans l’entrĂ©e standard (sans effet si la lecture n’a pas lieu sur l’entrĂ©e standard). - indique un dĂ©calage en caractĂšres depuis la fin de l’entrĂ©e (utilisĂ© avec + , dĂ©signe la position avant la position actuelle de l’entrĂ©e standard). Sans l’option -s, xxd dĂ©marre Ă  la position courante du fichier.

-u

Utilise des chiffres hexadécimaux majuscules. La casse par défaut est minuscule.

-v | -version

Affiche la version de xxd.

MISE EN GARDE

xxd -r effectue des opĂ©rations internes un peu obscures lors de l’évaluation des informations sur les numĂ©ros de lignes. Si le fichier de sortie est adressable, alors les numĂ©ros de lignes au dĂ©but de chaque ligne d’hexadĂ©cimal peuvent ĂȘtre dĂ©sordonnĂ©es, des lignes peuvent manquer ou se chevaucher. Dans ces cas, xxd utilisera lseek(2) pour dĂ©terminer la prochaine position. Si le fichier n’est pas adressable, seuls les vides sont autorisĂ©s, et ils seront comblĂ©s par des octets nuls.

xxd -r ne gĂ©nĂšre aucune erreur lors de l’analyse. Les problĂšmes sont passĂ©s silencieusement.

Lors de l’édition de la reprĂ©sentation hexadĂ©cimale, veuillez noter que xxd -r ignore tout ce qui se trouve sur la ligne aprĂšs avoir lu suffisamment de donnĂ©es hexadĂ©cimales (voir l’option -c). Cela signifie Ă©galement que les modifications dans la colonne ASCII (ou EBCDIC) sont toujours ignorĂ©es. La conversion inverse de donnĂ©es hexadĂ©cimales brutes (postscript) avec xxd -r -p ne dĂ©pend pas d’un nombre correct de colonnes. Dans ce cas, tout ce qui ressemble Ă  une paire de chiffres hexadĂ©cimaux est interprĂ©tĂ©.

Remarquez la différence entre
% xxd -i fichier
et
% xxd -i < fichier

xxd -s +seek peut diffĂ©rer de xxd -s seek , car lseek(2) est utilisĂ© pour « revenir en arriĂšre ». Le ’+’ fait une diffĂ©rence quand la source des donnĂ©es est l’entrĂ©e standard et si la position dans le fichier de l’entrĂ©e standard n’est pas au dĂ©but du fichier lorsque xxd est dĂ©marrĂ© et qu’il reçoit ses donnĂ©es. L’exemple suivant peut vous aider Ă  comprendre (ou bien vous perdre davantage encore !)...

Remettre l’entrĂ©e standard au dĂ©part avant de lire ; nĂ©cessaire car ’cat’ a dĂ©jĂ  lu jusqu’à la fin de l’entrĂ©e standard.
% sh -c ’cat > donnees_binaires; xxd -s 0 > donnees_hexa’ < fichier

Convertir Ă  partir de la position 0x480 (= 1024 + 128) du fichier. Le symbole ’+’ signifie "relativement Ă  la position actuelle’, ainsi 128 est ajoutĂ© aux 1024 octets comptabilisĂ©s pour dd.
% sh -c ’dd of=donnees_binaires bs=1k count=1; xxd -s +128 > donnees_hexa’ < fichier

Convertir de fichier depuis la position 0x100 (= 1024 - 768) du fichier.
% sh -c ’dd of=donnees_binaires bs=1k count=1; xxd -s +-768 > donnees_hexa’ < fichier

Toutefois, cette situation est peu frĂ©quente et l’utilisation de ’+’ est rarement requise. L’auteur prĂ©fĂšre surveiller les effets de xxd avec strace(1) ou truss(1) quand -s est employĂ©.

EXEMPLES

Afficher la totalité du fichier sauf les trois premiÚres lignes (0x30 octets en hexadécimal).
% xxd -s 0x30 fichier

afficher les trois derniÚres lignes (0x30 octets en hexadécimal) du fichier
% xxd -s -0x30 fichier

Afficher 120 octets convertis en continu, avec 20 octets par ligne.
% xxd -l 120 -ps -c 20 xxd-fr.1
2e54482058584420312022616ffb742031393936
22202250616765206465206d616e75656c20706f
757220787864220a2e5c220a2e5c222032317374
204d617920313939360a2e5c22204d616e207061
676520617574686f723a0a2e5c2220202020546f
6e79204e7567656e74203c746f6e79407363746e
204e7567656e74203c746f6e79407363746e7567
2e54482058584420312022417567757374203139

Convertir les 120 premiers octets de cette page de manuel avec 12 octets par ligne.
% xxd -l 120 -c 12 xxd-fr.1
0000000: 2e54 4820 5858 4420 3120 2261 .TH XXD 1 "a
000000c: 6ffb 7420 3139 3936 2220 2250 o.t 1996" "P
0000018: 6167 6520 6465 206d 616e 7565 age de manue
0000024: 6c20 706f 7572 2078 7864 220a l pour xxd".
0000030: 2e5c 220a 2e5c 2220 3231 7374 .
000003c: 204d 6179 2031 3939 360a 2e5c May 1996..\
0000048: 2220 4d61 6e20 7061 6765 2061 " Man page a
0000054: 7574 686f 723a 0a2e 5c22 2020 uthor:..
0000060: 2020 546f 6e79 204e 7567 656e Tony Nugen
000006c: 7420 3c74 6f6e 7940 7363 746e t <tony@sctn

Afficher la date écrite au début du fichier xxd-fr.1.
% xxd -s 0x38 -l 13 -c 13 xxd.1
0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996

Copier fichier_entree vers fichier_sortie en ajoutant 100 octets de valeur 0x00 avant.
% xxd fichier_entree | xxd -r -s 100 > fichier_sortie

Patcher la date dans le fichier xxd.1
% echo ’0000037: 3574 68’ | xxd -r - xxd-fr.1
% xxd -s 0x38 -l 13 -c 13 xxd-fr.1
0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996

CrĂ©er un fichier de 65537 octets tous nuls (0x00), sauf le dernier qui vaut ’A’ (0x41 en hexadĂ©cimal).
% echo ’010000: 41’ | xxd -r > fichier

Convertir le fichier de l’exemple prĂ©cĂ©dent avec la fonctionnalitĂ© "autoskip".
% xxd -a -c 12 fichier
0000000: 0000 0000 0000 0000 0000 0000 ............
*
000fffc: 0000 0000 40 ....A

CrĂ©er un fichier d’un octet, contenant seulement le caractĂšre ’A’. Le nombre aprĂšs ’-r -s’ s’ajoute aux numĂ©ros de lignes trouvĂ©es dans le fichier ; les octets initiaux sont supprimĂ©s.
% echo ’010000: 41’ | xxd -r -s -0x10000 > fichier

Utiliser xxd comme filtre dans un Ă©diteur tel que vim(1) pour convertir une zone comprise entre les marques ’a’ et ’z’.
:’a,’z!xxd

Utiliser xxd comme filtre dans un Ă©diteur tel que vim(1) pour rĂ©cupĂ©rer une conversion binaire comprise entre les marques ’a’ et ’z’.
:’a,’z!xxd -r

Utiliser xxd comme filtre dans un éditeur tel que vim(1) pour récupérer une ligne convertie. Placez le curseur sur la ligne et tapez :
!!xxd -r

Lire des caractÚres depuis une connexion série :
% xxd -c1 < /dev/term/b &
% stty < /dev/term/b -echo -opost -isig -icanon min 1
% echo -n foo > /dev/term/b

VALEURS DE RETOUR

Les erreurs suivantes sont rapportées :

0

aucune erreur ne s’est produit.

-1

opération non supportée ( xxd -r -i reste impossible).

1

erreur lors de l’analyse des options.

2

problĂšme avec le fichier d’entrĂ©e.

3

problĂšme avec le fichier de sortie.

4, 5

la position spĂ©cifiĂ©e n’est pas atteignable.

VOIR AUSSI

uuencode(1), uudecode(1), patch(1)

AVERTISSEMENTS

L’étrangetĂ© de cet outil reflĂšte celle du cerveau de ses crĂ©ateurs. Utilisez cet outil Ă  vos risques et pĂ©rils. Dupliquez vos fichiers. Surveillez l’outil. Devenez un gourou.

VERSION

Cette page de manuel documente la version 1.7 de xxd.

AUTEUR

(c) 1990-1997 par Juergen Weigert
<jnweiger@informatik.uni-erlangen.de>

"Distribute freely and credit me,
make money and share with me,
lose money and don’t ask me."

Distribution libre en citant l’auteur,
gagnez de l’argent, pensez à moi,
perdez de l’argent, oubliez-moi.

Page de manuel débutée par Tony Nugent
<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
Modifications mineures par Bram Moolenaar. ÉditĂ© par Juergen Weigert.

TRADUCTION

Cette page de manuel a été traduite par David Blanchet <david.blanchet@free.fr> 2004-12-24. Mise à jour 2013-05-10, Dominique Pellé <dominique.pelle@gmail.com>