original/man1/od.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH OD "1" "March 2012" "GNU coreutils 8.16" "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 BYTES, \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[BYTES]\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, and may have a multiplier suffix:
 122 b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024,
 123 GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y.
 124 Adding a z suffix to any type displays printable characters at the end of each
 125 output line.
 126 Option \fB\-\-string\fR without a number implies 3; option \fB\-\-width\fR without a number
 127 implies 32.  By default, od uses \fB\-A\fR o \fB\-t\fR oS \fB\-w16\fR.
 128 .SH AUTHOR
 129 Written by Jim Meyering.
 130 .SH "REPORTING BUGS"
 131 Report od bugs to bug\-coreutils@gnu.org
 132 .br
 133 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
 134 .br
 135 General help using GNU software: <http://www.gnu.org/gethelp/>
 136 .br
 137 Report od translation bugs to <http://translationproject.org/team/>
 138 .SH COPYRIGHT
 139 Copyright \(co 2012 Free Software Foundation, Inc.
 140 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 141 .br
 142 This is free software: you are free to change and redistribute it.
 143 There is NO WARRANTY, to the extent permitted by law.
 144 .SH "SEE ALSO"
 145 The full documentation for
 146 .B od
 147 is maintained as a Texinfo manual.  If the
 148 .B info
 149 and
 150 .B od
 151 programs are properly installed at your site, the command
 152 .IP
 153 .B info coreutils \(aqod invocation\(aq
 154 .PP
 155 should give you access to the complete manual.