'\"macro stdmacro
.if n .pH g1.od @(#)od	40.10 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} od 1 "Directory and File Management Utilities" "\&"
.if \nX=1 .ds x} od 1 "Directory and File Management Utilities"
.if \nX=2 .ds x} od 1 "" "\&"
.if \nX=3 .ds x} od "" "" "\&"
.TH \*(x}
.\" Copyright (c) 1988 Sun Microsystems, Inc - All Rights Reserved.
.SH NAME
\f4od\f1 \- octal dump
.SH SYNOPSIS
\f4od\f1
[
\f4\-bcDdFfOoSsvXx\f1
] [
.I file
] [ [
\f4+\f1
]\f2offset\f1[
\f4\&. \f1|
\f4b\f1 ] ]
.SH DESCRIPTION
\f4od\fP
displays
.I file\^
in
one or more formats,
as
selected by the first argument.
If the first argument is missing,
\f4\-o\f1
is default.
If no
.I file
is specified, the standard input is used.
For the purposes of this description,
"word"
refers to a 16-bit unit, independent of the word size
of the machine;
"long word" refers to a 32-bit unit, and
"double long word" refers to a 64-bit unit.
The meanings of the format options are:
.TP 6
\f4\-b\f1
Interpret bytes in octal.
.TP
\f4\-c\f1
Interpret bytes as single-byte characters.
Certain non-graphic characters appear as C-language escapes:
null=\f4\e0\fP,
backspace=\f4\eb\fP,
form-feed=\f4\ef\fP,
new-line=\f4\en\fP,
return=\f4\er\fP,
tab=\f4\et\fP;
others appear as 3-digit octal numbers.
For example:
.sp .5
\f4echo "hello world" | od -c\f1
.br
\f40000000   h   e   l   l   o       w   o   r   l   d  \en\f1
.br
\f40000014\f1
.TP
\f4\-D\f1
Interpret long words in unsigned decimal.
.TP
\f4\-d\f1
Interpret words in unsigned decimal.
.TP
\f4\-F\f1
Interpret double long words
in extended precision.
.TP
\f4\-f\f1
Interpret long words
in floating point.
.TP
\f4\-O\f1
Interpret long words
in unsigned octal.
.TP
\f4\-o\f1
Interpret words in octal.
.TP
\f4\-S\f1
Interpret long words
in signed decimal.
.TP
\f4\-s\f1
Interpret words in signed decimal.
.TP
\f4\-v\f1
Show all data (verbose).
.TP
\f4\-X\f1
Interpret long words in hex.
.TP
\f4\-x\f1
Interpret words in hex.
.PP
\f2offset\f1 specifies an offset
from the beginning of \f2file\f1 where
the display will begin.
\f2offset\f1 is normally interpreted
as octal bytes.
If \f4.\f1 is appended, \f2offset\f1 is interpreted in
decimal.
If \f4b\f1 is appended, \f2offset\f1 is interpreted in
blocks of 512 bytes.
If \f2file\f1 is omitted,
\f2offset\f1 must be preceded by
\f4+\f1.
.PP
The display continues until an end-of-file is reached.
.\"	@(#)od.1	6.2 of 9/2/83
.Ee
