Visa källa för xxd(1)

= xxd(1) =

== NAMN ==
'''xxd''' — skapa en hexdump eller göra det omvända

== SYNOPSIS ==
<code>xxd -h[elp]</code>

<code>xxd [alternativ] [infil [utfil]]</code>

<code>xxd -r[evert] [alternativ] [infil [utfil]]</code>

== BESKRIVNING ==
'''xxd''' skapar en hexdump av en given fil eller standard in. Det kan också konvertera en hexdump tillbaka till sin ursprungliga binära form. Liksom [[uuencode(1)]] och [[uudecode(1)]] tillåter det överföring av binär data i en ASCII-representation som är säker för e-post, men har fördelen att kunna avkoda till standard ut. Dessutom kan det användas för att göra patchning av binärfiler.

== ALTERNATIV ==
Om ingen ''infil'' anges läses standard in. Om ''infil'' anges som tecknet <code>-</code> tas indata från standard in. Om ingen ''utfil'' anges, eller om <code>-</code> används i dess ställe, skickas resultatet till standard ut.

Observera att en ”lat” parser används som inte kontrollerar mer än den första alternativbokstaven, om inte alternativet följs av en parameter. Blanksteg mellan en enskild alternativbokstav och dess parameter är valfria. Parametrar till alternativ kan anges i decimal, hexadecimal eller oktal notation. Därför är <code>-c8</code>, <code>-c 8</code>, <code>-c 010</code> och <code>-cols 8</code> likvärdiga.

; <code>-a</code> | <code>-autoskip</code>
: Växla autoskip. En ensam <code>*</code> ersätter rader med bara nollbyte. Avstängt som standard.

; <code>-b</code> | <code>-bits</code>
: Växla till dump i bitar i stället för hex. Detta alternativ skriver oktetter som åtta siffror med <code>1</code> och <code>0</code> i stället för en vanlig hex-dump. Varje rad föregås av ett radnummer i hexadecimal form och följs av en ASCII- eller EBCDIC-representation. Växlarna <code>-r</code>, <code>-p</code> och <code>-i</code> fungerar inte med detta läge.

; <code>-c cols</code> | <code>-cols cols</code>
: Formatera <code>&lt;cols&gt;</code> oktetter per rad. Standard är 16 (<code>-i</code>: 12, <code>-ps</code>: 30, <code>-b</code>: 6). Maxvärde är 256.

; <code>-E</code> | <code>-EBCDIC</code>
: Ändra teckenkodningen i den högra kolumnen från ASCII till EBCDIC. Detta ändrar inte den hexadecimala representationen. Alternativet saknar betydelse tillsammans med <code>-r</code>, <code>-p</code> eller <code>-i</code>.

; <code>-g bytes</code> | <code>-groupsize bytes</code>
: Dela upp utdata genom att separera varje grupp om <code>&lt;bytes&gt;</code> byte med ett blanksteg. Ange <code>-g 0</code> för att undertrycka gruppering. Standard är <code>2</code> i normalt läge och <code>1</code> i bitläge. Gruppering gäller inte i postscript- eller include-stil.

; <code>-h</code> | <code>-help</code>
: Skriv en sammanfattning av tillgängliga kommandon och avsluta. Ingen hexdump utförs.

; <code>-i</code> | <code>-include</code>
: Skriv utdata i stil med en C-include-fil. En fullständig statisk arraydefinition skrivs ut, namngiven efter indatafilen, om inte xxd läser från standard in.

; <code>-l len</code> | <code>-len len</code>
: Sluta efter att ha skrivit <code>&lt;len&gt;</code> oktetter.

; <code>-p</code> | <code>-ps</code> | <code>-postscript</code> | <code>-plain</code>
: Skriv utdata i kontinuerlig hexdumpstil för postscript. Kallas också vanlig hexdumpstil.

; <code>-r</code> | <code>-revert</code>
: Omvänd operation: konvertera eller patcha hexdump till binärt. Om utdata inte skrivs till standard ut skriver xxd till utdatafilen utan att trunkera den. Kombinationen <code>-r -p</code> används för att läsa vanliga hex-dumpar utan radnummer och utan särskild kolumnlayout. Extra blanktecken och radbrytningar tillåts överallt.

; <code>-seek offset</code>
: När det används efter <code>-r</code>: gör återställning med <code>&lt;offset&gt;</code> adderat till filpositionerna som hittas i hexdumpen.

; <code>-s [+][-]seek</code>
: Börja vid <code>&lt;seek&gt;</code> byte absolut eller relativ filposition i indatafilen. <code>+</code> betyder att positionen är relativ till aktuell position i standard in. <code>-</code> betyder att positionen ska vara så många tecken från slutet av indata, eller om det kombineras med <code>+</code>, före aktuell position i standard in. Utan <code>-s</code> börjar xxd vid aktuell filposition.

; <code>-u</code>
: Använd stora hexbokstäver. Standard är små bokstäver.

; <code>-v</code> | <code>-version</code>
: Visa versionssträng.

== VARNINGAR ==
<code>xxd -r</code> har viss inbyggd magi när radnummerinformation tolkas. Om utdatafilen är sökbar kan radnumren i början av varje hexdumprad vara i oordning, rader kan saknas eller överlappa. I dessa fall kommer xxd att använda <code>lseek(2)</code> till nästa position. Om utdatafilen inte är sökbar tillåts bara luckor, som då fylls med nollbyte.

<code>xxd -r</code> genererar aldrig tolkningsfel. Skräp hoppas över utan varning.

Vid redigering av hexdumpar bör man notera att <code>xxd -r</code> hoppar över allt på inmatningsraden efter att ha läst tillräckligt många kolumner med hexadecimal data, se alternativet <code>-c</code>. Det betyder också att ändringar i de utskrivbara ASCII- eller EBCDIC-kolumnerna alltid ignoreras. Återställning av en vanlig eller postscript-stil hexdump med <code>xxd -r -p</code> beror inte på korrekt antal kolumner. Allt som ser ut som ett par hexsiffror tolkas då.

Observera skillnaden mellan:

<pre>
% xxd -i file
</pre>

och

<pre>
% xxd -i < file
</pre>

<code>xxd -s +seek</code> kan skilja sig från <code>xxd -s seek</code>, eftersom <code>lseek(2)</code> används för att ”spola tillbaka” indata. Ett <code>+</code> gör skillnad om inmatningskällan är standard in och dess filposition inte står i början av filen när xxd startas.

Följande exempel kan hjälpa till att förtydliga detta:

Spola tillbaka standard in före läsning; detta behövs eftersom <code>cat</code> redan har läst till slutet av standard in.

<pre>
% sh -c "cat > plain_copy; xxd -s 0 > hex_copy" < file
</pre>

Hexdump från filposition <code>0x480</code> (= 1024 + 128) och framåt. <code>+</code>-tecknet betyder ”relativt till den aktuella positionen”, så <code>128</code> läggs till den 1k-position där <code>dd</code> slutade.

<pre>
% sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +128 > hex_snippet" < file
</pre>

Hexdump från filposition <code>0x100</code> (= 1024 - 768).

<pre>
% sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +-768 > hex_snippet" < file
</pre>

Detta är dock en ovanlig situation och användning av <code>+</code> behövs sällan. Författaren föredrar att övervaka effekten av xxd med [[strace(1)]] eller <code>truss(1)</code> när <code>-s</code> används.

== EXEMPEL ==
Skriv ut allt utom de tre första raderna, hex <code>0x30</code> byte, i <code>file</code>.

<pre>
% xxd -s 0x30 file
</pre>

Skriv ut 3 rader, hex <code>0x30</code> byte, från slutet av <code>file</code>.

<pre>
% xxd -s -0x30 file
</pre>

Skriv ut 120 byte som kontinuerlig hexdump med 20 oktetter per rad.

<pre>
% xxd -l 120 -ps -c 20 xxd.1
2e54482058584420312022417567757374203139
39362220224d616e75616c207061676520666f72
20787864220a2e5c220a2e5c222032317374204d
617920313939360a2e5c22204d616e2070616765
20617574686f723a0a2e5c2220202020546f6e79
204e7567656e74203c746f6e79407363746e7567
</pre>

Hexdumpa de första 120 bytena i denna manualsida med 12 oktetter per rad.

<pre>
% xxd -l 120 -c 12 xxd.1
0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A
000000c: 7567 7573 7420 3139 3936 2220 ugust 1996"
0000018: 224d 616e 7561 6c20 7061 6765 "Manual page
0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\
0000030: 220a 2e5c 2220 3231 7374 204d "..\" 21st M
000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\" 
0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut
0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\"    
0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent
000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug
</pre>

Visa bara datumet från filen <code>xxd.1</code>.

<pre>
% xxd -s 0x36 -l 13 -c 13 xxd.1
0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996
</pre>

Kopiera <code>input_file</code> till <code>output_file</code> och lägg till 100 byte med värdet <code>0x00</code> i början.

<pre>
% xxd input_file | xxd -r -s 100 > output_file
</pre>

Patcha datumet i filen <code>xxd.1</code>.

<pre>
% echo "0000037: 3574 68" | xxd -r - xxd.1
% xxd -s 0x36 -l 13 -c 13 xxd.1
0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996
</pre>

Skapa en fil på 65537 byte där alla byte är <code>0x00</code> utom den sista, som är <code>A</code> (<code>0x41</code>).

<pre>
% echo "010000: 41" | xxd -r > file
</pre>

Hexdumpa denna fil med autoskip.

<pre>
% xxd -a -c 12 file
0000000: 0000 0000 0000 0000 0000 0000 ............
*
000fffc: 0000 0000 40 ....A
</pre>

Skapa en fil på 1 byte som innehåller ett enda tecken <code>A</code>. Talet efter <code>-r -s</code> läggs till radnumren som hittas i filen; i praktiken undertrycks de inledande bytena.

<pre>
% echo "010000: 41" | xxd -r -s -0x10000 > file
</pre>

Använd xxd som filter i en editor som [[vim(1)]] för att hexdumpa ett område markerat mellan <code>a</code> och <code>z</code>.

<pre>
:'a,'z!xxd
</pre>

Använd xxd som filter i en editor som [[vim(1)]] för att återställa en binär hexdump markerad mellan <code>a</code> och <code>z</code>.

<pre>
:'a,'z!xxd -r
</pre>

Använd xxd som filter i en editor som [[vim(1)]] för att återställa en rad av en hexdump. Flytta markören till raden och skriv:

<pre>
!!xxd -r
</pre>

Läs enstaka tecken från en seriell linje.

<pre>
% xxd -c1 < /dev/term/b &
% stty < /dev/term/b -echo -opost -isig -icanon min 1
% echo -n foo > /dev/term/b
</pre>

== RETURVÄRDEN ==
Följande felvärden returneras:

# inga fel uppstod
# <code>-1</code> — operationen stöds inte, till exempel är <code>xxd -r -i</code> fortfarande omöjligt
# fel vid tolkning av alternativ
# problem med indatafilen
# problem med utdatafilen
# <code>4</code>, <code>5</code> — önskad seek-position kan inte nås

== SE ÄVEN ==
[[uuencode(1)]], [[uudecode(1)]], [[patch(1)]]

== VARNINGAR ==
Verktygets märklighet matchar dess skapares hjärna. Används helt på egen risk. Kopiera filer. Spåra det. Bli en trollkarl.

== VERSION ==
Denna manualsida dokumenterar xxd version 1.7.

== FÖRFATTARE ==
(c) 1990–1997 av Juergen Weigert  
: &lt;jnweiger@informatik.uni-erlangen.de&gt;

Distribuera fritt och ge mig erkännande,  
tjäna pengar och dela med mig,  
förlora pengar och fråga mig inte.

Manualsidan påbörjades av Tony Nugent  
: &lt;tony@sctnugen.ppp.gu.edu.au&gt;
: &lt;T.Nugent@sct.gu.edu.au&gt;

Små ändringar av Bram Moolenaar. Redigerad av Juergen Weigert.