aboutsummaryrefslogtreecommitdiff
path: root/coreutils-5.3.0-bin/man/cat1/od.1.txt
blob: 7e73270558924b67fe5e9b9bef5001c780067b3d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
OD(1)                    User Commands                    OD(1)





NAME
       od - dump files in octal and other formats

SYNOPSIS
       od [OPTION]... [FILE]...
       od [-abcdfilosx]... [FILE] [[+]OFFSET[.][b]]
       od  --traditional  [OPTION]...  [FILE]  [[+]OFFSET[.][b]
       [+][LABEL][.][b]]

DESCRIPTION
       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.  With no FILE, or when FILE is -, read
       standard input.

       All arguments to long options are  mandatory  for  short
       options.

       -A, --address-radix=RADIX
              decide how file offsets are printed

       -j, --skip-bytes=BYTES
              skip BYTES input bytes first

       -N, --read-bytes=BYTES
              limit dump to BYTES input bytes

       -S, --strings[=BYTES]
              output strings of at least BYTES graphic chars

       -t, --format=TYPE
              select output format or formats

       -v, --output-duplicates
              do not use * to mark line suppression

       -w, --width[=BYTES]
              output BYTES bytes per output line

       --traditional
              accept arguments in traditional form

       --help display this help and exit

       --version
              output version information and exit

   Traditional  format  specifications  may be intermixed; they
       accumulate:
       -a     same as -t a,  select named characters

       -b     same as -t o1, select octal bytes

       -c     same as -t c,  select ASCII characters  or  back-
              slash escapes

       -d     same  as  -t  u2,  select unsigned decimal 2-byte
              units

       -f     same as -t fF, select floats

       -i     same as -t dI, select decimal ints

       -l     same as -t dL, select decimal longs

       -o     same as -t o2, select octal 2-byte units

       -s     same as -t d2, select decimal 2-byte units

       -x     same as -t x2, select hexadecimal 2-byte units

       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  -j  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 hexadeci-
       mal; suffixes may be . for octal and b for  multiply  by
       512.

       TYPE is made up of one or more of these specifications:

       a      named character

       c      ASCII character or backslash escape

       d[SIZE]
              signed decimal, SIZE bytes per integer

       f[SIZE]
              floating point, SIZE bytes per integer

       o[SIZE]
              octal, SIZE bytes per integer

       u[SIZE]
              unsigned decimal, SIZE bytes per integer

       x[SIZE]
              hexadecimal, SIZE bytes per integer

       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).

       RADIX  is  d for decimal, o for octal, x for hexadecimal
       or n for none.  BYTES is hexadecimal with 0x or 0X  pre-
       fix, it is multiplied by 512 with b suffix, by 1024 with
       k and by 1048576 with m.  Adding a z suffix to any  type
       adds  a  display  of  printable characters to the end of
       each line of output.  --string without a number  implies
       3.  --width without a number implies 32.  By default, od
       uses -A o -t d2 -w 16.

AUTHOR
       Written by Jim Meyering.

REPORTING BUGS
       Report bugs to <bug-coreutils@gnu.org>.

COPYRIGHT
       Copyright (C) 2004 Free Software Foundation, Inc.
       This is free software; see the source for copying condi-
       tions.  There is NO warranty; not even for MERCHANTABIL-
       ITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO
       The full documentation for od is maintained as a Texinfo
       manual.   If  the  info  and  od  programs  are properly
       installed at your site, the command

              info od

       should give you access to the complete manual.



od 5.3.0                 November 2004                    OD(1)