source: trunk/coreutils/man/od.1@ 2746

Last change on this file since 2746 was 2554, checked in by bird, 20 years ago

coretuils-5.94

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