![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to od.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / old / od|
Return to od.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / old / od |
1.1 root 1: .\" Copyright (c) 1980 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)od.1 6.1 (Berkeley) 4/29/85
6: .\"
7: .TH OD 1 "April 29, 1985"
8: .UC 4
9: .SH NAME
10: od \- octal, decimal, hex, ascii dump
11: .SH SYNOPSIS
12: .B od
13: [ \-format ] [ file ] [ [\fB+\fP]offset[\fB.\fP][\fBb\fP] [label] ]
14: .SH DESCRIPTION
15: .I Od
16: displays
17: .IR file ,
18: or it's standard input,
19: in one or more dump formats
20: as selected by the first argument.
21: If the first argument is missing,
22: .B \-o
23: is the default.
24: Dumping continues until end-of-file.
25: .PP
26: The meanings of the format argument characters are:
27: .TP 5
28: .B a
29: Interpret bytes as characters and display them with their ACSII names.
30: If the
31: .B p
32: character is given also, then bytes with even parity are underlined.
33: The
34: .B P
35: character causes bytes with odd parity to be underlined.
36: Otherwise the parity bit is ignored.
37: .TP 5
38: .B b
39: Interpret bytes as unsigned octal.
40: .TP 5
41: .B c
42: Interpret bytes as ASCII characters.
43: Certain non-graphic characters appear as C escapes:
44: null=\e0,
45: backspace=\eb,
46: formfeed=\ef,
47: newline=\en,
48: return=\er,
49: tab=\et;
50: others appear as 3-digit octal numbers.
51: Bytes with the parity bit set are displayed in octal.
52: .TP 5
53: .B d
54: Interpret (short) words as unsigned decimal.
55: .TP 5
56: .B f
57: Interpret long words as floating point.
58: .TP 5
59: .B h
60: Interpret (short) words as unsigned hexadecimal.
61: .TP 5
62: .B i
63: Interpret (short) words as signed decimal.
64: .TP 5
65: .B l
66: Interpret long words as signed decimal.
67: .TP 5
68: .B o
69: Interpret (short) words as unsigned octal.
70: .TP 5
71: .BR s [n]
72: Look for strings of ascii graphic characters, terminated with a null byte.
73: .I N
74: specifies the minimum length string to be recognized.
75: By default, the minimum length is 3 characters.
76: .TP 5
77: .B v
78: Show all data. By default, display lines that are identical to the last
79: line shown are not output, but are indicated with an ``*'' in column 1.
80: .TP 5
81: .BR w [n]
82: Specifies the number of input bytes to be interpreted and displayed
83: on each output line. If
84: .B w
85: is not specified, 16 bytes are read for each display line.
86: If
87: .I n
88: is not specified, it defaults to 32.
89: .TP 5
90: .B x
91: Interpret (short) words as hexadecimal.
92: .PP
93: An upper case format character implies the long or double precision
94: form of the object.
95: .PP
96: The
97: .I offset
98: argument specifies the byte offset
99: into the file where dumping is to commence.
100: By default this argument is interpreted in octal.
101: A different radix can be specified;
102: If ``\fB.\fR'' is appended to the argument, then
103: .I offset
104: is interpreted in decimal.
105: If
106: .I offset
107: begins with ``\fBx\fP'' or ``\fB0x\fP'',
108: it is interpreted in hexadecimal.
109: If ``\fBb\fP'' (``\fBB\fP'') is appended, the offset is interpreted
110: as a block count, where a block is 512 (1024) bytes.
111: If the
112: .I file
113: argument is omitted, an
114: .I offset
115: argument must be preceded by
116: .RB `` + ''.
117: .PP
118: The radix of the displayed address will be the same as the radix of the
119: .IR offset ,
120: if specified; otherwise it will be octal.
121: .PP
122: .I Label
123: will be interpreted as a pseudo-address for the first byte displayed.
124: It will be shown in ``()'' following the file offset.
125: It is intended to be used with
126: core images to indicate the real memory address.
127: The syntax for
128: .I label
129: is identical to that for
130: .IR offset .
131: .SH "SEE ALSO"
132: adb(1)
133: .SH BUGS
134: A file name argument can't start with ``+''.
135: A hexadecimal offset can't be a block count.
136: Only one file name argument can be given.
137: .PP
138: It is an historical botch to require specification of object, radix, and
139: sign representation in a single character argument.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.