annotate runtime/doc/xxd.1 @ 34074:1629cc65d78d v9.1.0006

patch 9.1.0006: is*() and to*() function may be unsafe Commit: https://github.com/vim/vim/commit/184f71cc6868a240dc872ed2852542bbc1d43e28 Author: Keith Thompson <Keith.S.Thompson@gmail.com> Date: Thu Jan 4 21:19:04 2024 +0100 patch 9.1.0006: is*() and to*() function may be unsafe Problem: is*() and to*() function may be unsafe Solution: Add SAFE_* macros and start using those instead (Keith Thompson) Use SAFE_() macros for is*() and to*() functions The standard is*() and to*() functions declared in <ctype.h> have undefined behavior for negative arguments other than EOF. If plain char is signed, passing an unchecked value from argv for from user input to one of these functions has undefined behavior. Solution: Add SAFE_*() macros that cast the argument to unsigned char. Most implementations behave sanely for negative arguments, and most character values in practice are non-negative, but it's still best to avoid undefined behavior. The change from #13347 has been omitted, as this has already been separately fixed in commit ac709e2fc0db6d31abb7da96f743c40956b60c3a (v9.0.2054) fixes: #13332 closes: #13347 Signed-off-by: Keith Thompson <Keith.S.Thompson@gmail.com> Signed-off-by: Christian Brabandt <cb@256bit.org>
author Christian Brabandt <cb@256bit.org>
date Thu, 04 Jan 2024 21:30:04 +0100
parents 33cbd544dc46
children 42f061099b39
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1 .TH XXD 1 "August 1996" "Manual page for xxd"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2 .\"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3 .\" 21st May 1996
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 .\" Man page author:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5 .\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6 .\" Changes by Bram Moolenaar <Bram@vim.org>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 .SH NAME
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8 .I xxd
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
9 \- make a hex dump or do the reverse.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 .SH SYNOPSIS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 .B xxd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 \-h[elp]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 .B xxd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 [options] [infile [outfile]]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 .B xxd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 \-r[evert] [options] [infile [outfile]]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 .SH DESCRIPTION
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 .I xxd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 creates a hex dump of a given file or standard input.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22 It can also convert a hex dump back to its original binary form.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 Like
216
da182deebec7 updated for version 7.0061
vimboss
parents: 36
diff changeset
24 .BR uuencode (1)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 and
216
da182deebec7 updated for version 7.0061
vimboss
parents: 36
diff changeset
26 .BR uudecode (1)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 it allows the transmission of binary data in a `mail-safe' ASCII representation,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 but has the advantage of decoding to standard output.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 Moreover, it can be used to perform binary file patching.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 .SH OPTIONS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 If no
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 .I infile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 is given, standard input is read.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 If
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 .I infile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 is specified as a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 .RB \` \- '
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 character, then input is taken from standard input.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 If no
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 .I outfile
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 is given (or a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 .RB \` \- '
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 character is in its place), results are sent to standard output.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 Note that a "lazy" parser is used which does not check for more than the first
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 option letter, unless the option is followed by a parameter.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 Spaces between a single option letter and its parameter are optional.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 Parameters to options can be specified in decimal, hexadecimal or octal
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 notation.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 Thus
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 .BR \-c8 ,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 .BR "\-c 8" ,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 .B \-c 010
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 .B \-cols 8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 are all equivalent.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59 .IR \-a " | " \-autoskip
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
60 Toggle autoskip: A single '*' replaces NUL-lines. Default off.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 .IR \-b " | " \-bits
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
63 Switch to bits (binary digits) dump, rather than hex dump.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 This option writes octets as eight digits "1"s and "0"s instead of a normal
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
65 hexadecimal dump. Each line is preceded by a line number in hexadecimal and
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
66 followed by an ASCII (or EBCDIC) representation. The command line switches
33496
33cbd544dc46 patch 9.0.1998: xxd: cannot reverse a bit dump
Christian Brabandt <cb@256bit.org>
parents: 33444
diff changeset
67 \-p, \-i do not work with this mode.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69 .IR "\-c cols " | " \-cols cols"
13571
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
70 Format
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 .RI < cols >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72 octets per line. Default 16 (\-i: 12, \-ps: 30, \-b: 6). Max 256.
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
73 No maximum for \-ps. With \-ps, 0 results in one long line of output.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 .TP
13571
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
75 .IR \-C " | " \-capitalize
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
76 Capitalize variable names in C include file style, when using \-i.
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
77 .TP
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78 .IR \-E " | " \-EBCDIC
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 Change the character encoding in the righthand column from ASCII to EBCDIC.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 This does not change the hexadecimal representation. The option is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 meaningless in combinations with \-r, \-p or \-i.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 .TP
6655
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
83 .IR \-e
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
84 Switch to little-endian hex dump.
6655
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
85 This option treats byte groups as words in little-endian byte order.
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
86 The default grouping of 4 bytes may be changed using
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
87 .RI "" \-g .
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
88 This option only applies to the hex dump, leaving the ASCII (or EBCDIC)
6655
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
89 representation unchanged.
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
90 The command line switches
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
91 \-r, \-p, \-i do not work with this mode.
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
92 .TP
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 .IR "\-g bytes " | " \-groupsize bytes"
13571
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
94 Separate the output of every
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 .RI < bytes >
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
96 bytes (two hex characters or eight bit digits each) by a whitespace.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 Specify
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98 .I \-g 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 to suppress grouping.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 .RI < Bytes "> defaults to " 2
6655
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
101 in normal mode, \fI4\fP in little-endian mode and \fI1\fP in bits mode.
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
102 Grouping does not apply to PostScript or include style.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 .IR \-h " | " \-help
13571
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
105 Print a summary of available commands and exit. No hex dumping is performed.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 .IR \-i " | " \-include
13571
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
108 Output in C include file style. A complete static array definition is written
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 (named after the input file), unless xxd reads from stdin.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111 .IR "\-l len " | " \-len len"
13571
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
112 Stop after writing
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113 .RI < len >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 octets.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 .TP
29330
948c947cb1ed patch 9.0.0008: cannot specify the variable name for "xxd -i"
Bram Moolenaar <Bram@vim.org>
parents: 27118
diff changeset
116 .I "\-n name " | " \-name name"
948c947cb1ed patch 9.0.0008: cannot specify the variable name for "xxd -i"
Bram Moolenaar <Bram@vim.org>
parents: 27118
diff changeset
117 Override the variable name output when \-i is used. The array is named
948c947cb1ed patch 9.0.0008: cannot specify the variable name for "xxd -i"
Bram Moolenaar <Bram@vim.org>
parents: 27118
diff changeset
118 \fIname\fP and the length is named \fIname\fP_len.
948c947cb1ed patch 9.0.0008: cannot specify the variable name for "xxd -i"
Bram Moolenaar <Bram@vim.org>
parents: 27118
diff changeset
119 .TP
6655
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
120 .I \-o offset
13571
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
121 Add
6655
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
122 .RI < offset >
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
123 to the displayed file position.
6c94cedccda4 updated for version 7.4.652
Bram Moolenaar <bram@vim.org>
parents: 1125
diff changeset
124 .TP
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 .IR \-p " | " \-ps " | " \-postscript " | " \-plain
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
126 Output in PostScript continuous hex dump style. Also known as plain hex dump
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 style.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 .IR \-r " | " \-revert
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
130 Reverse operation: convert (or patch) hex dump into binary.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 If not writing to stdout, xxd writes into its output file without truncating
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 it. Use the combination
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 .I \-r \-p
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134 to read plain hexadecimal dumps without line number information and without a
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
135 particular column layout. Additional whitespace and line breaks are allowed
33496
33cbd544dc46 patch 9.0.1998: xxd: cannot reverse a bit dump
Christian Brabandt <cb@256bit.org>
parents: 33444
diff changeset
136 anywhere. Use the combination
33cbd544dc46 patch 9.0.1998: xxd: cannot reverse a bit dump
Christian Brabandt <cb@256bit.org>
parents: 33444
diff changeset
137 .I \-r \-b
33cbd544dc46 patch 9.0.1998: xxd: cannot reverse a bit dump
Christian Brabandt <cb@256bit.org>
parents: 33444
diff changeset
138 to read a bits dump instead of a hex dump.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
139 .TP
33099
49f317597430 patch 9.0.1834: Some problems with xxd coloring
Christian Brabandt <cb@256bit.org>
parents: 33083
diff changeset
140 .IR \-R " " when
33444
0a2c50b59f30 runtime(doc): update xxd manpage and mention $NO_COLOR env
Christian Brabandt <cb@256bit.org>
parents: 33099
diff changeset
141 In output the hex-value and the value are both colored with the same color
0a2c50b59f30 runtime(doc): update xxd manpage and mention $NO_COLOR env
Christian Brabandt <cb@256bit.org>
parents: 33099
diff changeset
142 depending on the hex-value. Mostly helping to differentiate printable and
0a2c50b59f30 runtime(doc): update xxd manpage and mention $NO_COLOR env
Christian Brabandt <cb@256bit.org>
parents: 33099
diff changeset
143 non-printable characters.
33099
49f317597430 patch 9.0.1834: Some problems with xxd coloring
Christian Brabandt <cb@256bit.org>
parents: 33083
diff changeset
144 .I \fIwhen\fP
33083
79b2eb83f2df patch 9.0.1827: xxd: no color support
Christian Brabandt <cb@256bit.org>
parents: 32780
diff changeset
145 is
79b2eb83f2df patch 9.0.1827: xxd: no color support
Christian Brabandt <cb@256bit.org>
parents: 32780
diff changeset
146 .BR never ", " always ", or " auto .
33444
0a2c50b59f30 runtime(doc): update xxd manpage and mention $NO_COLOR env
Christian Brabandt <cb@256bit.org>
parents: 33099
diff changeset
147 When the
0a2c50b59f30 runtime(doc): update xxd manpage and mention $NO_COLOR env
Christian Brabandt <cb@256bit.org>
parents: 33099
diff changeset
148 .BR $NO_COLOR
0a2c50b59f30 runtime(doc): update xxd manpage and mention $NO_COLOR env
Christian Brabandt <cb@256bit.org>
parents: 33099
diff changeset
149 environment variable is set, colorization will be disabled.
33083
79b2eb83f2df patch 9.0.1827: xxd: no color support
Christian Brabandt <cb@256bit.org>
parents: 32780
diff changeset
150 .TP
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
151 .I \-seek offset
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
152 When used after
216
da182deebec7 updated for version 7.0061
vimboss
parents: 36
diff changeset
153 .IR \-r :
da182deebec7 updated for version 7.0061
vimboss
parents: 36
diff changeset
154 revert with
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155 .RI < offset >
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
156 added to file positions found in hex dump.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
157 .TP
216
da182deebec7 updated for version 7.0061
vimboss
parents: 36
diff changeset
158 .I \-s [+][\-]seek
13571
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
159 Start at
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160 .RI < seek >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161 bytes abs. (or rel.) infile offset.
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 810
diff changeset
162 \fI+ \fRindicates that the seek is relative to the current stdin file position
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
163 (meaningless when not reading from stdin). \fI\- \fRindicates that the seek
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164 should be that many characters from the end of the input (or if combined with
216
da182deebec7 updated for version 7.0061
vimboss
parents: 36
diff changeset
165 \fI+\fR: before the current stdin file position).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
166 Without \-s option, xxd starts at the current file position.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 .I \-u
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
169 Use upper-case hex letters. Default is lower-case.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171 .IR \-v " | " \-version
13571
362b27e3f702 patch 8.0.1658: capitalize argument not available in long form
Christian Brabandt <cb@256bit.org>
parents: 6655
diff changeset
172 Show version string.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
173 .SH CAVEATS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
174 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
175 .I xxd \-r
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
176 has some built-in magic while evaluating line number information.
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
177 If the output file is seekable, then the line numbers at the start of each
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
178 hex dump line may be out of order, lines may be missing, or overlapping. In
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
179 these cases xxd will lseek(2) to the next position. If the output file is not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
180 seekable, only gaps are allowed, which will be filled by null-bytes.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
181 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
182 .I xxd \-r
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
183 never generates parse errors. Garbage is silently skipped.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 .PP
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
185 When editing hex dumps, please note that
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186 .I xxd \-r
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 skips everything on the input line after reading enough columns of hexadecimal
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
188 data (see option \-c). This also means that changes to the printable ASCII (or
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
189 EBCDIC) columns are always ignored. Reverting a plain (or PostScript) style
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
190 hex dump with xxd \-r \-p does not depend on the correct number of columns. Here, anything that looks like a pair of hex digits is interpreted.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
191 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
192 Note the difference between
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
193 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
194 \fI% xxd \-i file\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
195 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
196 and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
197 .br
216
da182deebec7 updated for version 7.0061
vimboss
parents: 36
diff changeset
198 \fI% xxd \-i < file\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
199 .PP
810
9f345c48220b updated for version 7.0c
vimboss
parents: 216
diff changeset
200 .I xxd \-s +seek
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
201 may be different from
216
da182deebec7 updated for version 7.0061
vimboss
parents: 36
diff changeset
202 .IR "xxd \-s seek" ,
da182deebec7 updated for version 7.0061
vimboss
parents: 36
diff changeset
203 as lseek(2) is used to "rewind" input. A '+'
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
204 makes a difference if the input source is stdin, and if stdin's file position
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
205 is not at the start of the file by the time xxd is started and given its input.
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
206 The following examples may help to clarify (or further confuse!):
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
207 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
208 Rewind stdin before reading; needed because the `cat' has already read to the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
209 end of stdin.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
210 .br
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 810
diff changeset
211 \fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
212 .PP
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
213 Hex dump from file position 0x480 (=1024+128) onwards.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
214 The `+' sign means "relative to the current position", thus the `128' adds to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
215 the 1k where dd left off.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
216 .br
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 810
diff changeset
217 \fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet" < file\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
218 .PP
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
219 Hex dump from file position 0x100 (=1024\-768) onwards.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
220 .br
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 810
diff changeset
221 \fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 > hex_snippet" < file\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
222 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
223 However, this is a rare situation and the use of `+' is rarely needed.
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
224 The author prefers to monitor the effect of xxd with strace(1) or truss(1), whenever \-s is used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
225 .SH EXAMPLES
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
226 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
227 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
228 Print everything but the first three lines (hex 0x30 bytes) of
810
9f345c48220b updated for version 7.0c
vimboss
parents: 216
diff changeset
229 .BR file .
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
230 .br
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 810
diff changeset
231 \fI% xxd \-s 0x30 file\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
232 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
233 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
234 Print 3 lines (hex 0x30 bytes) from the end of
810
9f345c48220b updated for version 7.0c
vimboss
parents: 216
diff changeset
235 .BR file .
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236 .br
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 810
diff changeset
237 \fI% xxd \-s \-0x30 file\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
238 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
239 .br
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
240 Print 120 bytes as a continuous hex dump with 20 octets per line.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
241 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
242 \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
243 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
244 2e54482058584420312022417567757374203139
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
245 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
246 39362220224d616e75616c207061676520666f72
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
247 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
248 20787864220a2e5c220a2e5c222032317374204d
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
249 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
250 617920313939360a2e5c22204d616e2070616765
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
251 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
252 20617574686f723a0a2e5c2220202020546f6e79
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
253 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
254 204e7567656e74203c746f6e79407363746e7567
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
255 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
256
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
257 .br
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
258 Hex dump the first 120 bytes of this man page with 12 octets per line.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
259 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
260 \fI% xxd \-l 120 \-c 12 xxd.1\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
261 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
262 0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
263 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
264 000000c: 7567 7573 7420 3139 3936 2220 ugust 1996"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
265 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
266 0000018: 224d 616e 7561 6c20 7061 6765 "Manual page
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
267 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
268 0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
269 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
270 0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
271 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
272 000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
273 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
274 0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
275 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
276 0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
277 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
278 0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
279 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
280 000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
281 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
282 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
283 Display just the date from the file xxd.1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
284 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
285 \fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
286 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
287 0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
290 Copy
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
291 .B input_file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
292 to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
293 .B output_file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
294 and prepend 100 bytes of value 0x00.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
295 .br
810
9f345c48220b updated for version 7.0c
vimboss
parents: 216
diff changeset
296 \fI% xxd input_file | xxd \-r \-s 100 > output_file\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
298
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300 Patch the date in the file xxd.1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 .br
810
9f345c48220b updated for version 7.0c
vimboss
parents: 216
diff changeset
302 \fI% echo "0000037: 3574 68" | xxd \-r \- xxd.1\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
304 \fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
305 .br
36
125e80798a85 updated for version 7.0021
vimboss
parents: 7
diff changeset
306 0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
307 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
308 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
309 Create a 65537 byte file with all bytes 0x00,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
310 except for the last one which is 'A' (hex 0x41).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
311 .br
810
9f345c48220b updated for version 7.0c
vimboss
parents: 216
diff changeset
312 \fI% echo "010000: 41" | xxd \-r > file\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
313 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
314 .br
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
315 Hex dump this file with autoskip.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
316 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
317 \fI% xxd \-a \-c 12 file\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
318 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
319 0000000: 0000 0000 0000 0000 0000 0000 ............
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
320 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
321 *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
322 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
323 000fffc: 0000 0000 40 ....A
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
324 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
325 Create a 1 byte file containing a single 'A' character.
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
326 The number after '\-r \-s' adds to the line numbers found in the file;
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
327 in effect, the leading bytes are suppressed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
328 .br
810
9f345c48220b updated for version 7.0c
vimboss
parents: 216
diff changeset
329 \fI% echo "010000: 41" | xxd \-r \-s \-0x10000 > file\fR
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
330 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
331 Use xxd as a filter within an editor such as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
332 .B vim(1)
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
333 to hex dump a region marked between `a' and `z'.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
334 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
335 \fI:'a,'z!xxd\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
336 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
337 Use xxd as a filter within an editor such as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
338 .B vim(1)
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
339 to recover a binary hex dump marked between `a' and `z'.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
340 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
341 \fI:'a,'z!xxd \-r\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
342 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
343 Use xxd as a filter within an editor such as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
344 .B vim(1)
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
345 to recover one line of a hex dump. Move the cursor over the line and type:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
346 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
347 \fI!!xxd \-r\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
348 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
349 Read single characters from a serial line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
350 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
351 \fI% xxd \-c1 < /dev/term/b &\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
352 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
353 \fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
354 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
355 \fI% echo \-n foo > /dev/term/b\fR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
356 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
357 .SH "RETURN VALUES"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
358 The following error values are returned:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
359 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
360 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
361 no errors encountered.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
362 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
363 \-1
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
364 operation not supported
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
365 \%(\c
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
366 .I \%xxd \-r \-i
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
367 still impossible).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
368 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
369 1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
370 error while parsing options.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
371 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
372 2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
373 problems with input file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
374 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
375 3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
376 problems with output file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
377 .TP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
378 4,5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
379 desired seek position is unreachable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
380 .SH "SEE ALSO"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
381 uuencode(1), uudecode(1), patch(1)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
382 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
383 .SH WARNINGS
32780
36c49f10843b patch 9.0.1706: typos in the xxd manpage
Christian Brabandt <cb@256bit.org>
parents: 29330
diff changeset
384 The tool's weirdness matches its creator's brain.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
385 Use entirely at your own risk. Copy files. Trace it. Become a wizard.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
386 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
387 .SH VERSION
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
388 This manual page documents xxd version 1.7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
389 .SH AUTHOR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
390 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
391 (c) 1990-1997 by Juergen Weigert
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
392 .br
810
9f345c48220b updated for version 7.0c
vimboss
parents: 216
diff changeset
393 <jnweiger@informatik.uni\-erlangen.de>
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
394 .LP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
395 Distribute freely and credit me,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
396 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
397 make money and share with me,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
398 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
399 lose money and don't ask me.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
400 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
401 Manual page started by Tony Nugent
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
402 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
403 <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
404 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
405 Small changes by Bram Moolenaar.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
406 Edited by Juergen Weigert.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
407 .PP