Debian Codegraph @

upstream/debian-trixie/man1/od.1

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