|
5178
|
1 .TH XXD 1 "August 1996" "Manual page for xxd"
|
|
|
2 .\"
|
|
|
3 .\" 21st May 1996
|
|
|
4 .\" Man page author:
|
|
|
5 .\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
|
|
|
6 .\" Changes by Bram Moolenaar <Bram@vim.org>
|
|
|
7 .SH 名前
|
|
|
8 .I xxd
|
|
|
9 \- 16 進ダンプを作成したり、元に戻したり。
|
|
|
10 .SH 書式
|
|
|
11 .B xxd
|
|
|
12 \-h[elp]
|
|
|
13 .br
|
|
|
14 .B xxd
|
|
|
15 [options] [infile [outfile]]
|
|
|
16 .br
|
|
|
17 .B xxd
|
|
|
18 \-r[evert] [options] [infile [outfile]]
|
|
|
19 .SH 説明
|
|
|
20 ファイルや標準入力から 16 進ダンプを作成します。
|
|
|
21 16 進ダンプから元のバイナリに戻すこともできます。
|
|
|
22 .BR uuencode (1)
|
|
|
23 や
|
|
|
24 .BR uudecode (1)
|
|
|
25 のように、バイナリデータを、メールに貼り付け可能な ASCII 形式に変換できた
|
|
|
26 り、標準出力に出力することもできます。
|
|
|
27 さらに、バイナリファイルにパッチを当てるという使い方もできます。
|
|
|
28 .SH オプション
|
|
|
29 .I infile
|
|
|
30 を指定しなかった場合は、標準入力が読み込まれます。
|
|
|
31 .I infile
|
|
|
32 に
|
|
|
33 .RB \` \- '
|
|
|
34 を指定した場合も、標準入力から読み込まれます。
|
|
|
35 .I outfile
|
|
|
36 を指定しなかった (または
|
|
|
37 .RB \` \- '
|
|
|
38 を指定した) 場合は、標準出力に出力されます。
|
|
|
39 .PP
|
|
|
40 引数の解釈処理は適当なので注意してください。パラメータを取らない引数は
|
|
|
41 最初の一文字だけチェックされます。
|
|
|
42 引数の文字とパラメータの間のスペースは省略可能です。
|
|
|
43 パラメータは 10 進数、16 進数、8 進数で指定できます。
|
|
|
44 .BR \-c8
|
|
|
45 、
|
|
|
46 .BR "\-c 8"
|
|
|
47 、
|
|
|
48 .B \-c 010
|
|
|
49 、
|
|
|
50 .B \-cols 8
|
|
|
51 はすべて同じ意味です。
|
|
|
52 .PP
|
|
|
53 .TP
|
|
|
54 .IR \-a " | " \-autoskip
|
|
|
55 オートスキップ: 連続した nul 行を一つの '*' で置き換える。
|
|
|
56 .TP
|
|
|
57 .IR \-b " | " \-bits
|
|
|
58 ビット (2進数) ダンプ。
|
|
|
59 1 オクテットが "1" と "0" の 8 文字で出力されます。
|
|
|
60 各行の行頭には 16 進数の行番号が表示されます。
|
|
|
61 行末には ascii (または ebcdic) で表した場合の文字が表示されます。
|
|
|
62 このモードでは \-r、\-p、\-i は機能しません。
|
|
|
63 .TP
|
|
|
64 .IR "\-c cols " | " \-cols cols"
|
|
|
65 一行
|
|
|
66 .RI < cols >
|
|
|
67 オクテットで出力する。標準設定は 16 (\-i: 12, \-ps: 30, \-b: 6)。最大 256。
|
|
|
68 .TP
|
|
|
69 .IR \-E " | " \-EBCDIC
|
|
|
70 右端に出力される文字のエンコーディングを ASCII から EBCDIC に変更する。
|
|
|
71 16 進ダンプの出力形式は変更されません。
|
|
|
72 \-r、\-p、\-i が同時に指定された場合は何の効果もありません。
|
|
|
73 .TP
|
|
|
74 .IR "\-g bytes " | " \-groupsize bytes"
|
|
|
75 出力を
|
|
|
76 .RI < bytes >
|
|
|
77 バイト (2 文字の 16 進数、または 8 文字の 2 進数) ごとにスペースで区切りま
|
|
|
78 す。
|
|
|
79 区切らずに出力するには
|
|
|
80 .I \-g 0
|
|
|
81 を指定してください。
|
|
|
82 .RI < Bytes >
|
|
|
83 の標準設定は \fI2\fP です。2 進ダンプの場合は \fI1\fP です。
|
|
|
84 ポストスクリプト形式やインクルード形式で出力するときは、このオプションは使わ
|
|
|
85 れません。
|
|
|
86 .TP
|
|
|
87 .IR \-h " | " \-help
|
|
|
88 コマンドの説明を出力して終了する。変換は実行されません。
|
|
|
89 .TP
|
|
|
90 .IR \-i " | " \-include
|
|
|
91 C インクルードファイル形式で出力します。入力ファイルの名前が付けられた静的配
|
|
|
92 列の定義が出力されます。標準入力の場合は定義の中身だけ出力されます。
|
|
|
93 .TP
|
|
|
94 .IR "\-l len " | " \-len len"
|
|
|
95 .RI < len >
|
|
|
96 オクテットだけ出力する。
|
|
|
97 .TP
|
|
|
98 .IR \-p " | " \-ps " | " \-postscript " | " \-plain
|
|
|
99 ポストスクリプト形式の 16 進ダンプを出力する。別名 プレーン 16 進ダンプ。
|
|
|
100 .TP
|
|
|
101 .IR \-r " | " \-revert
|
|
|
102 元に戻す: 16 進ダンプからバイナリ形式に変換 (またはパッチ) します。
|
|
|
103 ファイルへ出力する場合、出力先のファイルは切り詰めされません。
|
|
|
104 行番号や特定の書式がないプレーン 16 進ダンプを読み込む場合は、
|
|
|
105 .I \-r \-p
|
|
|
106 を指定してください。空白と改行は無視されます。
|
|
|
107 .TP
|
|
|
108 .I \-seek offset
|
|
|
109 .IR \-r
|
|
|
110 の後で使われた場合: 16 進ダンプを出力するファイルの位置に
|
|
|
111 .RI < offset >
|
|
|
112 を加える。
|
|
|
113 .TP
|
|
|
114 .I \-s [+][\-]seek
|
|
|
115 infile の
|
|
|
116 .RI < seek >
|
|
|
117 バイト目 (絶対位置、または相対位置) から開始する。
|
|
|
118 \fI+ \fRは、現在の標準入力の位置から相対的な位置を示します
|
|
|
119 (標準入力から読み込むときのみ意味があります)。\fI\- \fRは、入力の終わりから
|
|
|
120 の文字数を示します (\fI+\fR と同時に指定した場合は、現在の標準入力の位置から
|
|
|
121 手前の位置を示します)。
|
|
|
122 \-s 引数を指定しなかった場合は、現在のファイル位置から開始されます。
|
|
|
123 .TP
|
|
|
124 .I \-u
|
|
|
125 16 進数の表記に大文字を使います。指定がない場合は小文字で出力されます。
|
|
|
126 .TP
|
|
|
127 .IR \-v " | " \-version
|
|
|
128 バージョンを表示します。
|
|
|
129 .SH 警告
|
|
|
130 .PP
|
|
|
131 .I xxd \-r
|
|
|
132 では行番号の評価に関しての暗黙のルールがいくつかあります。
|
|
|
133 出力ファイルがシーク可能なら、各行の行番号が順番通りに並んでなくても構いませ
|
|
|
134 ん。位置が飛んでいても重なっていても大丈夫です。その場合、次の位置に移動する
|
|
|
135 ために lseek(2) が使われます。
|
|
|
136 出力ファイルがシーク不可なら、「隙間」だけが処理可能です。隙間は null バイト
|
|
|
137 で埋められます。
|
|
|
138 .PP
|
|
|
139 .I xxd \-r
|
|
|
140 は不正な入力をエラーにしません。ゴミは静かに読み飛ばされます。
|
|
|
141 .PP
|
|
|
142 16 進ダンプを編集するときは注意が必要です。
|
|
|
143 .I xxd \-r
|
|
|
144 は必要な桁 (\-c 引数参照) だけ 16 進データを読み込んで、行の残りを無視しま
|
|
|
145 す。つまり、ascii (または ebcdic) を示している列への変更は無視されます。
|
|
|
146 xxd \-r \-p でプレーン形式 (ポストスクリプト形式) の 16 進ダンプを元に戻す場
|
|
|
147 合は、列の数は影響しません。
|
|
|
148 2 桁の 16 進数と認識できるものはすべて変換されます。
|
|
|
149 .PP
|
|
|
150 \fI% xxd \-i file\fR
|
|
|
151 .br
|
|
|
152 と
|
|
|
153 .br
|
|
|
154 \fI% xxd \-i < file\fR
|
|
|
155 .br
|
|
|
156 の結果は違います。注意してください。
|
|
|
157 .PP
|
|
|
158 .I xxd \-s +seek
|
|
|
159 と
|
|
|
160 .IR "xxd \-s seek" ,
|
|
|
161 の違いは、lseek(2) を使って入力を "巻き戻す" かどうかです。'+' が意味を持つ
|
|
|
162 のは、入力が標準入力で、xxd が起動されたときに標準入力のファイル位置がファイ
|
|
|
163 ルの先頭ではなかった場合です。
|
|
|
164 以下の例が分かりやすいかもしれません (もっと混乱するかも!)...
|
|
|
165 .PP
|
|
|
166 `cat' が既に標準入力を終わりまで読んでいるので、読む前に標準入力を巻き戻す必
|
|
|
167 要がある。
|
|
|
168 .br
|
|
|
169 \fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR
|
|
|
170 .PP
|
|
|
171 ファイル位置 0x480 (=1024+128) 前方から 16 進ダンプする。
|
|
|
172 `+' は 「現在地からの相対位置」を意味するので、dd が 1k 処理した後から、さら
|
|
|
173 に `128' 進めます。
|
|
|
174 .br
|
|
|
175 \fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet" < file\fR
|
|
|
176 .PP
|
|
|
177 ファイル位置 0x100 ( = 1024\-768) から 16 進ダンプする。
|
|
|
178 .br
|
|
|
179 \fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 > hex_snippet" < file\fR
|
|
|
180 .PP
|
|
|
181 このような使い方はあまりしませんし、`+' を使うこともほとんどないでしょう。
|
|
|
182 \-s を使うときはいつでも、strace(1) や truss(1) を使って、xxd の働きをチェッ
|
|
|
183 クすることをお勧めします。
|
|
|
184 .SH 例
|
|
|
185 .PP
|
|
|
186 .br
|
|
|
187 .BR ファイル
|
|
|
188 の最初の三行 (16 進数で 0x30 バイト) 以降を出力する。
|
|
|
189 .br
|
|
|
190 \fI% xxd \-s 0x30 file\fR
|
|
|
191 .PP
|
|
|
192 .br
|
|
|
193 .BR ファイル
|
|
|
194 の最後から三行 (16 進数で 0x30 バイト) を出力する。
|
|
|
195 .br
|
|
|
196 \fI% xxd \-s \-0x30 file\fR
|
|
|
197 .PP
|
|
|
198 .br
|
|
|
199 120 バイトを、平文 16 進ダンプ形式で一行に 20 オクテットずつ出力する。
|
|
|
200 .br
|
|
|
201 \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR
|
|
|
202 .br
|
|
|
203 2e54482058584420312022417567757374203139
|
|
|
204 .br
|
|
|
205 39362220224d616e75616c207061676520666f72
|
|
|
206 .br
|
|
|
207 20787864220a2e5c220a2e5c222032317374204d
|
|
|
208 .br
|
|
|
209 617920313939360a2e5c22204d616e2070616765
|
|
|
210 .br
|
|
|
211 20617574686f723a0a2e5c2220202020546f6e79
|
|
|
212 .br
|
|
|
213 204e7567656e74203c746f6e79407363746e7567
|
|
|
214 .br
|
|
|
215
|
|
|
216 .br
|
|
|
217 この man ページの先頭から 120 バイトを一行に 12 オクテットずつ 16 進ダンプす
|
|
|
218 る。
|
|
|
219 .br
|
|
|
220 \fI% xxd \-l 120 \-c 12 xxd.1\fR
|
|
|
221 .br
|
|
|
222 0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A
|
|
|
223 .br
|
|
|
224 000000c: 7567 7573 7420 3139 3936 2220 ugust 1996"
|
|
|
225 .br
|
|
|
226 0000018: 224d 616e 7561 6c20 7061 6765 "Manual page
|
|
|
227 .br
|
|
|
228 0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\
|
|
|
229 .br
|
|
|
230 0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M
|
|
|
231 .br
|
|
|
232 000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\"
|
|
|
233 .br
|
|
|
234 0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut
|
|
|
235 .br
|
|
|
236 0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\"
|
|
|
237 .br
|
|
|
238 0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent
|
|
|
239 .br
|
|
|
240 000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug
|
|
|
241 .PP
|
|
|
242 .br
|
|
|
243 xxd.1 の日付部分だけを出力する。
|
|
|
244 .br
|
|
|
245 \fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
|
|
|
246 .br
|
|
|
247 0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996
|
|
|
248 .PP
|
|
|
249 .br
|
|
|
250 .B input_file
|
|
|
251 を
|
|
|
252 .B output_file
|
|
|
253 にコピーし、先頭に 0x00 を 100 バイト分付け加える。
|
|
|
254 .br
|
|
|
255 \fI% xxd input_file | xxd \-r \-s 100 > output_file\fR
|
|
|
256 .br
|
|
|
257
|
|
|
258 .br
|
|
|
259 xxd.1 の日付を修正する。
|
|
|
260 .br
|
|
|
261 \fI% echo "0000037: 3574 68" | xxd \-r \- xxd.1\fR
|
|
|
262 .br
|
|
|
263 \fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR
|
|
|
264 .br
|
|
|
265 0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996
|
|
|
266 .PP
|
|
|
267 .br
|
|
|
268 中身がすべて 0x00 の 65537 バイトのファイルを作成する。
|
|
|
269 ただし、最後のバイトだけは 'A' (hex 0x41)。
|
|
|
270 .br
|
|
|
271 \fI% echo "010000: 41" | xxd \-r > file\fR
|
|
|
272 .PP
|
|
|
273 .br
|
|
|
274 作成したファイルをオートスキップを使って 16 進ダンプする。
|
|
|
275 .br
|
|
|
276 \fI% xxd \-a \-c 12 file\fR
|
|
|
277 .br
|
|
|
278 0000000: 0000 0000 0000 0000 0000 0000 ............
|
|
|
279 .br
|
|
|
280 *
|
|
|
281 .br
|
|
|
282 000fffc: 0000 0000 40 ....A
|
|
|
283 .PP
|
|
|
284 一文字の 'A' からなる 1 バイトのファイルを作成する。
|
|
|
285 '\-r \-s' の後に指定した数値がファイル中の行番号に加算され、結果、余計なバ
|
|
|
286 イトが飛ばされる。
|
|
|
287 .br
|
|
|
288 \fI% echo "010000: 41" | xxd \-r \-s \-0x10000 > file\fR
|
|
|
289 .PP
|
|
|
290 .B vim(1)
|
|
|
291 の中から xxd をフィルタとして実行し、
|
|
|
292 マークされた `a' から `z' までの領域を 16 進ダンプする。
|
|
|
293 .br
|
|
|
294 \fI:'a,'z!xxd\fR
|
|
|
295 .PP
|
|
|
296 .B vim(1)
|
|
|
297 の中から xxd をフィルタとして実行し、
|
|
|
298 マークされた `a' から `z' までの領域をバイナリに戻す。
|
|
|
299 .br
|
|
|
300 \fI:'a,'z!xxd \-r\fR
|
|
|
301 .PP
|
|
|
302 .B vim(1)
|
|
|
303 の中から xxd をフィルタとして実行し、
|
|
|
304 16 進ダンプされた行を元に戻す。戻したい行にカーソルを移動して:
|
|
|
305 .br
|
|
|
306 \fI!!xxd \-r\fR
|
|
|
307 .PP
|
|
|
308 シリアル行から一文字読み込む
|
|
|
309 .br
|
|
|
310 \fI% xxd \-c1 < /dev/term/b &\fR
|
|
|
311 .br
|
|
|
312 \fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR
|
|
|
313 .br
|
|
|
314 \fI% echo \-n foo > /dev/term/b\fR
|
|
|
315 .PP
|
|
|
316 .SH 返り値
|
|
|
317 以下のエラー値が返ります:
|
|
|
318 .TP
|
|
|
319 0
|
|
|
320 エラーなし。
|
|
|
321 .TP
|
|
|
322 \-1
|
|
|
323 操作がサポートされていない (
|
|
|
324 .I xxd \-r \-i
|
|
|
325 はまだ不可です)。
|
|
|
326 .TP
|
|
|
327 1
|
|
|
328 引数の解釈に関するエラー。
|
|
|
329 .TP
|
|
|
330 2
|
|
|
331 入力ファイルに関する問題。
|
|
|
332 .TP
|
|
|
333 3
|
|
|
334 出力ファイルに関する問題。
|
|
|
335 .TP
|
|
|
336 4,5
|
|
|
337 指定された位置へシークできなかった。
|
|
|
338 .SH 関連項目
|
|
|
339 uuencode(1), uudecode(1), patch(1)
|
|
|
340 .br
|
|
|
341 .SH 警告
|
|
|
342 この奇妙なツールは作者が使いやすいように作られています。
|
|
|
343 自己責任で使ってください。ファイルをコピーし、それを調べ、ウィザードたれ。
|
|
|
344 .br
|
|
|
345 .SH バージョン
|
|
|
346 このマニュアルは xxd バージョン 1.7 について説明しています。
|
|
|
347 .SH 著者
|
|
|
348 .br
|
|
|
349 (c) 1990-1997 by Juergen Weigert
|
|
|
350 .br
|
|
|
351 <jnweiger@informatik.uni\-erlangen.de>
|
|
|
352 .LP
|
|
|
353 私の功績として自由に配布してください。
|
|
|
354 .br
|
|
|
355 儲かったら教えてください。
|
|
|
356 .br
|
|
|
357 損しても知りません。
|
|
|
358 .PP
|
|
|
359 マニュアルは Tony Nugent
|
|
|
360 .br
|
|
|
361 <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
|
|
|
362 .br
|
|
|
363 によって書かれ、
|
|
|
364 Bram Moolenaar が少し変更を加え、
|
|
|
365 Juergen Weigert が編集しました。
|
|
|
366 .PP
|
