man-pages/man1/od.1.html
2021-03-31 01:06:50 +01:00

217 lines
6.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of OD</TITLE>
</HEAD><BODY>
<H1>OD</H1>
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
od - dump files in octal and other formats
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>od</B>
[<I>,OPTION/</I>]... [<I>,FILE/</I>]...
<BR>
<B>od</B>
[<I>,-abcdfilosx/</I>]... [<I>,FILE/</I>] [[<I>,+/</I>]<I>,OFFSET/</I>[<I>,./</I>][<I>,b/</I>]]
<BR>
<B>od</B>
<I>,--traditional /</I>[<I>,OPTION/</I>]... [<I>,FILE/</I>] [[<I>,+/</I>]<I>,OFFSET/</I>[<I>,./</I>][<I>,b/</I>] [<I>,+/</I>][<I>,LABEL/</I>][<I>,./</I>][<I>,b/</I>]]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
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.
<P>
With no FILE, or when FILE is -, read standard input.
<P>
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 <B>-j</B> 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.
<P>
Mandatory arguments to long options are mandatory for short options too.
<DL COMPACT>
<DT id="1"><B>-A</B>, <B>--address-radix</B>=<I>,RADIX/</I><DD>
output format for file offsets; RADIX is one
of [doxn], for Decimal, Octal, Hex or None
<DT id="2"><B>--endian=</B>{big|little}<DD>
swap input bytes according the specified order
<DT id="3"><B>-j</B>, <B>--skip-bytes</B>=<I>,BYTES/</I><DD>
skip BYTES input bytes first
<DT id="4"><B>-N</B>, <B>--read-bytes</B>=<I>,BYTES/</I><DD>
limit dump to BYTES input bytes
<DT id="5"><B>-S</B> BYTES, <B>--strings</B>[=<I>,BYTES/</I>]<DD>
output strings of at least BYTES graphic chars;
3 is implied when BYTES is not specified
<DT id="6"><B>-t</B>, <B>--format</B>=<I>,TYPE/</I><DD>
select output format or formats
<DT id="7"><B>-v</B>, <B>--output-duplicates</B><DD>
do not use * to mark line suppression
<DT id="8"><B>-w[BYTES]</B>, <B>--width</B>[=<I>,BYTES/</I>]<DD>
output BYTES bytes per output line;
32 is implied when BYTES is not specified
<DT id="9"><B>--traditional</B><DD>
accept arguments in third form above
<DT id="10"><B>--help</B><DD>
display this help and exit
<DT id="11"><B>--version</B><DD>
output version information and exit
</DL>
<A NAME="lbAE">&nbsp;</A>
<H3>Traditional format specifications may be intermixed; they accumulate:</H3>
<DL COMPACT>
<DT id="12"><B>-a</B><DD>
same as <B>-t</B> a, select named characters, ignoring high-order bit
<DT id="13"><B>-b</B><DD>
same as <B>-t</B> o1, select octal bytes
<DT id="14"><B>-c</B><DD>
same as <B>-t</B> c, select printable characters or backslash escapes
<DT id="15"><B>-d</B><DD>
same as <B>-t</B> u2, select unsigned decimal 2-byte units
<DT id="16"><B>-f</B><DD>
same as <B>-t</B> fF, select floats
<DT id="17"><B>-i</B><DD>
same as <B>-t</B> dI, select decimal ints
<DT id="18"><B>-l</B><DD>
same as <B>-t</B> dL, select decimal longs
<DT id="19"><B>-o</B><DD>
same as <B>-t</B> o2, select octal 2-byte units
<DT id="20"><B>-s</B><DD>
same as <B>-t</B> d2, select decimal 2-byte units
<DT id="21"><B>-x</B><DD>
same as <B>-t</B> x2, select hexadecimal 2-byte units
</DL>
<A NAME="lbAF">&nbsp;</A>
<H3>TYPE is made up of one or more of these specifications:</H3>
<DL COMPACT>
<DT id="22">a<DD>
named character, ignoring high-order bit
<DT id="23">c<DD>
printable character or backslash escape
<DT id="24">d[SIZE]<DD>
signed decimal, SIZE bytes per integer
<DT id="25">f[SIZE]<DD>
floating point, SIZE bytes per float
<DT id="26">o[SIZE]<DD>
octal, SIZE bytes per integer
<DT id="27">u[SIZE]<DD>
unsigned decimal, SIZE bytes per integer
<DT id="28">x[SIZE]<DD>
hexadecimal, SIZE bytes per integer
</DL>
<P>
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).
<P>
Adding a z suffix to any type displays printable characters at the end of
each output line.
<A NAME="lbAG">&nbsp;</A>
<H3>BYTES is hex with 0x or 0X prefix, and may have a multiplier suffix:</H3>
<DL COMPACT>
<DT id="29">b<DD>
512
<DT id="30">KB<DD>
1000
<DT id="31">K<DD>
1024
<DT id="32">MB<DD>
1000*1000
<DT id="33">M<DD>
1024*1024
</DL>
<P>
and so on for G, T, P, E, Z, Y.
<A NAME="lbAH">&nbsp;</A>
<H2>EXAMPLES</H2>
<DL COMPACT>
<DT id="34"><B>od -A x -t x1z -v</B>
<DD>
Display hexdump format output
<DT id="35"><B>od -A o -t oS -w16</B>
<DD>
The default output format used by od
</DL>
<A NAME="lbAI">&nbsp;</A>
<H2>AUTHOR</H2>
Written by Jim Meyering.
<A NAME="lbAJ">&nbsp;</A>
<H2>REPORTING BUGS</H2>
GNU coreutils online help: &lt;<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>&gt;
<BR>
Report od translation bugs to &lt;<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>&gt;
<A NAME="lbAK">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later &lt;<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>&gt;.
<BR>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
<A NAME="lbAL">&nbsp;</A>
<H2>SEE ALSO</H2>
Full documentation at: &lt;<A HREF="https://www.gnu.org/software/coreutils/od">https://www.gnu.org/software/coreutils/od</A>&gt;
<BR>
or available locally via: info '(coreutils) od invocation'
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="36"><A HREF="#lbAB">NAME</A><DD>
<DT id="37"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="38"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT id="39"><A HREF="#lbAE">Traditional format specifications may be intermixed; they accumulate:</A><DD>
<DT id="40"><A HREF="#lbAF">TYPE is made up of one or more of these specifications:</A><DD>
<DT id="41"><A HREF="#lbAG">BYTES is hex with 0x or 0X prefix, and may have a multiplier suffix:</A><DD>
</DL>
<DT id="42"><A HREF="#lbAH">EXAMPLES</A><DD>
<DT id="43"><A HREF="#lbAI">AUTHOR</A><DD>
<DT id="44"><A HREF="#lbAJ">REPORTING BUGS</A><DD>
<DT id="45"><A HREF="#lbAK">COPYRIGHT</A><DD>
<DT id="46"><A HREF="#lbAL">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:20 GMT, March 31, 2021
</BODY>
</HTML>