man/od.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH OD "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 od \- dump files in octal and other formats
   5 .SH SYNOPSIS
   6 .B od
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .br
   9 .B od
  10 [\fI-abcdfilosx\fR]... [\fIFILE\fR] [[\fI+\fR]\fIOFFSET\fR[\fI.\fR][\fIb\fR]]
  11 .br
  12 .B od
  13 \fI--traditional \fR[\fIOPTION\fR]... [\fIFILE\fR] [[\fI+\fR]\fIOFFSET\fR[\fI.\fR][\fIb\fR] [\fI+\fR][\fILABEL\fR][\fI.\fR][\fIb\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 With no FILE, or when FILE is \-, read standard input.
  21 .PP
  22 All arguments to long options are mandatory for short options.
  23 .TP
  24 \fB\-A\fR, \fB\-\-address\-radix\fR=\fIRADIX\fR
  25 decide how file offsets are printed
  26 .TP
  27 \fB\-j\fR, \fB\-\-skip\-bytes\fR=\fIBYTES\fR
  28 skip BYTES input bytes first
  29 .TP
  30 \fB\-N\fR, \fB\-\-read\-bytes\fR=\fIBYTES\fR
  31 limit dump to BYTES input bytes
  32 .TP
  33 \fB\-S\fR, \fB\-\-strings\fR[=\fIBYTES\fR]
  34 output strings of at least BYTES graphic chars
  35 .TP
  36 \fB\-t\fR, \fB\-\-format\fR=\fITYPE\fR
  37 select output format or formats
  38 .TP
  39 \fB\-v\fR, \fB\-\-output\-duplicates\fR
  40 do not use * to mark line suppression
  41 .TP
  42 \fB\-w\fR, \fB\-\-width\fR[=\fIBYTES\fR]
  43 output BYTES bytes per output line
  44 .TP
  45 \fB\-\-traditional\fR
  46 accept arguments in traditional form
  47 .TP
  48 \fB\-\-help\fR
  49 display this help and exit
  50 .TP
  51 \fB\-\-version\fR
  52 output version information and exit
  53 .SS "Traditional format specifications may be intermixed; they accumulate:"
  54 .TP
  55 \fB\-a\fR
  56 same as \fB\-t\fR a,  select named characters, ignoring high\-order bit
  57 .TP
  58 \fB\-b\fR
  59 same as \fB\-t\fR o1, select octal bytes
  60 .TP
  61 \fB\-c\fR
  62 same as \fB\-t\fR c,  select ASCII characters or backslash escapes
  63 .TP
  64 \fB\-d\fR
  65 same as \fB\-t\fR u2, select unsigned decimal 2\-byte units
  66 .TP
  67 \fB\-f\fR
  68 same as \fB\-t\fR fF, select floats
  69 .TP
  70 \fB\-i\fR
  71 same as \fB\-t\fR dI, select decimal ints
  72 .TP
  73 \fB\-l\fR
  74 same as \fB\-t\fR dL, select decimal longs
  75 .TP
  76 \fB\-o\fR
  77 same as \fB\-t\fR o2, select octal 2\-byte units
  78 .TP
  79 \fB\-s\fR
  80 same as \fB\-t\fR d2, select decimal 2\-byte units
  81 .TP
  82 \fB\-x\fR
  83 same as \fB\-t\fR x2, select hexadecimal 2\-byte units
  84 .PP
  85 If first and second call formats both apply, the second format is assumed
  86 if the last operand begins with + or (if there are 2 operands) a digit.
  87 An OFFSET operand means \fB\-j\fR OFFSET.  LABEL is the pseudo\-address
  88 at first byte printed, incremented when dump is progressing.
  89 For OFFSET and LABEL, a 0x or 0X prefix indicates hexadecimal;
  90 suffixes may be . for octal and b for multiply by 512.
  91 .PP
  92 TYPE is made up of one or more of these specifications:
  93 .TP
  94 a
  95 named character, ignoring high\-order bit
  96 .TP
  97 c
  98 ASCII character or backslash escape
  99 .TP
 100 d[SIZE]
 101 signed decimal, SIZE bytes per integer
 102 .TP
 103 f[SIZE]
 104 floating point, SIZE bytes per integer
 105 .TP
 106 o[SIZE]
 107 octal, SIZE bytes per integer
 108 .TP
 109 u[SIZE]
 110 unsigned decimal, SIZE bytes per integer
 111 .TP
 112 x[SIZE]
 113 hexadecimal, SIZE bytes per integer
 114 .PP
 115 SIZE is a number.  For TYPE in doux, SIZE may also be C for
 116 sizeof(char), S for sizeof(short), I for sizeof(int) or L for
 117 sizeof(long).  If TYPE is f, SIZE may also be F for sizeof(float), D
 118 for sizeof(double) or L for sizeof(long double).
 119 .PP
 120 RADIX is d for decimal, o for octal, x for hexadecimal or n for none.
 121 BYTES is hexadecimal with 0x or 0X prefix, it is multiplied by 512
 122 with b suffix, by 1024 with k and by 1048576 with m.  Adding a z suffix to
 123 any type adds a display of printable characters to the end of each line
 124 of output.  \fB\-\-string\fR without a number implies 3.  \fB\-\-width\fR without a number
 125 implies 32.  By default, od uses \fB\-A\fR o \fB\-t\fR d2 \fB\-w16\fR.
 126 .SH AUTHOR
 127 Written by Jim Meyering.
 128 .SH "REPORTING BUGS"
 129 Report bugs to <bug\-coreutils@gnu.org>.
 130 .SH COPYRIGHT
 131 Copyright \(co 2007 Free Software Foundation, Inc.
 132 .br
 133 This is free software.  You may redistribute copies of it under the terms of
 134 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
 135 There is NO WARRANTY, to the extent permitted by law.
 136 .SH "SEE ALSO"
 137 The full documentation for
 138 .B od
 139 is maintained as a Texinfo manual.  If the
 140 .B info
 141 and
 142 .B od
 143 programs are properly installed at your site, the command
 144 .IP
 145 .B info od
 146 .PP
 147 should give you access to the complete manual.