170 lines
4.7 KiB
Groff
170 lines
4.7 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
|
|
.TH OD "1" "April 2025" "GNU coreutils 9.7" "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]
|
|
show only NUL terminated strings
|
|
of at least BYTES (3) printable characters
|
|
.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 B for Brain 16 bit,
|
|
H for Half precision float, 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, R, Q.
|
|
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 2025 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
|