OD
Section: User Commands (1)
Updated: GNU Text Utilities
Index
Return to Main Contents
NAME
od - dump files in octal and other formats
SYNOPSIS
od
[-abcdfhiloxv] [-s[bytes]] [-w[bytes]] [-A radix] [-j bytes]
[-N bytes] [-t type] [--skip-bytes=bytes] [--address-radix=radix]
[--read-bytes=bytes] [--format=type] [--output-duplicates]
[--strings[=bytes]] [--width[=bytes]] [--traditional]
[--help] [--version] [file...]
DESCRIPTION
This documentation is no longer being maintained and may be inaccurate
or incomplete. The Texinfo documentation is now the authoritative source.
This manual page
documents the GNU version of
od.
od
writes to the standard output the contents of the given files, or of
the standard input if the name `-' is given. Each line of the output
consists of the offset in the input file in the leftmost column of
each line, followed by one or more columns of data from the file, in a
format controlled by the options. By default,
od
prints the file offsets in octal and the file data as two-byte octal
numbers.
OPTIONS
- -A, --address-radix=radix
-
Select the base in which file offsets are printed.
radix
can be one of the following:
-
- d
-
decimal
- o
-
octal
- x
-
hexadecimal
- n
-
none (do not print offsets)
The default is octal.
- -j, --skip-bytes=bytes
-
Skip
bytes
input bytes before formatting and writing. If
bytes
begins with `0x' or `0X', it is interpreted in hexadecimal; otherwise,
if it begins with `0', in octal; otherwise, in decimal. Appending `b'
multiplies it by 512, `k' by 1024, and `m' by 1048576.
- -N, --read-bytes=bytes
-
Only output up to
bytes
bytes of each input file. Any prefixes and suffixes on
bytes
are interpreted as for the
-j
option.
- -t, --format=type
-
Select the format in which to output the file data.
type
is a string of one or more of the below type indicator characters.
If you include more than one type indicator character in a single
type
string or use this option more than once,
od
writes one copy of each output line using each of the data types that
you specified, in the order that you specified.
-
- a
-
named character
- c
-
ASCII character or backslash escape
- d
-
signed decimal
- f
-
floating point
- o
-
octal
- u
-
unsigned decimal
- x
-
hexadecimal
Except for types `a' and `c', you can specify the number of bytes to
use in interpreting each number in the given data type by following
the type indicator character with a decimal integer. Alternately, you
can specify the size of one of the C compiler's built-in data types by
following the type indicator character with one of the following
characters. For integers (d, o, u, x):
-
- C
-
char
- S
-
short
- I
-
int
- L
-
long
For floating point (f):
-
- F
-
float
- D
-
double
- L
-
long double
- -v, --output-duplicates
-
Output consecutive lines that are identical. By default,
when two or more consecutive output lines would be equal,
od
outputs only the first line, and puts just an asterisk on the
following line to indicate that identical lines have been elided.
- -s, --strings[=bytes]
-
Instead of the normal output, output only
string constants in the input, which are a run of at least
bytes
ASCII graphic (or formatting) characters, terminated by a NUL. If
bytes
is omitted, it defaults to 3.
- -w, --width[=bytes]
-
The number of input bytes to format per output line. It must be a
multiple of the least common multiple of the sizes associated with the
specified output types. If
bytes
is omitted, it defaults to 32. If this option is not given, it
defaults to 16.
- --help
-
Print a usage message and exit with a status code indicating success.
- --version
-
Print version information on standard output then exit.
The next several options map the old, pre-POSIX format
specification options to the corresponding POSIX format
specs. GNU
od
accepts any combination of old- and new-style options. Format
specification options accumulate.
- -a
-
Output as named characters. Equivalent to
-t a.
- -b
-
Output as octal bytes. Equivalent to
-t oC.
- -c
-
Output as ASCII characters or backslash escapes. Equivalent to
-t c.
- -d
-
Output as unsigned decimal shorts. Equivalent to
-t u2.
- -f
-
Output as floats. Equivalent to
-t fF.
- -h
-
Output as hexadecimal shorts. Equivalent to
-t x2.
- -i
-
Output as decimal shorts. Equivalent to
-t d2.
- -l
-
Output as decimal longs. Equivalent to
-t d4.
- -o
-
Output as octal shorts. Equivalent to
-t o2.
- -x
-
Output as hexadecimal shorts. Equivalent to
-t x2.
- --traditional
-
Recognize the pre-POSIX non-option arguments that some older versions of
od accepted. The following syntax
od
--traditional [file] [[+]offset[.][b] [[+]label[.][b]]]
can be used
to specify at most one file and optional arguments specifying
an offset and a pseudo-start address,
label.
By default,
offset
is interpreted as an octal number specifying how many input bytes to
skip before formatting and writing. The optional trailing decimal point
forces the interpretation of
offset
as a decimal number.
If no decimal is specified and the offset begins with `0x' or `0x' it is
interpreted as a hexadecimal number. If there is a trailing `b',
the number of bytes skipped will be
offset
multiplied by 512.
The label argument is interpreted just like offset, but it specifies
an initial pseudo-address. The pseudo addresses are displayed in
parentheses following any normal address.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
This document was created by
man2html,
using the manual pages.
Time: 23:59:39 GMT, February 15, 2023