od − Afficher le contenu d’un fichier en octal ou sous d’autres formats.

od [−abcdfhiloxv] [−s[longueur]] [−w[largeur]] [−A base] [−j nb_octets] [−N nb_octets] [−t type] [−−skip−bytes=nb_octets] [−−address−radix=base] [−−read−bytes=nb_octets] [−−format=type] [−−output−duplicates] [−−strings[=longueur]] [−−width[=largeur]] [−−traditional] [−−help] [−−version] [file...]

Cette page de manuel documente la version GNU de od ([NDT] od = Octal Dump).

od affiche sur la sortie standard le contenu des fichiers indiqués. Si aucun fichier n’est fourni, ou si le nom ‘−’ est mentionné, c’est le contenu de l’entrée standard qui est affiché.

Chaque ligne de sortie est constituée d’une colonne représentant le décalage par rapport au début du fichier, suivi d’une ou plusieurs colonnes de données, dans un format contrôlé par les options.

Par défaut od affiche les décalages en octal, et les données contenues dans le fichier sous forme de nombres en octal de deux octets.

OPTIONS

−A, −−address−radix=base

Sélectionner la base dans laquelle les décalages sont affichées. base peut prendre l’une des valeurs suivantes :

d

décimale

o

octale

x

hexadécimale

n

aucune (ne pas afficher les décalages)

La base par défaut est octale.

−j, −−skip−bytes=n

Sauter n octets en entrée avant la mise en forme et l’affichage. Si n commence par ‘0x’ ou ‘0X’, il est interprété en hexadécimal. Autrement, il est interprété en octal s’il commence par ‘0’, et en décimal sinon. En ajoutant ‘b’, la valeur est multipliée par 512, en ajoutant ‘k’ par 1024 et en ajoutant ‘m’ par 1048576.

−N, −−read−bytes=n

Afficher au maximum n octets de chaque fichier d’entrée. Les préfixes et suffixes de n sont interprétés comme ceux de l’option −j.

−t, −−format=type

Sélectionner le format d’affichage des résultats. type est une chaîne composée d’un ou plusieurs indicateurs de type décrits ci-dessous. Si plusieurs indicateurs sont indiqués, ou si cette option est répétée plusieurs fois, od affichera une copie de chaque ligne de sortie en utilisant chacun des types spécifiés, dans l’ordre des arguments.

a

caractères littéraux

c

caractères ASCII ou séquences d’échappement préfixées par BackSlash

d

valeurs décimales signées

f

valeurs en virgule flottante

o

valeurs octales

u

valeurs décimales non signées

x

valeurs hexadécimales

Pour tous les types, sauf ‘a’ et ‘c’, vous pouvez préciser le nombre d’octets à utiliser pour interpréter chaque nombre dans le format indiqué. Pour cela, on fait suivre la lettre indiquant le type d’un nombre entier décimal. On peut également utiliser l’un des types génériques des compilateurs C en ajoutant une des lettres suivantes après le type. Pour les valeurs entières (d, o, u, x):

C

char

S

short

I

int

L

long

Pour les réels en virgule flottante (f) :

F

float

D

double

L

long double

−v, −−output−duplicates

Afficher les lignes identiques consécutives. Par défaut, lorsque deux (ou plus) lignes successives de résultat sont identiques, od n’affiche que la première, et imprime un astérisque sur les lignes suivantes.

−s, −−strings[=n]

Plutôt que l’affichage normal, ne présenter que les chaînes de caractères trouvées dans les lignes d’entrée, et s’étendant sur au moins n caractères ASCII graphiques (ou de mise en page), terminées par un caractère NUL. Si n est omis, la valeur 3 est utilisée par défaut.

−w, −−width[=n]

Afficher n octets d’entrée par ligne. Cette valeur doit être un multiple commun aux tailles des types de sortie spécifiés. Si n est omis, la valeur par défaut est 32 octets. Si cette option n’est pas mentionnée, la valeur par défaut est 16.

−−help

Afficher un message d’aide sur la sortie standard et se terminer normalement.

−−version

Afficher un numéro de version sur la sortie standard et se terminer normalement.

Les options suivantes sont d’anciennes spécifications, antérieures à POSIX, équivalentes aux nouvelles options POSIX. La version GNU de od accepte toutes les combinaisons d’options correspondant à l’ancien et au nouveau style. Les spécifications de format s’ajoutent.

−a

Afficher des caractères littéraux, équivalent à −t a.

−b

Afficher des valeurs octales, équivalent à −t oC.

−c

Afficher des caractères ASCII ou des séquences préfixées par BackSlash, équivalent à −t c.

−d

Afficher des entiers courts en décimal non signé, équivalent à −t u2.

−f

Afficher des valeurs réelles, équivalent à −t fF.

−h

Afficher des entiers courts en hexadécimal, équivalent à −t x2.

−i

Afficher des entiers courts en décimal, équivalent à −t d2.

−l

Afficher des entiers longs en décimal, équivalent à −t d4.

−o

Afficher des entiers courts en octal, équivalent à −t o2.

−x

Afficher des entiers courts en hexadécimal, équivalent à −t x2.

−−traditional

Reconnaître les arguments antérieurs à POSIX que supportaient d’anciennes version de od. La syntaxe suivante :
od −−traditional [file] [[+]décalage[.][b] [[+]étiquette[.][b]]]
peut être utilisée pour indiquer au plus un fichier, et des arguments supplémentaires indiquant un décalage et une adresse de départ, étiquette. par défaut décalage est interprété comme un nombre octal précisant combien d’octets d’entrée doivent être ignorés avant de démarrer la mise en forme. Le point décimal optionnel permet de forcer l’interprétation de décalage en tant que nombre décimal. Si le point est absent, et si le décalage débute par ‘0x’ ou ‘0x’, il est interprété comme nombre hexadécimal. S’il y a un suffixe ‘b’, le nombre d’octets est multiplié par 512. L’étiquette est interprétée comme le décalage, mais elle indique une pseudo-adresse de départ. Les pseudo-adresses obtenues sont affichées entre parenthèses après les adresses normales.

Christophe Blaess, 1997.