xxd-ru.1 (16702B)
1 .TH XXD 1 "Март 2026" "Справочник по программе 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 Программа 9 .I xxd 10 \[em] выполняет преобразование данных или в шестнадцатеричный вид, или выполняет 11 обратное преобразование из шестнадцатеричного кода в исходный формат 12 .SH КРАТКИЙ ОБЗОР 13 .B xxd 14 \-h[elp] 15 .br 16 .B xxd 17 [аргументы] [входной_файл [выходной_файл]] 18 .br 19 .B xxd 20 \-r[evert] [аргументы] [входной_файл [выходной_файл]] 21 .SH ОПИСАНИЕ 22 Программа 23 .I xxd 24 создаёт представление указанного файла или данных, прочитанных из стандартного 25 потока ввода, в виде шестнадцатеричных кодов. Эта программа также может 26 выполнять обратное преобразование заданных шестнадцатеричными кодами данных 27 в исходный двоичных формат. 28 Подобно программам 29 .BR uuencode(1) 30 и 31 .BR uudecode(1) 32 , она позволяет выполнять преобразование двоичных данных в символы кодировки 33 ASCII, которые можно передавать по электронной почте, однако, помимо этого, 34 программа xxd позволяет выполнять декодирование в поток стандартного вывода, 35 а также может применяться для создания исправлений для двоичных файлов. 36 .SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ 37 Если 38 .I входной_файл 39 не задан, то требуемые данные считываются из стандартного потока ввода. 40 В случае, если в качестве 41 .I входного_файла 42 используется символ 43 .RB ' \- ', 44 источником данных также выступает стандартный поток ввода. 45 В том случае, если не указан 46 .I выходной_файл 47 (или вместо него используется символ 48 .RB ' \- ' 49 ), результат преобразования направляется в стандартный поток вывода. 50 .PP 51 Обратите внимание, что применяется "ленивый" алгоритм разбора аргументов, 52 который проверяет только первую букву аргумента, если, конечно, для этого 53 аргумента не указано какое-то значение. 54 Пробелы между односимвольным аргументом и его значением не являются 55 обязательными. Значения аргументов могут быть заданы в десятичном, 56 шестнадцатеричном или восьмеричном формате. 57 Таким образом, аргументы 58 .BR \-c8 , 59 .BR "\-c 8" , 60 .B \-c 010 61 и 62 .B \-cols 8 63 являются равнозначными. 64 .PP 65 .TP 66 .IR \-a " | " \-autoskip 67 Включить автоматический пропуск, т. е., вместо нескольких идущих подряд строк 68 с нулевым значением, используется одиночный символ '*'. 69 По умолчанию не применяется. 70 .TP 71 .IR \-b " | " \-bits 72 Использовать биты (двоичный код), а не шестнадцатеричные цифры. 73 При указании этого аргумента, вместо обычного шестнадцатеричного представления 74 октетов, будет отображается набор из восьми цифр "1" и "0". Каждая строка 75 предваряется её номером в шестнадцатеричном виде, а завершается в виде символов 76 в кодировке ASCII (или в кодировке EBCDIC). Аргумент командной строки \-p 77 в этом режиме не применяется. Аргумент \-i может быть указан для этого режима. 78 .TP 79 .IR "\-c кол " | " \-cols кол" 80 Задаёт количество октетов 81 .RI < кол >, 82 которое выводится на каждой строке. По умолчанию используется значение 16 83 (для аргумента \-i используется 12, для \-ps \[em] 30, для \-b \[em] 6). 84 Максимально допустимое значение \[em] 256. 85 Максимальное значение не применяется с аргументом \-ps. Если с аргументом \-ps, 86 указано значение 0, то будет выведена просто одна длинная строка. 87 .TP 88 .IR \-C " | " \-capitalize 89 Преобразовать наименования переменных в верхний регистр при использовании стиля 90 отображения в виде подключаемых файлов языка Си, 91 который включается через аргумент командной строки \-i. 92 .TP 93 .I \-d 94 Отображать смещение не в шестнадцатеричном, а в десятичном формате. 95 .TP 96 .IR \-E " | " \-EBCDIC 97 Отображать символы в крайне правой колонке не в кодировке ASCII, 98 а в кодировке EBCDIC. Этот аргумент не влияет на шестнадцатеричное 99 представление данных. Данный аргумент не имеет смысла, если используются 100 аргументы командной строки \-r, \-p или \-i. 101 .TP 102 .IR \-e 103 Использовать обратный порядок байт при отображение шестнадцатеричного 104 представления данных. 105 Группа байт будет показана как двоичное слово от младших разрядов к старшим. 106 Используемое по умолчанию группирование по четыре байта может быть изменено 107 через аргумент командной строки 108 .RI "" \-g . 109 Действие этого аргумента распространяется только на шестнадцатеричное 110 представление данных и не оказывает влияние на символьное представление 111 в кодировке ASCII (или EBCDIC). 112 Аргументы командной строки 113 \-r, \-p, \-i не применяются в этом режиме. 114 .TP 115 .IR "\-g байт " | " \-groupsize байт" 116 Выполнить группирование указанного количества 117 .RI < байт > 118 (две шестнадцатеричные цифры или восемь двоичных цифр), отделяя группы 119 друг от друга пробелами. 120 Значение 121 .I \-g 0 122 применяется для отказа от использования группирования. 123 По умолчанию используется значение 124 .RI < байт ">, равное " 2 125 при отображении в прямом порядке байт, \fI4\fP при отображении в обратном 126 порядке байт и \fI1\fP в двоичном режиме. Группировка не применяется 127 в режиме PostScript или include. 128 .TP 129 .IR \-h " | " \-help 130 Показать краткую информацию об аргументах командной строки и завершить работу 131 программы. 132 Создание шестнадцатеричного представления не выполняется. 133 .TP 134 .IR \-i " | " \-include 135 Создавать вывод в стиле подключаемых заголовочных файлов языка Си. Вывод 136 содержит полноценное определение статического массива данных, название которого 137 соответствует наименованию входного файла, если программа xxd не считывает 138 данные из стандартного потока ввода. Возможно совмещение аргументов \-i и \-b. 139 \-b. 140 .TP 141 .IR "\-l длина " | " \-len длина" 142 Указывает, что после записи заданного в параметре 143 .RI < длина > 144 количества октетов, работа программы будет завершена. 145 .TP 146 .I "\-n название " | " \-name название" 147 Изменить возвращаемое наименование переменной при использовании аргумента \-i. 148 Применяется к массиву байт, который будет именоваться как \fIназвание\fP и длина 149 файла как \fIназвание\fP_len. 150 .TP 151 .I \-o смещение 152 Указывает добавить 153 .RI < смещение > 154 в отображаемую позицию файла. 155 .TP 156 .IR \-p " | " \-ps " | " \-postscript " | " \-plain 157 Использовать непрерывный формата вывода шестнадцатеричного кода, 158 известного как "простой" стиль или стиль "PostScript". 159 .TP 160 .IR \-r " | " \-revert 161 Выполнить операцию обратного преобразования, т. е. преобразование 162 шестнадцатеричного представления в двоичный код (или применить результат 163 в качестве исправления). 164 Если вывод происходит не в стандартного поток вывода, то программа xxd выполняет 165 добавление кода к выходному файлу. При использовании комбинации аргументов 166 .I \-r \-p 167 происходит чтение "простого" шестнадцатеричного представления без использования 168 информации о номерах строк и какого-либо специального распределения колонок. 169 Пробелы и символы новой строки могут встречаться в любом месте исходных данных. 170 При использовании комбинации аргументов 171 .I \-r \-b 172 будет происходить считывание двоичного представления вместо шестнадцатеричного. 173 .TP 174 .IR \-R " " когда 175 В выходных данных одни и те же шестнадцатеричные значения и строковые значения 176 будут подсвечиваться одним и тем же цветом. В основном это помогает различать 177 печатаемые и непечатаемые символы. 178 Где 179 .I \fIкогда\fP 180 может принимать значение 181 .BR never " (никогда), " always " (всегда), или " auto " (автовыбор, по умолчанию). 182 Если установлена переменная окружения 183 .BR $NO_COLOR 184 , то цветовая подсветка будет отключена. 185 .TP 186 .I \-seek смещение 187 При указании после аргумента 188 .I \-r 189 , будет добавляться указанное 190 .RI < смещение > 191 к файловым позициям, обнаруженным в исходных данных. 192 .TP 193 .I \-s [+][\-]seek 194 Начинать обработку с указанного абсолютного (или относительного) 195 .RI < смещения > 196 в байтах во входном_файле. 197 Где \fI+ \fRуказывает, что смещение является относительным по отношению 198 к текущей позиции данных в стандартном потоке ввода (бессмысленно, если чтение 199 происходит не из стандартного потока ввода). А параметр \fI\- \fRуказывает, 200 что должно быть прочитано указанное количество символов от конца ввода (либо, 201 если одновременно с параметром \fI+\fR, то перед текущей позицией данных 202 в стандартном потоке ввода). 203 Если аргумент \-s не используется, то программа xxd начинает обработку 204 от текущей позиции в файле. 205 .TP 206 .I \-t 207 При использовании аргумента \-i для вывода в стиле подключаемых заголовочных 208 файлов языка Си также включать завершающий нулевой символ 209 .TP 210 .I \-u 211 Указывает, что в выводе отображать шестнадцатеричные цифры в верхнем регистре. 212 По умолчанию используются символы в нижнем регистре символов. 213 .TP 214 .IR \-v " | " \-version 215 Показать информацию о версии программы и завершить работу. 216 .SH НЕКОТОРЫЕ РАЗЪЯСНЕНИЯ 217 .PP 218 При указании команды 219 .I xxd \-r 220 при запуске программы, будет применяться некий встроенный алгоритм 221 для распознавания информации о номерах строк. 222 Если возможен поиск по входному файлу, то номера строк в начале каждой строки 223 шестнадцатеричного представления могут быть неупорядоченными, некоторые строки 224 могут быть пропущены или пересекаться друг с другом. В этих случаях программа 225 xxd использует функцию lseek(2) для перехода к следующей позиции. Если поиск по 226 входному файлу невозможен, то допустимы только пропуски строк, которые 227 заполняются нулевыми байтами. 228 .PP 229 Использование команды 230 .I xxd \-r 231 приводит к тому, что сообщения об ошибках не будут отображаться. 232 Посторонние данные просто молча пропускаются. 233 .PP 234 При редактировании шестнадцатеричного представления двоичных файлов, обращайте 235 внимание, что по команде 236 .I xxd \-r 237 , после считывания достаточного количества колонок шестнадцатеричных данных 238 (см. аргумент \-c), в строке ввода не будут обрабатываться остальные данные. 239 Это означает, что изменения, внесённые в колонке с текстом в кодировке 240 ASCII (или EBCDIC), всегда игнорируются. 241 При обратном преобразовании шестнадцатеричного представления в стиле 242 PostScript с помощью команды xxd \-r \-p количество колонок не учитывается. 243 В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных 244 цифр. 245 .PP 246 Обратите внимание на различие между командами 247 .PP 248 \fI% xxd \-i файл\fR 249 .PP 250 и 251 .PP 252 \fI% xxd \-i \< файл\fR 253 .PP 254 Команда 255 .I xxd \-s \+seek 256 может отличаться от 257 .I xxd \-s seek, 258 поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов 259 функции lseek(2). 260 При указании параметра '+' поведение будет отличаться, если входные данные 261 поступают со стандартного потока ввода, а позиция в файле стандартного ввода 262 не находится в начале файла к тому моменту, когда программа xxd запущена 263 и приступает к чтению ввода. 264 Нижеследующие примеры помогут прояснить (или ещё больше запутать!) ситуацию... 265 .PP 266 Отмотка потока стандартного ввода назад необходима, поскольку программа 'cat' 267 уже выполнила чтение данных до конца из стандартного потока ввода: 268 .PP 269 \fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR 270 .PP 271 Вывод шестнадцатеричного представления от позиции в файле 0x480 (=1024+128). 272 Параметр '+' означает "относительно текущей позиции", таким образом '128' 273 добавляется к первому килобайту, где завершает работу программа dd: 274 .PP 275 \fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 \> hex_snippet" < file\fR 276 .PP 277 Вывод шестнадцатеричного представления от позиции в файле 0x100 (=1024\[mi]768): 278 .PP 279 \fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 \> hex_snippet" < file\fR 280 .PP 281 В то же время, следует заметить, что подобные ситуации встречаются довольно 282 редко, так что параметр '+' обычно не используется. Автор предпочитает наблюдать 283 за работой программы xxd с помощью инструментов strace(1) или truss(1) в тех 284 случаях, когда применяется аргумент 285 \-s. 286 .SH ПРИМЕРЫ 287 .PP 288 .br 289 Вывести всё, кроме первых трёх строк (0x30 байт) 290 .BR файла 291 : 292 .br 293 \fI% xxd \-s 0x30 file\fR 294 .PP 295 .br 296 Вывести три строки (0x30 байт) от конца 297 .BR файла 298 : 299 .br 300 \fI% xxd \-s \-0x30 file\fR 301 .PP 302 .br 303 Вывести 120 байт в виде непрерывного шестнадцатеричного представления 304 по 20 октетов в строке 305 .br 306 (этот пример для справочника xxd.1 на английском языке, для русского языка будет 307 немного другой результат): 308 .br 309 \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR 310 .br 311 2e544820585844203120224d6172203230323622 312 .br 313 20224d616e75616c207061676520666f72207878 314 .br 315 64220a2e5c220a2e5c222032317374204d617920 316 .br 317 313939360a2e5c22204d616e2070616765206175 318 .br 319 74686f723a0a2e5c2220202020546f6e79204e75 320 .br 321 67656e74203c746f6e79407363746e7567656e2e 322 .br 323 324 .br 325 Вывести первые 120 байт этого справочника по 12 октетов в строке 326 .br 327 (этот пример для справочника xxd.1 на английском языке, для русского языка будет 328 немного другой результат): 329 .br 330 \fI% xxd \-l 120 \-c 12 xxd.1\fR 331 .br 332 00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M 333 .br 334 0000000c: 6172 2032 3032 3622 2022 4d61 ar 2026" "Ma 335 .br 336 00000018: 6e75 616c 2070 6167 6520 666f nual page fo 337 .br 338 00000024: 7220 7878 6422 0a2e 5c22 0a2e r xxd"..\\".. 339 .br 340 00000030: 5c22 2032 3173 7420 4d61 7920 \\" 21st May 341 .br 342 0000003c: 3139 3936 0a2e 5c22 204d 616e 1996..\\" Man 343 .br 344 00000048: 2070 6167 6520 6175 7468 6f72 page author 345 .br 346 00000054: 3a0a 2e5c 2220 2020 2054 6f6e :..\\" Ton 347 .br 348 00000060: 7920 4e75 6765 6e74 203c 746f y Nugent <to 349 .br 350 0000006c: 6e79 4073 6374 6e75 6765 6e2e ny@sctnugen. 351 .PP 352 .br 353 Показать дату из файла 354 .B xxd.1 355 .br 356 (этот пример для справочника xxd.1 на английском языке, для русского языка будет 357 немного другая команда, например, для UTF-8 \[em] \flxxd \-s 0x50 \-l 13 \-c 13 xxd.1\fR): 358 .PP 359 \fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR 360 .br 361 00000033: 3231 7374 204d 6179 2031 3939 36 21st May 1996 362 .PP 363 .br 364 Скопировать 365 .B входной_файл 366 в 367 .B выходной_файл 368 с добавлением 100 байт со значением 0x00 в начало файла: 369 .br 370 \fI% xxd входной_файл | xxd \-r \-s 100 \> выходной_файл\fR 371 .br 372 373 .br 374 Заменить дату в файле 375 .B xxd.1 376 .br 377 (этот пример для справочника xxd.1 на английском языке, для русского языка будут 378 немного другие команды): 379 .PP 380 \fI% echo "0000034: 3574 68" | xxd \-r \- xxd.1\fR 381 .br 382 \fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR 383 .br 384 00000033: 3235 7468 204d 6179 2031 3939 36 25th May 1996 385 .PP 386 .br 387 Создать 65537-байтный файл, все байты которого имеют значение 0x00, 388 кроме последнего байта, который должен иметь значение 'A' (0x41): 389 .PP 390 \fI% echo "010000: 41" | xxd \-r > file\fR 391 .PP 392 .br 393 Создать шестнадцатеричное представление этого файла с 394 использованием автоматического пропуска: 395 .PP 396 \fI% xxd \-a \-c 12 file\fR 397 .br 398 00000000: 0000 0000 0000 0000 0000 0000 ............ 399 .br 400 * 401 .br 402 0000fffc: 0000 0000 41 ....A 403 .PP 404 Создать 1-байтный файл, содержащий символ 'A'. 405 Число после аргументов '\-r \-s' добавляется к номерам строк, найденным в файле, 406 иначе говоря, предшествующие байты пропускаются: 407 .PP 408 \fI% echo '010000: 41' | xxd \-r \-s \-0x10000 > file\fR 409 .PP 410 Программу xxd можно использовать в качестве фильтра в редакторе, например в 411 .B vim(1) 412 , чтобы создать шестнадцатеричное представление области между 413 закладками 'a' и 'z': 414 .br 415 \fI:'a,'z!xxd\fR 416 .PP 417 Можно использовать программу xxd в качестве фильтра в редакторе, например в 418 .B vim(1) 419 , для восстановления данных из шестнадцатеричного представления 420 между закладками 'a' и 'z': 421 .br 422 \fI:'a,'z!xxd \-r\fR 423 .PP 424 Можно использовать программу xxd в качестве фильтра в редакторе, например в 425 .B vim(1) 426 , для восстановления данных из единственной строки 427 шестнадцатеричного представления. Поместите курсор в соответствующую строку 428 и наберите 429 .br 430 \fI!!xxd \-r\fR 431 .PP 432 Чтобы прочитать единственный символ из канала связи: 433 .br 434 \fI% xxd \-c1 < /dev/term/b &\fR 435 .br 436 \fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR 437 .br 438 \fI% echo \-n foo \> /dev/term/b\fR 439 .PP 440 Вывод в стиле подключаемых заголовочных файлв языка Си с завершающим нулём 441 .br 442 \fI% echo -n \&"0123456789\&" > digits\fR 443 .br 444 \fI% xxd -i -t digits\fR 445 .br 446 unsigned char digits[] = { 447 .br 448 0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x00 449 .br 450 }; 451 .br 452 unsigned int digits_len = 10; 453 .PP 454 .SH КОДЫ ЗАВЕРШЕНИЯ 455 При завершении работы, программа xxd возвращает следующие значения: 456 .TP 457 0 458 Ошибки не обнаружены. 459 .TP 460 \-1 461 Операция не поддерживается (выполнение 462 .I \%xxd \-r \-i 463 пока невозможно). 464 .TP 465 1 466 Ошибка при разборе аргументов командной строки. 467 .TP 468 2 469 Ошибки во входном файле. 470 .TP 471 3 472 Ошибки в выходном файле. 473 .TP 474 4,5 475 Желательная позиция поиска недостижима. 476 .SH СМОТРИТЕ ТАКЖЕ 477 uuencode(1), uudecode(1), patch(1) 478 .br 479 .SH ПРЕДУПРЕЖДЕНИЕ 480 Странность этой программы соответствует особенностям мозга её создателя. 481 Используйте её на свой страх и риск. Копируйте файлы, отслеживайте вызовы, 482 становитесь волшебником. 483 .br 484 .SH ВЕРСИЯ 485 Этот справочник документирует программу xxd версии 1.7 от 2024-05. 486 .SH АВТОР 487 .br 488 (c) Юрген Вайгерт (Juergen Weigert), 1990-1997 489 .br 490 <jnweiger@informatik.uni\-erlangen.de> 491 .LP 492 Вы можете свободно распространять программу со ссылкой на меня. 493 .br 494 Если использование этой программы принесло вам какой-то доход, поделитесь со 495 мной. 496 .br 497 Если вы потеряли деньги, то я тут ни при чём. 498 .PP 499 Первый вариант справочника написан Тони Наджентом (Tony Nugent) 500 .br 501 <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> 502 .br 503 Небольшие изменения внесены Брамом Моленаром (Bram Moolenaar). 504 Справочник отредактирован Юргеном Вайгертом (Juergen Weigert). 505 .PP