xxd-zh_CN.UTF-8.1 (11854B)
1 .TH XXD 1 "Mar 2026" "Manual page for xxd" 2 .\" 3 .\" 21st May 1996 4 .\" 手册页作者: 5 .\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> 6 .\" 由 Bram Moolenaar <Bram@vim.org> 修改 7 .SH 名称 8 .I xxd 9 \- 生成十六进制转储或执行反向操作 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 .I xxd 21 可以生成给定文件或标准输入的十六进制转储。 22 它也可以将十六进制转储还原回原始的二进制形式。 23 与 24 .BR uuencode (1) 25 和 26 .BR uudecode (1) 27 类似,它允许以"邮件安全"的 ASCII 表示形式传输二进制数据, 28 但其优点是可以解码到标准输出。 29 此外,它还可用于执行二进制文件修补。 30 .SH 选项 31 如果未指定 32 .I infile 33 ,则读取标准输入。 34 如果 35 .I infile 36 指定为 37 .RB \` \- ' 38 字符,则从标准输入读取输入。 39 如果未指定 40 .I outfile 41 (或其位置是 42 .RB \` \- ' 43 字符),则结果发送到标准输出。 44 .PP 45 注意:程序使用"懒惰"解析器,除非选项后跟有参数,否则不会检查超过第一个选项字母。 46 单个选项字母与其参数之间的空格是可选的。 47 选项参数可以用十进制、十六进制或八进制表示法指定。 48 因此 49 .BR \-c8 、 50 .BR "\-c 8" 、 51 .B \-c 010 52 和 53 .B \-cols 8 54 都是等效的。 55 .PP 56 .TP 57 .IR \-a " | " \-autoskip 58 切换自动跳过:单个 '*' 替换全零行。默认关闭。 59 .TP 60 .IR \-b " | " \-bits 61 切换到比特(二进制数字)转储,而非十六进制转储。 62 此选项将每个字节写为八个"1"和"0"数字,而不是普通的十六进制转储。 63 每行前面有十六进制的行号,后面跟着 ASCII(或 EBCDIC)表示形式。 64 命令行开关 \-p 在此模式下无效。可与 \-i 结合使用。 65 .TP 66 .IR "\-c cols " | " \-cols cols" 67 每行格式化 68 .RI < cols > 69 个字节。默认 16(\-i 模式: 12,\-ps 模式: 30,\-b 模式: 6)。最大 256。 70 \-ps 模式无最大值。在 \-ps 模式下,值为 0 时输出为单行。 71 .TP 72 .IR \-C " | " \-capitalize 73 使用 \-i 选项时,按 C 语言头文件(include file)的风格将变量名大写。 74 .TP 75 .I \-d 76 以十进制而非十六进制显示偏移量。 77 .TP 78 .IR \-E " | " \-EBCDIC 79 将右侧列的字符编码从 ASCII 更改为 EBCDIC。 80 这不会改变十六进制表示。此选项与 \-r、\-p 或 \-i 组合使用时无效。 81 .TP 82 .IR \-e 83 切换到小端序十六进制转储。 84 此选项将字节组视为小端字节序的字。 85 默认的 4 字节分组可通过 86 .RI "" \-g 87 更改。 88 此选项仅适用于十六进制转储,保持 ASCII(或 EBCDIC)表示不变。 89 命令行开关 \-r、\-p、\-i 在此模式下无效。 90 .TP 91 .IR "\-g bytes " | " \-groupsize bytes" 92 每隔 93 .RI < bytes > 94 个字节(每个字节对应两位十六进制字符或八位比特数字)用空格分隔输出。 95 指定 96 .I \-g 0 97 可取消分组。 98 .RI < Bytes > 99 在普通模式下默认为 \fI2\fP,在小端模式下为 \fI4\fP,在比特模式下为 \fI1\fP。 100 分组不适用于 PostScript 或 C 语言头文件(include)样式。 101 .TP 102 .IR \-h " | " \-help 103 打印可用命令摘要并退出。不执行十六进制转储。 104 .TP 105 .IR \-i " | " \-include 106 按 C 语言头文件(include file)的风格输出。 107 通常写入完整的静态数组定义(以输入文件命名),从 stdin 读取时除外。 108 可与 -b 共用。 109 .TP 110 .IR "\-l len " | " \-len len" 111 写入 112 .RI < len > 113 个字节后停止。 114 .TP 115 .I "\-n name " | " \-name name" 116 当使用 \-i 时覆盖输出的变量名。数组命名为 117 \fIname\fP,长度命名为 \fIname\fP_len。 118 .TP 119 .I \-o offset 120 将 121 .RI < offset > 122 添加到显示的文件位置。 123 .TP 124 .IR \-p " | " \-ps " | " \-postscript " | " \-plain 125 以 PostScript 连续十六进制转储样式输出。也称为纯十六进制转储样式。 126 .TP 127 .IR \-r " | " \-revert 128 反向操作:将十六进制转储转换(或修补)为二进制。 129 如果不写入标准输出,xxd 写入输出文件时不截断文件。 130 使用 131 .I \-r \-p 132 组合可以读取没有行号信息且无特定列布局的纯十六进制转储。 133 允许任意位置的额外空格和换行符。 134 使用 135 .I \-r \-b 136 组合可以读取比特转储而非十六进制转储。 137 .TP 138 .IR \-R " " when 139 在输出中,十六进制值和 ASCII 值根据十六进制值使用相同颜色着色。 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 当在 150 .IR \-r 151 之后使用时:还原时在十六进制转储中找到的文件位置上添加 152 .RI < offset >。 153 .TP 154 .I \-s [+][\-]seek 155 从 156 .RI < seek > 157 字节的绝对(或相对)输入文件偏移量处开始。 158 \fI+ \fR 表示偏移量相对于当前标准输入文件位置(不从标准输入读取时无效)。 159 \fI\- \fR 表示偏移量应从输入末尾向前计数多少字符(或与 \fI+\fR 组合时:在当前标准输入文件位置之前)。 160 如果不带 \-s 选项,xxd 从当前文件位置开始。 161 .TP 162 .I \-t 163 当使用 \-i 以 C 语言头文件(include file)的风格输出时,包含结尾的零字节。 164 .TP 165 .I \-u 166 使用大写十六进制字母。默认为小写。 167 .TP 168 .IR \-v " | " \-version 169 显示版本字符串。 170 .SH 注意事项 171 .PP 172 .I xxd \-r 173 在解析行号信息时具有一些内置的智能处理。 174 如果输出文件可寻址,则每个十六进制转储行开头的行号可能乱序、行可能缺失或重叠。 175 在这些情况下,xxd 会使用 lseek(2) 跳转到下一个位置。如果输出文件不可寻址,则只允许间隙,这些间隙将由空字节填充。 176 .PP 177 .I xxd \-r 178 从不生成解析错误。垃圾数据会被静默跳过。 179 .PP 180 编辑十六进制转储时,请注意 181 .I xxd \-r 182 在读取足够列数的十六进制数据后(参见 \-c 选项),会跳过输入行上的所有其他内容。 183 这也意味着对可打印 ASCII(或 EBCDIC)列的更改总是被忽略。 184 使用 xxd \-r \-p 还原纯十六进制转储(或 PostScript)样式时,不依赖于正确的列数。 185 在这种情况下,任何看起来像一对十六进制数字的内容都会被解释。 186 .PP 187 注意以下两者的区别: 188 .br 189 \fI% xxd \-i file\fR 190 .br 191 和 192 .br 193 \fI% xxd \-i < file\fR 194 .PP 195 .I xxd \-s +seek 196 可能与 197 .IR "xxd \-s seek" 198 不同,因为 lseek(2) 用于"回退"输入。 199 如果输入源是标准输入,并且在 xxd 启动并接收输入时标准输入的文件位置不在文件开头,那么 '+' 就会产生影响。 200 以下示例可能有助于澄清(或进一步混淆!): 201 .PP 202 在读取前回退标准输入;因为 `cat` 已经读到了标准输入的末尾。 203 .br 204 \fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR 205 .PP 206 从文件位置 0x480(=1024+128)开始生成十六进制转储。 207 `+` 号表示"相对于当前位置",因此 `128` 加到了 dd 停止的 1k 位置之后。 208 .br 209 \fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet" < file\fR 210 .PP 211 从文件位置 0x100(=1024\-768)开始生成十六进制转储。 212 .br 213 \fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 > hex_snippet" < file\fR 214 .PP 215 然而,这种情况很少见,`+` 的使用通常并不需要。 216 作者建议在使用 \-s 时,用 strace(1) 或 truss(1) 监控 xxd 的效果。 217 .SH 示例 218 .PP 219 .br 220 打印 221 .BR file 222 除前三行(十六进制 0x30 字节)之外的所有内容。 223 .br 224 \fI% xxd \-s 0x30 file\fR 225 .PP 226 .br 227 从 228 .BR file 229 末尾开始打印 3 行(十六进制 0x30 字节)。 230 .br 231 \fI% xxd \-s \-0x30 file\fR 232 .PP 233 注意:以下示例的结果基于 2026 年 3 月的 xxd.1 手册页。 234 .PP 235 .br 236 打印 120 字节,以连续十六进制转储格式,每行 20 个字节。 237 .br 238 \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR 239 .br 240 2e544820585844203120224d6172203230323622 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 将此手册页的前 120 字节以每行 12 个字节进行十六进制转储。 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: 6172 2032 3032 3622 2022 4d61 ar 2026" "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 将 287 .B input_file 288 复制到 289 .B output_file 290 并在开头添加 100 个值为 0x00 的字节。 291 .br 292 \fI% xxd input_file | xxd \-r \-s 100 > output_file\fR 293 .br 294 295 .br 296 修补文件 xxd.1 中的日期。 297 .br 298 \fI% echo "0000034: 3574 68" | xxd \-r \- xxd.1\fR 299 .br 300 \fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR 301 .br 302 00000033: 3235 7468 204d 6179 2031 3939 36 25th May 1996 303 .PP 304 .br 305 创建一个 65537 字节的文件,所有字节均为 0x00, 306 除了最后一个字节是 'A'(十六进制 0x41)。 307 .br 308 \fI% echo "010000: 41" | xxd \-r > file\fR 309 .PP 310 .br 311 使用自动跳过模式对此文件进行十六进制转储。 312 .br 313 \fI% xxd \-a \-c 12 file\fR 314 .br 315 00000000: 0000 0000 0000 0000 0000 0000 ............ 316 .br 317 * 318 .br 319 0000fffc: 0000 0000 41 ....A 320 .PP 321 创建一个 1 字节的文件,包含单个字符 'A'。 322 在 '\-r \-s' 后面的数字会加到文件中找到的行号上; 323 实际效果是抵制了开头的字节。 324 .br 325 \fI% echo "010000: 41" | xxd \-r \-s \-0x10000 > file\fR 326 .PP 327 在编辑器(如 328 .B vim(1) 329 )中将 xxd 用作过滤器,对 `a` 和 `z` 之间的标记区域进行十六进制转储。 330 .br 331 \fI:'a,'z!xxd\fR 332 .PP 333 在编辑器(如 334 .B vim(1) 335 )中将 xxd 用作过滤器,恢复标记在 `a` 和 `z` 之间的二进制十六进制转储。 336 .br 337 \fI:'a,'z!xxd \-r\fR 338 .PP 339 在编辑器(如 340 .B vim(1) 341 )中将 xxd 用作过滤器,恢复一行十六进制转储。将光标移动到该行并键入: 342 .br 343 \fI!!xxd \-r\fR 344 .PP 345 从串行线读取单个字符。 346 .br 347 \fI% xxd \-c1 < /dev/term/b &\fR 348 .br 349 \fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR 350 .br 351 \fI% echo \-n foo > /dev/term/b\fR 352 .PP 353 以 C 语言头文件(include)的风格输出,并包含结尾的零字节。 354 .br 355 \fI% echo -n \&"0123456789\&" > digits\fR 356 .br 357 \fI% xxd -i -t digits\fR 358 .br 359 unsigned char digits[] = { 360 .br 361 0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x00 362 .br 363 }; 364 .br 365 unsigned int digits_len = 10; 366 .PP 367 .SH "返回值" 368 返回以下错误值: 369 .TP 370 0 371 未遇到错误。 372 .TP 373 \-1 374 不支持的操作 375 \%(\c 376 .I \%xxd \-r \-i 377 仍不可用)。 378 .TP 379 1 380 解析选项时出错。 381 .TP 382 2 383 输入文件问题。 384 .TP 385 3 386 输出文件问题。 387 .TP 388 4,5 389 无法到达所需的查找位置。 390 .SH 另见 391 uuencode(1), uudecode(1), patch(1) 392 .br 393 .SH 警告 394 此工具的各种古怪特性与其创建者的大脑如出一辙。 395 使用风险完全自负。切记复制文件。梳理结构。终成大师。 396 .br 397 .SH 版本 398 此手册页记录的是 2024 年 5 月的 xxd 版本 1.7。 399 .SH 作者 400 .br 401 (c) 1990-1997 由 Juergen Weigert 编写 402 .br 403 <jnweiger@informatik.uni\-erlangen.de> 404 .LP 405 自由分发并保留我的署名, 406 .br 407 赚钱了请与我分享, 408 .br 409 亏钱了别来找我。 410 .PP 411 手册页由 Tony Nugent 创建 412 .br 413 <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> 414 .br 415 Bram Moolenaar 做了少量修改。 416 由 Juergen Weigert 编辑。 417 .PP