summaryrefslogtreecommitdiff
path: root/runtime/doc/xxd-ru.UTF-8.1
blob: ce75f8304d8c64cf5493d7c1edebbfdcfec1c838 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
.TH XXD 1 "August 1996" "Страница man для xxd"
.\"
.\" 21st May 1996
.\" Man page author:
.\"    Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
.\"    Changes by Bram Moolenaar <Bram@vim.org>
.SH ИМЯ
.I xxd
\- создаёт представление файла в виде шестнадцатеричных кодов или выполняет
обратное преобразование.
.SH КОМАНДНАЯ СТРОКА
.B xxd
\-h[elp]
.br
.B xxd
[ключи] [входной_файл [выходной_файл]]
.br
.B xxd
\-r[evert] [ключи] [входной_файл [выходной_файл]]
.SH ОПИСАНИЕ
.I xxd
создаёт представление указанного файла или данных, прочитанных из потока
стандартного ввода, в виде шестнадцатеричных кодов. Эта команда также может
выполнить обратное преобразование заданных шестнадцатеричными кодами данных
в исходный бинарный формат.
Подобно командам
.BR uuencode(1)
и
.BR uudecode(1),
она позволяет выполнять преобразование бинарных данных в ASCII-код, 
который можно передавать по электронной почте, однако, помимо этого, программа
xxd позволяет выполнять декодирование в поток стандартного вывода,
а также может применяться для создания заплаток для бинарных файлов.
.SH КЛЮЧИ ЗАПУСКА
Если
.I входной_файл
не задан, то соответствующие данные читаются из потока стандартного ввода.
В случае, если в качестве
.I входного_файла
используется символ
.RB \` \- ',
источником данных также выступает поток стандартного ввода.
В том случае, если не указан
.I выходной_файл
(или вместо него используется символ
.RB \` \- '
), результат преобразования направляется в поток стандартного вывода.
.PP
Обратите внимание, что используется "ленивый" алгоритм разбора ключей, который не
проверяет более одной буквы ключа, если в этом ключе не используется параметр.
Пробелы между единственным символом ключа и соответствующим параметром не являются
обязательными. Параметры ключей могут быть заданы с использованием десятичного,
шестнадцатеричного или восьмеричного формата.
Таким образом, ключи
.BR \-c8 ,
.BR "\-c 8" ,
.B \-c 010
и
.B \-cols 8
являются равнозначными.
.PP
.TP
.IR \-a " | " \-autoskip
Включает автоматический пропуск: вместо последовательности
нулевых строк используется одиночный символ '*'. По умолчанию
не применяется.
.TP
.IR \-b " | " \-bits
Вместо шестнадцатеричного кода используются биты (двоичные цифры).
При использовании этого ключа вместо обычного шестнадцатеричного представления
октетов используются наборы из восьми символов "1" и "0". Каждая строка
предваряется номером строки в шестнадцатеричном виде, а завершается символьным 
представлением (в виде ascii или ebcdic). Ключи \-r, \-p, \-i в этом режиме
не работают.
.TP
.IR "\-c кол " | " \-cols кол"
Задаёт количество октетов
.RI < кол >,
которое выводится на каждой строке. По умолчанию используется значение 16 
(\-i: 12, \-ps: 30, \-b: 6). 
Максимально допустимое значение: 256.
.TP
.IR \-E " | " \-EBCDIC
Изменяет способ кодирования символов в правой колонке с ASCII на EBCDIC. Этот ключ
не изменяет шестнадцатеричное представление. Данный ключ не имеет смысла,
если используются ключи \-r, \-p или \-i.
.TP
.IR "\-g байт " | " \-groupsize байт"
Позволяет выполнять группировку указанного количества
.RI < байтов >
(две шестнадцатеричные цифры или восемь битов), отделяя группы друг от друга пробелами.
Значение
.I \-g 0 
применяется для отказа от использования группировки.
По умолчанию используется значение
.RI < байт "> равное " 2
в обычном режиме и \fI1\fP в битовом режиме. Группировка не применяется
в режимах postscript и include.
.TP
.IR \-h " | " \-help
Выводит справку по доступным ключам командной строки и завершает работу программы.
Создание шестнадцатеричного представления не выполняется.
.TP
.IR \-i " | " \-include
Позволяет создавать вывод в стиле подключаемых заголовочных файлов языка C.
Вывод содержит полноценное определение статического массива данных, имя которого
соответствует имени входного файла, если xxd не считывает данные из потока стандартного
ввода.
.TP
.IR "\-l длина " | " \-len длина"
Завершает работу после записи заданного в параметре
.RI  < длина >
количества октетов.
.TP
.IR \-p " | " \-ps " | " \-postscript " | " \-plain
Использует непрерывный формат вывода шестнадцатеричного кода, 
известный как "простой" стиль или стиль "postscript".
.TP
.IR \-r " | " \-revert
Изменяет смысл операции на противоположный: позволяет выполнять преобразование 
шестнадцатеричного представления в бинарный код (или применять результат в качестве заплаты).
Если вывод происходит не в поток стандартного вывода, то xxd выполняет добавление кода 
к соответствующему файлу. При использовании комбинации ключей
.I \-r \-p
происходит чтение "простого" шестнадцатеричного представления без использования
информации о номерах строк и какого-либо специального раскроя колонок. Пробелы 
и символы новой строки могут встречаться в любом месте исходных данных.
.TP
.I \-seek смещение
При использовании после ключа
.I \-r
: добавлять указанное
.RI < смещение >
к файловым позициям, обнаруженным в исходных данных.
.TP
.I \-s [\+][\-]seek
Начинает работу с указанного абсолютного (или относительного)
.RI < смещения >
в байтах во входном_файле.
\fI\+ \fRуказывает, что смещение является относительным по отношению
к текущей файловой позиции в потоке стандартного ввода (бессмысленно, если чтение
происходит не из потока стандартного ввода). \fI\- \fRуказывает, что должно быть прочитано
указанное количество символов от конца ввода (либо, если сочетается с \fI \+ \fR: 
перед текущей позиции файла в потоке стандартного ввода).
Если ключ \-s не используется, то xxd начинает работу от текущей позиции в файле.
.TP
.I \-u
Использует шестнадцатеричные цифры в верхнем регистре. По умолчанию используются цифры в
нижнем регистре символов.
.TP
.IR \-v " | " \-version
Отображает информацию о версии программы.
.SH ПОДВОДНЫЕ КАМНИ
.PP
.I xxd \-r
обладает встроенным интеллектом для распознавания информации о номерах строк.
Если возможен поиск по входному файлу, то номера строк в начале каждой строки
шестнадцатеричного представления могут быть неупорядоченными, некоторые строки могут
быть пропущены или пересекаться друг с другом. В этих случаях xxd использует
lseek(2) для перехода к следующей позиции. Если поиск по входному файлу 
невозможен, то допустимы только пропуски строк, которые заполняются нулевыми 
байтами.
.PP
.I xxd \-r
никогда не выводит сообщений об ошибках. Мусор пропускается молча.
.PP
При редактировании шестнадцатеричных представлений бинарных файлов обращайте 
внимание, что 
.I xxd \-r
пропускает в строке ввода любые данные после прочтения достаточного количества 
колонок шестнадцатеричных данных (см. ключ \-c). Это означает, что изменения,
внесенные в колонки с печатными символами ascii (или ebcdic), всегда игнорируются.
При обратном преобразовании шестнадцатеричного представления в стиле
postscript с помощью команды xxd \-r \-p количество колонок не учитывается. 
В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных цифр.
.PP
Обратите внимание на различие между командами
.PP
\fI% xxd \-i файл\fR
.PP
и
.PP
\fI% xxd \-i \< файл\fR
.PP
Команда
.I xxd \-s \+seek
может отличаться от
.I xxd \-s seek,
поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов lseek(2).
При использовании `+' поведение будет отличаться, если входные данные
поступают с потока стандартного ввода, а позиция в файле стандартного ввода не находится
в начале файла к тому моменту, когда программа xxd запущена и приступает к чтению ввода.
Нижеследующие примеры помогут прояснить (или ещё больше запутать!) ситуацию...
.PP
Отмотка назад потока стандартного ввода; необходимо, поскольку 'cat' уже выполнила
чтение до конца потока стандартного ввода:
.PP
\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file
.PP
Вывод шестнадцатеричного представления от позиции в файле 0x480 
(= 1024+128).
Символ `+' означает "относительно текущей позиции", таким образом `128' добавляется
к первому килобайту, где завершает работу dd:
.PP
\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file
.PP
Вывод шестнадцатеричного представления от позиции в файле 0x100 
(= 1024-768):
.PP
\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file
.PP
В то же время, следует заметить, что подобные ситуации встречаются довольно редко,
так что символ `+' обычно не используется. Автор предпочитает наблюдать за работой 
xxd с помощью strace(1) или truss(1) в тех случаях, когда применяется ключ
\-s.
.SH ПРИМЕРЫ
.PP
.br
Вывести всё, кроме первых трёх строк (0x30 байтов) файла
.B file
:
.PP
\fI% xxd \-s 0x30 file
.PP
.br
Вывести три строки (0x30 байтов) от конца файла
.B file
:
.PP
\fI% xxd \-s \-0x30 file
.PP
.br
Вывести 120 байтов в виде непрерывного шестнадцатеричного представления
по 40 октетов в строке:
.PP
\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR
.br
2e544820585844203120224d616e75616c207061
.br
676520666f7220787864220a2e5c220a2e5c2220
.br
32317374204d617920313939360a2e5c22204d61
.br
6e207061676520617574686f723a0a2e5c222020
.br
2020546f6e79204e7567656e74203c746f6e7940
.br
7363746e7567656e2e7070702e67752e6564752e
.br
.PP
.br
Вывести первые 120 байтов этой страницы справочника по 12 октетов в строке:
.PP
\fI% xxd \-l 120 \-c 12 xxd.1\fR
.br
0000000: 2e54 4820 5858 4420 3120 224d  .TH XXD 1 "M
.br
000000c: 616e 7561 6c20 7061 6765 2066  anual page f
.br
0000018: 6f72 2078 7864 220a 2e5c 220a  or xxd"..\\".
.br
0000024: 2e5c 2220 3231 7374 204d 6179  .\\" 21st May
.br
0000030: 2031 3939 360a 2e5c 2220 4d61   1996..\\" Ma
.br
000003c: 6e20 7061 6765 2061 7574 686f  n page autho
.br
0000048: 723a 0a2e 5c22 2020 2020 546f  r:..\\"    To
.br
0000054: 6e79 204e 7567 656e 7420 3c74  ny Nugent <t
.br
0000060: 6f6e 7940 7363 746e 7567 656e  ony@sctnugen
.br
000006c: 2e70 7070 2e67 752e 6564 752e  .ppp.gu.edu.
.PP
.br
Показать дату из файла xxd.1:
.PP
\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR
.br
0000028: 3231 7374 204d 6179 2031 3939  21st May 199
.PP
.br
Скопировать
.B входной_файл
в
.B выходной_файл
с добавлением 100 байтов со значением 0x00 в начало файла:
.PP
\fI% xxd входной_файл | xxd \-r \-s 100 \> выходной_файл\fR
.br
.PP
.br
Заменить дату в файле xxd.1:
.PP
\fI% echo '0000029: 3574 68' | xxd \-r \- xxd.1\fR
.br
\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR
.br
0000028: 3235 7468 204d 6179 2031 3939  25th May 199
.PP
.br
Создать 65537-байтный файл, все байты которого имеют значение
0x00, кроме последнего байта, который должен иметь значение 'A'
(0x41):
.PP
\fI% echo '010000: 41' | xxd \-r \> file\fR
.PP
.br
Создать шестнадцатеричное представление этого файла с 
использованием автоматического пропуска:
.PP
\fI% xxd \-a \-c 12 file\fR
.br
0000000: 0000 0000 0000 0000 0000 0000  ............
.br
*
.br
000fffc: 0000 0000 40                   ....A
.PP
Создать 1-байтный файл, содержащий символ 'A'.
Число после '\-r \-s' добавляется к номерам строк, найденным в файле;
иначе говоря, предшествующие байты пропускаются:
.PP
\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR
.PP
xxd можно использовать в качестве фильтра в редакторе, например в 
.B vim(1),
чтобы создать шестнадцатеричное представление области между
отметками `a' и `z':
.PP
\fI:'a,'z!xxd\fR
.PP
Вы можете использовать xxd в качестве фильтра в редакторе, например в 
.B vim(1),
для восстановления данных из шестнадцатеричного представления
между отметками `a' и `z':
.PP
\fI:'a,'z!xxd \-r\fR
.PP
Вы можете использовать xxd в качестве фильтра в редакторе, например в
.B vim(1),
для восстановления данных из единственной строки
шестнадцатеричного представления. Поместите курсор в соответствующую строку
и наберите
.PP
\fI!!xxd \-r\fR
.PP
Чтобы прочитать единственный символ из канала связи:
.PP
\fI% xxd \-c1 < /dev/term/b &\fR
.br
\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR
.br
\fI% echo \-n foo > /dev/term/b\fR
.PP
.SH ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
Программа xxd завершает работу со следующими значениями:
.TP
0
Ошибки не обнаружены.
.TP
\-1
Операция не поддерживается (выполнение
.I xxd \-r \-i
пока невозможно).
.TP
1
Ошибка при разборе ключей командной строки.
.TP
2
Проблемы во входном файле.
.TP
3
Проблемы в выходном файле.
.TP
4,5
Желательная позиция поиска недостижима.
.SH СМОТРИ ТАКЖЕ
uuencode(1), uudecode(1), patch(1)
.br
.SH ПРЕДУПРЕЖДЕНИЕ
Странность этой программы соответствует особенностям мозга её создателя.
Используйте её на свой страх и риск. Копируйте файлы, отслеживайте
вызовы, становитесь волшебником.
.br
.SH ВЕРСИЯ
Эта страница справочника документирует xxd версии 1.7.
.SH АВТОР
.br
(c) 1990-1997 Юрген Вайгерт (Juergen Weigert)
.br
<jnweiger@informatik.uni-erlangen.de>
.LP
Вы можете свободно распространять программу со ссылкой на меня.
.br
Если использование этой программы принесло вам какой-то доход,
поделитесь со мной.
.br
Если вы потеряли деньги, то я тут не причём.
.PP
Первый вариант страницы справочника написан Тони Наджентом (Tony Nugent)
.br
<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
.br
Небольшие изменения внесены Брамом Мооленааром (Bram Moolenaar).
Страница отредактирована Юргеном Вайгертом (Juergen Weigert).
.PP