MAN page from RedHat Other textutils-1.22-1.1.i386.rpm
OD
Section: User Commands (1)
Updated: GNU Text Utilities
Index 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 inaccurateor incomplete. The Texinfo documentation is now the authoritative source.
This manual pagedocuments the GNU version ofod.odwrites to the standard output the contents of the given files, or ofthe standard input if the name `-' is given. Each line of the outputconsists of the offset in the input file in the leftmost column ofeach line, followed by one or more columns of data from the file, in aformat controlled by the options. By default,odprints the file offsets in octal and the file data as two-byte octalnumbers.
OPTIONS
- -A, --address-radix=radix
- Select the base in which file offsets are printed.radixcan 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
- Skipbytesinput bytes before formatting and writing. Ifbytesbegins 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 tobytesbytes of each input file. Any prefixes and suffixes onbytesare interpreted as for the-joption.
- -t, --format=type
- Select the format in which to output the file data.typeis a string of one or more of the below type indicator characters.If you include more than one type indicator character in a singletypestring or use this option more than once,odwrites one copy of each output line using each of the data types thatyou 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 touse in interpreting each number in the given data type by followingthe type indicator character with a decimal integer. Alternately, youcan specify the size of one of the C compiler's built-in data types byfollowing the type indicator character with one of the followingcharacters. 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,odoutputs only the first line, and puts just an asterisk on thefollowing line to indicate that identical lines have been elided.
- -s, --strings[=bytes]
- Instead of the normal output, output onlystring constants in the input, which are a run of at leastbytesASCII graphic (or formatting) characters, terminated by a NUL. Ifbytesis omitted, it defaults to 3.
- -w, --width[=bytes]
- The number of input bytes to format per output line. It must be amultiple of the least common multiple of the sizes associated with thespecified output types. Ifbytesis omitted, it defaults to 32. If this option is not given, itdefaults 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 formatspecification options to the corresponding POSIX formatspecs. GNUodaccepts any combination of old- and new-style options. Formatspecification 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 ofod accepted. The following syntax
od--traditional [file] [[+]offset[.][b] [[+]label[.][b]]]
can be usedto specify at most one file and optional arguments specifyingan offset and a pseudo-start address,label.By default,offsetis interpreted as an octal number specifying how many input bytes toskip before formatting and writing. The optional trailing decimal pointforces the interpretation ofoffsetas a decimal number.If no decimal is specified and the offset begins with `0x' or `0x' it isinterpreted as a hexadecimal number. If there is a trailing `b',the number of bytes skipped will beoffsetmultiplied by 512.The label argument is interpreted just like offset, but it specifiesan initial pseudo-address. The pseudo addresses are displayed inparentheses following any normal address.
Index
- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
This document was created byman2html,using the manual pages.
