original/man1/od.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH OD "1" "January 2016" "GNU coreutils 8.25" "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 output strings of at least BYTES graphic chars;
  47 3 is implied when BYTES is not specified
  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 integer
 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 F for sizeof(float), D
 124 for sizeof(double) or L for sizeof(long double).
 125 .PP
 126 Adding a z suffix to any type displays printable characters at the end of
 127 each output line.
 128 .SS "BYTES is hex with 0x or 0X prefix, and may have a multiplier suffix:"
 129 .TP
 130 b
 131 512
 132 .TP
 133 KB
 134 1000
 135 .TP
 136 K
 137 1024
 138 .TP
 139 MB
 140 1000*1000
 141 .TP
 142 M
 143 1024*1024
 144 .PP
 145 and so on for G, T, P, E, Z, Y.
 146 .SH EXAMPLES
 147 .TP
 148 .B od -A x -t x1z -v
 149 Display hexdump format output
 150 .TP
 151 .B od -A o -t oS -w16
 152 The default output format used by od
 153 .SH AUTHOR
 154 Written by Jim Meyering.
 155 .SH "REPORTING BUGS"
 156 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
 157 .br
 158 Report od translation bugs to <http://translationproject.org/team/>
 159 .SH COPYRIGHT
 160 Copyright \(co 2016 Free Software Foundation, Inc.
 161 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 162 .br
 163 This is free software: you are free to change and redistribute it.
 164 There is NO WARRANTY, to the extent permitted by law.
 165 .SH "SEE ALSO"
 166 Full documentation at: <http://www.gnu.org/software/coreutils/od>
 167 .br
 168 or available locally via: info \(aq(coreutils) od invocation\(aq