summaryrefslogtreecommitdiff
path: root/mnv/runtime/doc/xxd-sv.1
blob: ba37ed8f75c3b04566bbf169eaae881f486823c2 (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
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH XXD 1 "Maj 2024" "Manualsida f�r 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@mnv.org>
.SH NAMN
\fIxxd\fP \- g�r en hexdump eller g�r det omv�nda.
.SH SYNOPSIS
\fBxxd\fP \-h[elp]
.br
\fBxxd\fP [flaggor] [infil [utfil]]
.br
\fBxxd\fP \-r[evert] [flaggor] [infil [utfil]]
.SH BESKRIVNING
\fIxxd\fP skapar en hexdump av en given fil eller standardinmatning.  Det kan
ocks� konvertera en hexdump tillbaka till sin ursprungliga bin�ra form.
Liksom \fBuuencode\fP(1)  och \fBuudecode\fP(1)  till�ter det �verf�ring av bin�r
data i en "mail\-safe" ASCII\-representation, men har f�rdelen att avkoda till
standardutmatning.  Dessutom kan det anv�ndas f�r att utf�ra bin�r
filpatchning.
.SH FLAGGOR
Om ingen \fIinfile\fP anges, l�ses standardinmatningen.  Om \fIinfile\fP anges som
ett \`\fB\-\fP'\-tecken, h�mtas inmatningen fr�n standardinmatningen.  Om ingen
\fIoutfile\fP anges (eller om ett \`\fB\-\fP'\-tecken finns p� dess plats), skickas
resultaten till standardutmatningen.
.PP
Observera att en "lat" parser anv�nds som inte kontrollerar mer �n den
f�rsta optionsbokstaven, s�vida inte optionen f�ljs av en parameter.
Mellanslag mellan en enskild optionsbokstav och dess parameter �r valfria.
Parametrar till optioner kan anges i decimal\-, hexadecimal\- eller
oktalnotation.  S�ledes �r \fB\-c8\fP, \fB\-c 8\fP, \fB\-c 010\fP och \fB\-cols 8\fP alla
likv�rdiga.
.PP
.TP
\fI\-a\fP | \fI\-autoskip\fP
V�xla autoskip: En enda '*' ers�tter NUL\-rader. Standardinst�llning �r av.
.TP
\fI\-b\fP | \fI\-bits\fP
V�xla till bitdump (bin�ra siffror) ist�llet f�r hexdump. Den h�r flaggan
skriver oktetter som �tta siffror "1" och "0" ist�llet f�r en vanlig
hexadecimal dump. Varje rad f�reg�s av ett radnummer i hexadecimal och f�ljs
av en ASCII\- (eller EBCDIC\-) representation. Kommandoradsv�xeln \-p fungerar
inte i det h�r l�get. Kan kombineras med \-i.
.TP
\fI\-c cols \fP|\fI \-cols kolumner\fP
Format <\fIcols\fP> oktetter per rad. Standard 16 (\-i: 12, \-ps: 30, \-b:
6). Max 256.  Inget maximum f�r \-ps. Med \-ps resulterar 0 i en l�ng rad med
utdata.
.TP
\fI\-C\fP | \fI\-capitalize\fP
Anv�nd versaler f�r variabelnamn i C\-inkluderingsfilformat n�r du anv�nder
\-i.
.TP
\fI\-d\fP
visa offset i decimal ist�llet f�r hex.
.TP
\fI\-E\fP | \fI\-EBCDIC\fP
�ndra teckenkodningen i den h�gra kolumnen fr�n ASCII till EBCDIC.  Detta
�ndrar inte den hexadecimala representationen. Flaggan �r meningsl�s i
kombination med \-r, \-p eller \-i.
.TP
\fI\-e\fP
Byt till little\-endian hex dump.  Denna flagga behandlar byte\-grupper som
ord i little\-endian byte\-ordning.  Standardgrupperingen p� 4 byte kan �ndras
med \fI\-g\fP.  Denna flagga g�ller endast hex dump, ASCII\- (eller EBCDIC\-)
representationen f�rblir of�r�ndrad.  Kommandoradsv�xlarna \-r, \-p, \-i
fungerar inte i detta l�ge.
.TP
\fI\-g bytes \fP|\fI \-groupsize byte\fP
Separera utdata f�r varje <\fIbytes\fP> \-byte (tv� hexadecimala tecken
eller �tta bitars siffror vardera) med ett blanksteg.  Ange \fI\-g 0\fP f�r att
undertrycka gruppering.  <\fIBytes\fP> \-standardv�rdet �r \fI2\fP i
normalt l�ge, \fI4\fP i little\-endian\-l�ge och \fI1\fP i bits\-l�ge.  Gruppering
g�ller inte f�r PostScript eller inkluderingsstil.
.TP
\fI\-h\fP | \fI\-help\fP
Skriv ut en sammanfattning av tillg�ngliga kommandon och avsluta. Ingen
hexdumpning utf�rs.
.TP
\fI\-i\fP | \fI\-include\fP
Utdata i C\-inkluderingsfilformat. En komplett statisk arraydefinition skrivs
(uppkallad efter inmatningsfilen), s�vida inte xxd l�ser fr�n stdin. Kan
kombineras med \-b.
.TP
\fI\-l len \fP|\fI \-len len\fP
Stanna efter att ha skrivit <\fIlen\fP> oktetter.
.TP
\fI\-n name  |  \-name namn\fP
�sidos�tt variabelnamnets utdata n�r \-i anv�nds. Arrayen heter \fIname\fP och
l�ngden heter \fIname\fP_len.
.TP
\fI\-o offset\fP
L�gg till <\fIoffset\fP> till den visade filpositionen.
.TP
\fI\-p\fP | \fI\-ps\fP | \fI\-postscript\fP | \fI\-plain\fP
Utdata i PostScript\-format med kontinuerlig hexdump. Kallas �ven vanlig
hexdump.
.TP
\fI\-r\fP | \fI\-revert\fP
Omv�nd operation: konvertera (eller patcha) hexdump till bin�r.  Om xxd inte
skriver till stdout, skriver det till sin utdatafil utan att trunka
den. Anv�nd kombinationen \fI\-r \-p\fP f�r att l�sa vanliga hexadecimala
dumpningar utan radnummerinformation och utan en s�rskild
kolumnlayout. Extra blanksteg och radbrytningar �r till�tna var som
helst. Anv�nd kombinationen \fI\-r \-b\fP f�r att l�sa en bitdump ist�llet f�r en
hexdump.
.TP
\fI\-R\fP \fIwhen\fP
I utdata f�rgas b�de hexv�rdet och v�rdet med samma f�rg beroende p�
hexv�rdet. Detta hj�lper fr�mst till att skilja mellan utskrivbara och
icke\-utskrivbara tecken.  \fIwhen\fP �r \fBnever\fP, \fBalways\fP eller \fBauto\fP
(standard: auto).  N�r milj�variabeln \fB$NO_COLOR\fP �r inst�lld inaktiveras
f�rgl�ggningen.
.TP
\fI\-seek offset\fP
N�r det anv�nds efter \fI\-r\fP: �terst�ll med <\fIoffset\fP> l�ggs till i
filpositioner som hittas i hexdump.
.TP
\fI\-s [+][\-]seek\fP
B�rja vid <\fIseek\fP> byte absolut (eller relativ) infile offset.  \fI+ \fPanger att s�kningen �r relativ till den aktuella stdin\-filpositionen
(meningsl�st n�r man inte l�ser fr�n stdin).  \fI\- \fPanger att s�kningen ska
ske s� m�nga tecken fr�n slutet av inmatningen (eller om det kombineras med
\fI+\fP: f�re den aktuella stdin\-filpositionen).  Utan flaggan \-s b�rjar xxd
vid den aktuella filpositionen.
.TP
\fI\-u\fP
Anv�nd versaler f�r hexadecimala bokst�ver. Standard �r gemener.
.TP
\fI\-v\fP | \fI\-version\fP
Visa versionsstr�ng.
.SH VARNINGAR
.PP
\fIxxd \-r\fP finns en inbyggd funktion som utv�rderar radnummerinformation.  Om
utdatafilen �r s�kbar kan radnumren i b�rjan av varje hexdump\-rad vara i fel
ordning, rader kan saknas eller �verlappa varandra. I dessa fall kommer xxd
att lseek(2) till n�sta position. Om utdatafilen inte �r s�kbar �r endast
luckor till�tna, vilka kommer att fyllas med nolltecken.
.PP
\fIxxd \-r\fP genereras aldrig parsningsfel. Skr�p ignoreras tyst.
.PP
N�r du redigerar hexdumps, observera att \fIxxd \-r\fP hoppar �ver allt p�
inmatningsraden efter att ha l�st tillr�ckligt m�nga kolumner med
hexadecimal data (se flaggan \-c). Detta inneb�r ocks� att �ndringar i de
utskrivbara ASCII\- (eller EBCDIC\-) kolumnerna alltid
ignoreras. �terst�llning av en vanlig (eller PostScript) hexdump med xxd \-r
\-p �r inte beroende av r�tt antal kolumner.  H�r tolkas allt som ser ut som
ett par hexadecimala siffror.
.PP
Observera skillnaden mellan
.br
\fI% xxd \-i fil\fP
.br
och
.br
\fI% xxd \-i < fil\fP
.PP
\fIxxd \-s +seek\fP kan skilja sig fr�n \fIxxd \-s seek\fP, eftersom lseek(2)
anv�nds f�r att "spola tillbaka" indata.  Ett '+' g�r skillnad om
indatak�llan �r stdin och om stdins filposition inte �r i b�rjan av filen
n�r xxd startas och f�r sin indata.  F�ljande exempel kan hj�lpa till att
f�rtydliga (eller f�rvirra ytterligare!):
.PP
Spola tillbaka stdin innan l�sning; n�dv�ndigt eftersom `cat' redan har l�st
till slutet av stdin.
.br
\fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fP
.PP
Hexdump fr�n filposition 0x480 (=1024+128) och fram�t. Tecknet "+" betyder
"relativt till aktuell position", s� "128" l�ggs till 1k d�r dd slutade.
.br
\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet" < file\fP
.PP
Hexdump fr�n filposition 0x100 (=1024\-768) och fram�t.
.br
\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 > hex_snippet" < file\fP
.PP
Detta �r dock en s�llsynt situation och anv�ndningen av `+' beh�vs
s�llan. F�rfattaren f�redrar att �vervaka effekten av xxd med strace(1)
eller truss(1) n�r \-s anv�nds.
.SH EXEMPEL
.PP
.br
Skriv ut allt utom de tre f�rsta raderna (hex 0x30 byte) av \fBfile\fP.
.br
\fI% xxd \-s 0x30 fil\fP
.PP
.br
Skriv ut 3 rader (hex 0x30 byte) fr�n slutet av \fBfile\fP.
.br
\fI% xxd \-s \-0x30 fil\fP
.PP
Observera: Resultaten i exemplen nedan �r relevanta f�r xxd.1\-man\-sidan fr�n
maj 2024
.PP
.br
Skriv ut 120 byte som en kontinuerlig hexdump med 20 oktetter per rad.
.br
\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fP
.br
2e544820585844203120224d6179203230323422
.br
20224d616e75616c207061676520666f72207878
.br
64220a2e5c220a2e5c222032317374204d617920
.br
313939360a2e5c22204d616e2070616765206175
.br
74686f723a0a2e5c2220202020546f6e79204e75
.br
67656e74203c746f6e79407363746e7567656e2e
.br

.br
Hexdump de f�rsta 120 byte av denna man\-sida med 12 oktetter per rad.
.br
\fI% xxd \-l 120 \-c 12 xxd.1\fP
.br
00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M
.br
0000000c: 6179 2032 3032 3422 2022 4d61 ay 2024" "Ma
.br
00000018: 6e75 616c 2070 6167 6520 666f manuell sida f�r
.br
00000024: 7220 7878 6422 0a2e 5c22 0a2e r xxd"..\e"..
.br
00000030: 5c22 2032 3173 7420 4d61 7920 \e" 21 maj
.br
0000003c: 3139 3936 0a2e 5c22 204d 616e 1996..\e" Man
.br
00000048: 2070 6167 6520 6175 7468 6f72 sidans f�rfattare
.br
00000054: 3a0a 2e5c 2220 2020 2054 6f6e :..\e" Ton
.br
00000060: 7920 4e75 6765 6e74 203c 746f y Nugent <till
.br
0000006c: 6e79 4073 6374 6e75 6765 6e2e ny@sctnugen.
.PP
.br
Visa endast datumet fr�n filen xxd.1
.br
\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fP
.br
00000033: 3231 7374 204d 6179 2031 3939 36 21 maj 1996
.PP
.br
Kopiera \fBinput_file\fP till \fBoutput_file\fP och l�gg till 100 byte med v�rdet
0x00 i b�rjan.
.br
\fI% xxd input_file | xxd \-r \-s 100 > output_file\fP
.br

.br
Korrigera datumet i filen xxd.1
.br
\fI% echo "0000034: 3574 68" | xxd \-r \- xxd.1\fP
.br
\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fP
.br
00000033: 3235 7468 204d 6179 2031 3939 36 25 maj 1996
.PP
.br
Skapa en fil p� 65537 byte med alla byte 0x00, f�rutom den sista som �r 'A'
(hex 0x41).
.br
\fI% echo "010000: 41" | xxd \-r > fil\fP
.PP
.br
Hexdump denna fil med autoskip.
.br
\fI% xxd \-a \-c 12 fil\fP
.br
00000000: 0000 0000 0000 0000 0000 0000 ............
.br
*
.br
0000fffc: 0000 0000 41 ....A
.PP
Skapa en 1 byte\-fil som inneh�ller ett enda 'A'\-tecken.  Siffran efter '\-r
\-s' l�ggs till radnumren i filen; i praktiken undertrycks de inledande
bytena.
.br
\fI% echo "010000: 41" | xxd \-r \-s \-0x10000 > fil\fP
.PP
Anv�nd xxd som filter i en redigerare som \fBmnv(1)\fP f�r att hexdumpning av
ett omr�de markerat mellan `a' och `z'.
.br
\fI:'a,'z!xxd\fP
.PP
Anv�nd xxd som filter i en redigerare som \fBmnv(1)\fP f�r att �terst�lla en
bin�r hexdump markerad mellan `a' och `z'.
.br
\fI:'a,'z!xxd \-r\fP
.PP
Anv�nd xxd som filter i en redigerare som \fBmnv(1)\fP f�r att �terst�lla en
rad i en hexdump. Flytta mark�ren �ver raden och skriv:
.br
\fI!!xxd \-r\fP
.PP
L�s enskilda tecken fr�n en seriell linje
.br
\fI% xxd \-c1 < /dev/term/b &amp;\fP
.br
\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fP
.br
\fI% echo \-n foo > /dev/term/b\fP
.PP
.SH RETURV�RDEN
F�ljande felv�rden returneras:
.TP
0
inga fel uppt�cktes.
.TP
\-1
operationen st�ds inte \%(\fI\%xxd \-r \-i\fP fortfarande om�jligt).
.TP
1
fel vid tolkning av flaggor.
.TP
2
problem med inmatningsfilen.
.TP
3
problem med utdatafilen.
.TP
4,5
�nskad s�kposition �r ouppn�elig.
.SH "SE �VEN"
uuencode(1), uudecode(1), patch(1)
.br
.SH VARNINGAR
Verktygets konstighet matchar dess skapares hj�rna. Anv�nd helt p� egen
risk. Kopiera filer. Sp�ra dem. Bli en trollkarl.
.br
.SH VERSION
Denna manual sida dokumenterar xxd version 1.7 fr�n 2024\-05.
.SH UPPHOVSPERSON
.br
(c) 1990\-1997 av Juergen Weigert
.br
<jnweiger@informatik.uni\-erlangen.de>
.LP
Distribuera fritt och ange mig som k�lla,
.br
tj�na pengar och dela med mig,
.br
f�rlora pengar och fr�ga inte mig.
.PP
Manualsida skapad av Tony Nugent
.br
<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
.br
Sm� �ndringar av Bram Moolenaar. Redigerat av Juergen Weigert.
.PP
.SH SVENSK �VERS�TTNING
MNV �versattes ursprungligen av Johan Svedberg 2003-2007 och har under 2025
uppdaterats av Daniel Nylander, speciellt manualsidor samt sj�lvMNMNV.
Om du hittar fel i �vers�ttningen, kontakta <tp-sv@listor.tp-sv.se>.