vim

Fork of vim, an acceptable text editor
git clone git://git.laack.co/vim.git
Log | Files | Refs | README | LICENSE

xxd-ja.UTF-8.1 (13980B)


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