vim

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

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