summaryrefslogtreecommitdiffstats
path: root/man/od.1
blob: 741b43cff7bf746f820883c106ea089f8b7ebd50 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
.TH OD "1" "April 2022" "GNU coreutils 9.1" "User Commands"
.SH NAME
od \- dump files in octal and other formats
.SH SYNOPSIS
.B od
[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
.br
.B od
[\fI\,-abcdfilosx\/\fR]... [\fI\,FILE\/\fR] [[\fI\,+\/\fR]\fI\,OFFSET\/\fR[\fI\,.\/\fR][\fI\,b\/\fR]]
.br
.B od
\fI\,--traditional \/\fR[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] [[\fI\,+\/\fR]\fI\,OFFSET\/\fR[\fI\,.\/\fR][\fI\,b\/\fR] [\fI\,+\/\fR][\fI\,LABEL\/\fR][\fI\,.\/\fR][\fI\,b\/\fR]]
.SH DESCRIPTION
.\" Add any additional description here
.PP
Write an unambiguous representation, octal bytes by default,
of FILE to standard output.  With more than one FILE argument,
concatenate them in the listed order to form the input.
.PP
With no FILE, or when FILE is \-, read standard input.
.PP
If first and second call formats both apply, the second format is assumed
if the last operand begins with + or (if there are 2 operands) a digit.
An OFFSET operand means \fB\-j\fR OFFSET.  LABEL is the pseudo\-address
at first byte printed, incremented when dump is progressing.
For OFFSET and LABEL, a 0x or 0X prefix indicates hexadecimal;
suffixes may be . for octal and b for multiply by 512.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-A\fR, \fB\-\-address\-radix\fR=\fI\,RADIX\/\fR
output format for file offsets; RADIX is one
of [doxn], for Decimal, Octal, Hex or None
.TP
\fB\-\-endian=\fR{big|little}
swap input bytes according the specified order
.TP
\fB\-j\fR, \fB\-\-skip\-bytes\fR=\fI\,BYTES\/\fR
skip BYTES input bytes first
.TP
\fB\-N\fR, \fB\-\-read\-bytes\fR=\fI\,BYTES\/\fR
limit dump to BYTES input bytes
.TP
\fB\-S\fR BYTES, \fB\-\-strings\fR[=\fI\,BYTES\/\fR]
output strings of at least BYTES graphic chars;
3 is implied when BYTES is not specified
.TP
\fB\-t\fR, \fB\-\-format\fR=\fI\,TYPE\/\fR
select output format or formats
.TP
\fB\-v\fR, \fB\-\-output\-duplicates\fR
do not use * to mark line suppression
.TP
\fB\-w[BYTES]\fR, \fB\-\-width\fR[=\fI\,BYTES\/\fR]
output BYTES bytes per output line;
32 is implied when BYTES is not specified
.TP
\fB\-\-traditional\fR
accept arguments in third form above
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.SS "Traditional format specifications may be intermixed; they accumulate:"
.TP
\fB\-a\fR
same as \fB\-t\fR a,  select named characters, ignoring high\-order bit
.TP
\fB\-b\fR
same as \fB\-t\fR o1, select octal bytes
.TP
\fB\-c\fR
same as \fB\-t\fR c,  select printable characters or backslash escapes
.TP
\fB\-d\fR
same as \fB\-t\fR u2, select unsigned decimal 2\-byte units
.TP
\fB\-f\fR
same as \fB\-t\fR fF, select floats
.TP
\fB\-i\fR
same as \fB\-t\fR dI, select decimal ints
.TP
\fB\-l\fR
same as \fB\-t\fR dL, select decimal longs
.TP
\fB\-o\fR
same as \fB\-t\fR o2, select octal 2\-byte units
.TP
\fB\-s\fR
same as \fB\-t\fR d2, select decimal 2\-byte units
.TP
\fB\-x\fR
same as \fB\-t\fR x2, select hexadecimal 2\-byte units
.SS "TYPE is made up of one or more of these specifications:"
.TP
a
named character, ignoring high\-order bit
.TP
c
printable character or backslash escape
.TP
d[SIZE]
signed decimal, SIZE bytes per integer
.TP
f[SIZE]
floating point, SIZE bytes per float
.TP
o[SIZE]
octal, SIZE bytes per integer
.TP
u[SIZE]
unsigned decimal, SIZE bytes per integer
.TP
x[SIZE]
hexadecimal, SIZE bytes per integer
.PP
SIZE is a number.  For TYPE in [doux], SIZE may also be C for
sizeof(char), S for sizeof(short), I for sizeof(int) or L for
sizeof(long).  If TYPE is f, SIZE may also be F for sizeof(float), D
for sizeof(double) or L for sizeof(long double).
.PP
Adding a z suffix to any type displays printable characters at the end of
each output line.
.SS "BYTES is hex with 0x or 0X prefix, and may have a multiplier suffix:"
.TP
b
512
.TP
KB
1000
.TP
K
1024
.TP
MB
1000*1000
.TP
M
1024*1024
.PP
and so on for G, T, P, E, Z, Y.
Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
.SH EXAMPLES
.TP
.B od -A x -t x1z -v
Display hexdump format output
.TP
.B od -A o -t oS -w16
The default output format used by od
.SH AUTHOR
Written by Jim Meyering.
.SH "REPORTING BUGS"
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
.br
Report any translation bugs to <https://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2022 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
Full documentation <https://www.gnu.org/software/coreutils/od>
.br
or available locally via: info \(aq(coreutils) od invocation\(aq