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