vim

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

xxd-it.1 (14052B)


      1 .TH XXD 1 "Mar 2026" "Pagina di manuale per 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 NOME
      8 .I xxd
      9 \- Produce lista esadecimale da un file binario o viceversa.
     10 .SH SINTASSI
     11 .B xxd
     12 \-h[elp]
     13 .br
     14 .B xxd
     15 [opzioni] [input_file [output_file]]
     16 .br
     17 .B xxd
     18 \-r[evert] [opzioni] [input_file [output_file]]
     19 .SH DESCRIZIONE
     20 .I xxd
     21 crea un'immagine esadecimale di un dato file o dello `standard input'.
     22 Può anche ricostruire da un'immagine esadecimale il file binario originale.
     23 Come
     24 .BR uuencode (1)
     25 e
     26 .BR uudecode (1)
     27 permette di trasmettere dati binari in una rappresentazione ASCII `a prova
     28 di email', ma ha anche il vantaggio di poter decodificare sullo `standard output'.
     29 Inoltre, può essere usato per effettuare delle modifiche (patch) a file binari.
     30 .SH OPZIONI
     31 Se non si specifica un
     32 .I input_file
     33 il programma legge dallo `standard input'.
     34 Se
     35 .I input_file
     36 è specificato come il carattere
     37 .RB \` \- '
     38 , l'input è letto dallo `standard input'.
     39 Se non si specifica un
     40 .I output_file
     41 (o si mette al suo posto il carattere
     42 .RB \` \- '
     43 ), i risultati sono inviati allo `standard output'.
     44 .PP
     45 Si noti che la scansione dei caratteri è "pigra", e non controlla oltre la prima
     46 lettera di un'opzione, a meno che l'opzione sia seguita da un parametro.
     47 Gli spazi fra una singola lettera di opzione e il relativo parametro sono facoltativi.
     48 I parametri delle opzioni possono essere specificati usando la notazione
     49 decimale, esadecimale oppure ottale.
     50 Pertanto
     51 .BR \-c8 ,
     52 .BR "\-c 8" ,
     53 .B \-c 010
     54 e
     55 .B \-cols 8
     56 sono tutte notazioni equivalenti fra loro.
     57 .PP
     58 .TP
     59 .IR \-a " | " \-autoskip
     60 Richiesta di omissione: Un singolo '*' rimpiazza righe a zeri binari. Default: off.
     61 .TP
     62 .IR \-b " | " \-bits
     63 Richiesta di un'immagine binaria (cifre binarie), invece che esadecimale.
     64 Quest'opzione scrive un byte come otto cifre "1" e "0" invece di usare i
     65 numeri esadecimali. Ogni riga è preceduta da un indirizzo in esadecimale e
     66 seguita da una decodifica ASCII (o EBCDIC). L'opzione \-p, specificabile
     67 dalla riga comando, non funziona in questo modo. Può essere combinata
     68 con l'opzione \-i.
     69 .TP
     70 .IR "\-c colonne " | " \-cols colonne"
     71 In ogni riga sono formattate
     72 .RI < colonne >
     73 colonne. Valore di default 16 (\-i: 12, \-ps: 30, \-b: 6).
     74 Non c'è un valore massimo per \-ps; se si specifica 0 viene scritta un'unica lunga riga di output.
     75 .TP
     76 .IR \-C " | " \-capitalize
     77 Mette in maiuscolo i nomi di variabili nello stile delle `include' C, se si usa \-i.
     78 .TP
     79 .I \-d
     80 Mostra spostamenti usando numeri decimali invece che esadecimali.
     81 .TP
     82 .IR \-E " | " \-EBCDIC
     83 Cambia la codifica della colonna di destra da ASCII a EBCDIC.
     84 Questo non modifica la rappresentazione esadecimale. Non ha senso
     85 specificare quest'opzione in combinazione con \-r, \-p o \-i.
     86 .TP
     87 .IR \-e
     88 Considera la lista esadecimale come avente codifica `little-endian'.
     89 Quest'opzione tratta i gruppi di byte come parole in codifica `little-endian'.
     90 Il raggruppamento di default dei byte a 4 a 4 può essere cambiato usando
     91 .RI "" \-g .
     92 Quest'opzione si applica solo alla lista esadecimale, Lasciando inalterata
     93 la rappresentazione ASCII (or EBCDIC).
     94 Le opzioni della riga di comando
     95 \-r, \-p, \-i non funzionano in questa modalità.
     96 .TP
     97 .IR "\-g numero " | " \-groupsize numero"
     98 Separa ogni gruppo di
     99 .RI < numero >
    100 byte in output (di due caratteri esadecimali o otto caratteri binari ognuno) con uno spazio bianco.
    101 Specificando
    102 .I \-g 0
    103 i byte di output non sono separati da alcuno spazio.
    104 .RI < Numero "> ha come valore di default " 2
    105 in modalità normale [esadecimale], \fI4\fP in modalità `little-endian' e \fI1\fP in modalità binaria.
    106 Il raggruppamento non si applica agli stili `PostScript' e `include'.
    107 .TP
    108 .IR \-h " | " \-help
    109 Stampa un sommario dei comandi disponibili ed esce.  Non viene fatto null'altro.
    110 .TP
    111 .IR \-i " | " \-include
    112 L'output è un file `include' scritto in C.  Viene preparata la definizione
    113 completa del vettore (col nome del file di input), tranne quando xxd legge
    114 dallo `standard input'. Può essere combinata con l'opzione \-b.
    115 .TP
    116 .IR "\-l numero " | " \-len numero"
    117 Il programma esce dopo aver scritto
    118 .RI  < numero >
    119 byte.
    120 .TP
    121 .I "\-n nome " | " \-name nome"
    122 Specifica il nome del vettore in output quando si usa \-i. Il vettore viene chiamato
    123 \fInome\fP e la sua lunghezza viene chiamata \fInome\fP_len.
    124 .TP
    125 .I \-o incremento
    126 Aggiunge
    127 .RI < incremento >
    128 alla posizione visualizzata dei byte del file.
    129 .TP
    130 .IR \-p " | " \-ps " | " \-postscript " | " \-plain
    131 L'output è nello stile di un dump esadecimale continuo sotto postscript.
    132 Noto anche come stile esadecimale semplice.
    133 .TP
    134 .IR \-r " | " \-revert
    135 Ricostruisce: converte (o mette una patch) da immagine esadecimale, a file binario.
    136 Se non scrive sullo `standard output', xxd scrive nel file di output in maniera
    137 continua, senza interruzioni.  Usare la combinazione
    138 .I \-r \-p
    139 per leggere un dump in stile esadecimale semplice, senza l'informazione del numero
    140 di riga e senza un particolare tracciato di colonna.  Spazi o righe vuote
    141 possono essere presenti dappertutto [e vengono ignorati]. Usare la combinazione
    142 .I \-r \-b
    143 per leggere un dump binario, invece che un dump esadecimale.
    144 .TP
    145 .IR \-R " "[quando]
    146 Nell'output sia le colonne con i dati (esadecimali, o binari - con \-b)
    147 che quelle con i caratteri corrispondenti hanno entrambe
    148 lo stesso colore, a seconda del valore del byte. Utile soprattutto a
    149 distinguere i caratteri stampabili da quelli non stampabili.
    150 .I quando
    151 può assumere i valori
    152 .BR never ", " always ", o " auto " (default: auto).
    153 Quando la variabile d'ambiente
    154 .BR $NO_COLOR
    155 è impostata, la colorazione viene disabilitata.
    156 .TP
    157 .I \-seek distanza
    158 Usato con l'opzione
    159 .IR \-r :
    160 (ricostruzione),
    161 .RI < distanza >
    162 viene aggiunta alla posizione nel file trovata nella immagine esadecimale.
    163 .TP
    164 .I \-s [+][\-]seek
    165 Inizia a
    166 .RI < seek >
    167 byte assoluti (o relativi) di distanza all'interno di input_file.
    168 \fI+ \fRindica che il `seek' è relativo alla posizione corrente nel file `standard input'
    169 (non significativo quando non si legge da `standard input'). \fI\- \fRindica che il
    170 `seek' dovrebbe posizionarsi al numero specificato di caratteri dalla fine dell'input
    171 (o se in combinazione con \fI+ \fR: prima della posizione corrente nel file `standard input').
    172 Se non si specifica l'opzione \-s, xxd inizia dalla posizione corrente all'interno del file.
    173 .TP
    174 .I \-t
    175 Quando l'output è nello stile delle `include' di C (opzione \-i ) aggiungere uno zero binario a fine stringa.
    176 .TP
    177 .I \-u
    178 Usare lettere esadecimali maiuscole. Per default si usano lettere minuscole.
    179 .TP
    180 .IR \-v " | " \-version
    181 Visualizzare la stringa contenente la versione del programma.
    182 .SH ATTENZIONE
    183 .PP
    184 .I xxd \-r
    185 è capace di operare "magie" nell'utilizzare l'informazione "numero di riga".
    186 Se è possibili posizionarsi tramite `seek' sul file di output, il numero di riga
    187 di ogni riga esadecimale può essere non ordinato, delle righe possono mancare, o
    188 sovrapporsi. In tal caso xxd userà lseek(2) per posizionarsi all'interno del file.
    189 Se per il file di output non si può usare `seek', sono permessi solo dei "buchi",
    190 che saranno riempiti con zeri binari.
    191 .PP
    192 .I xxd \-r
    193 non genera mai errori per parametri errati. I parametri extra sono silenziosamente ignorati.
    194 .PP
    195 Nel modificare immagini esadecimali, si tenga conto che
    196 .I xxd \-r
    197 salta il resto della riga, dopo aver letto i caratteri contenenti dati esadecimali
    198 (vedere opzione \-c). Ciò implica pure che le modifiche alle colonne di caratteri
    199 stampabili ASCII (o EBCDIC) sono sempre ignorate. La ricostruzione da un file immagine
    200 esadecimale in stile semplice (postscript) con xxd \-r \-p non dipende dal numero
    201 corretto di colonne.
    202 In questo caso, qualsiasi cosa assomigli a una coppia di cifre esadecimali è
    203 interpretata [e utilizzata].
    204 .PP
    205 Notare la differenza fra
    206 .br
    207 \fI% xxd \-i file\fR
    208 .br
    209 e
    210 .br
    211 \fI% xxd \-i \< file\fR
    212 .PP
    213 .I xxd \-s \+seek
    214 può comportarsi in modo diverso da
    215 .IR "xxd \-s seek" ,
    216 perché lseek(2) è usata per tornare indietro nel file di input.  Il '+'
    217 fa differenza se il file di input è lo `standard input', e se la posizione nel
    218 file di `standard input' non è all'inizio del file quando xxd è eseguito, e riceve input.
    219 I seguenti esempi possono contribuire a chiarire il concetto (o ad oscurarlo!)...
    220 .PP
    221 Riavvolge lo `standard input' prima di leggere; necessario perché `cat'
    222 ha già letto lo stesso file fino alla fine dello `standard input'.
    223 .br
    224 \fI% sh \-c "cat > copia_normale; xxd \-s 0 > copia_esadecimale" < file\fR
    225 .PP
    226 Stampa immagine esadecimale dalla posizione file 0x480 (=1024+128) in poi.
    227 Il segno `+' vuol dire "rispetto alla posizione corrente", quindi il `128'
    228 si aggiunge a 1k (1024) dove `dd' si era fermato.
    229 .br
    230 \fI% sh \-c "dd of=normale bs=1k count=1; xxd \-s +128 > esadecimale" < file\fR
    231 .PP
    232 Immagine esadecimale dalla posizione 0x100 (=1024\-768 ) del file in avanti.
    233 .br
    234 \fI% sh \-c "dd of=normale bs=1k count=1; xxd \-s +\-768 > esadecimale" < file\fR
    235 .PP
    236 Comunque, questo capita raramente, e l'uso del `+' non serve quasi mai.
    237 L'autore preferisce monitorare il comportamento di xxd con strace(1) o truss(1),
    238 quando si usa l'opzione \-s.
    239 .SH ESEMPI
    240 .PP
    241 .br
    242 Stampa tutto tranne le prime tre righe (0x30 byte in esadecimale) di
    243 .BR file .
    244 .br
    245 \fI% xxd \-s 0x30 file\fR
    246 .PP
    247 .br
    248 Stampa 3 righe (0x30 byte in esadecimale) alla fine di
    249 .BR file .
    250 .br
    251 \fI% xxd \-s \-0x30 file\fR
    252 .PP
    253 Nota: I risultati degli esempi seguenti sono riferiti alla versione di
    254 Marzo 2026 della pagina di manuale [quella che state leggendo].
    255 .PP
    256 .br
    257 Stampa 120 byte come immagine esadecimale continua con 20 byte per riga.
    258 .br
    259 \fI% xxd \-l 120 \-ps \-c 20 xxd-it.UTF-8.1\fR
    260 .br
    261 2e544820585844203120224d6172203230323622
    262 .br
    263 2022506167696e61206469206d616e75616c6520
    264 .br
    265 70657220787864220a2e5c220a2e5c2220323173
    266 .br
    267 74204d617920313939360a2e5c22204d616e2070
    268 .br
    269 61676520617574686f723a0a2e5c222020202054
    270 .br
    271 6f6e79204e7567656e74203c746f6e7940736374
    272 .br
    273 
    274 .br
    275 Stampa i primi 120 byte di questa pagina di manuale a 12 byte per riga.
    276 .br
    277 \fI% xxd \-l 120 \-c 12 xxd-it.UTF-8.1\fR
    278 .br
    279 00000000: 2e54 4820 5858 4420 3120 224d  .TH XXD 1 "M
    280 .br
    281 0000000c: 6172 2032 3032 3622 2022 5061  ar 2026" "Pa
    282 .br
    283 00000018: 6769 6e61 2064 6920 6d61 6e75  gina di manu
    284 .br
    285 00000024: 616c 6520 7065 7220 7878 6422  ale per xxd"
    286 .br
    287 00000030: 0a2e 5c22 0a2e 5c22 2032 3173  ..\\"..\\" 21s
    288 .br
    289 0000003c: 7420 4d61 7920 3139 3936 0a2e  t May 1996..
    290 .br
    291 00000048: 5c22 204d 616e 2070 6167 6520  \\" Man page 
    292 .br
    293 00000054: 6175 7468 6f72 3a0a 2e5c 2220  author:..\\" 
    294 .br
    295 00000060: 2020 2054 6f6e 7920 4e75 6765     Tony Nuge
    296 .br
    297 0000006c: 6e74 203c 746f 6e79 4073 6374  nt <tony@sct
    298 .PP
    299 .br
    300 Visualizza la data della prima versione di questa pagina dal file xxd-it.UTF-8.1
    301 .br
    302 \fI% xxd \-s 0x39 \-l 13 \-c 13 xxd-it.UTF-8.1\fR
    303 .br
    304 00000039: 3231 7374 204d 6179 2031 3939 36  21st May 1996
    305 .PP
    306 .br
    307 Copia
    308 .B input_file
    309 su
    310 .B output_file
    311 premettendogli 100 byte a 0x00.
    312 .br
    313 \fI% xxd input_file | xxd \-r \-s 100 > output_file\fR
    314 .br
    315 
    316 .br
    317 Modifica (patch) la data nel file xxd-it.UTF-8.1
    318 .br
    319 \fI% echo "0000039: 3331" | xxd \-r \- xxd-it.UTF-8.1\fR
    320 .br
    321 \fI% xxd \-s 0x39 \-l 13 \-c 13 xxd-it.UTF-8.1\fR
    322 .br
    323 00000039: 3331 7374 204d 6179 2031 3939 36  31st May 1996
    324 .PP
    325 .br
    326 Crea un file di 65537 byte tutto a 0x00,
    327 tranne l'ultimo carattere che è una 'A' (esadecimale 0x41).
    328 .br
    329 \fI% echo "010000: 41" | xxd \-r > file\fR
    330 .PP
    331 .br
    332 Stampa un'immagine esadecimale del file di cui sopra con opzione autoskip.
    333 .br
    334 \fI% xxd \-a \-c 12 file\fR
    335 .br
    336 00000000: 0000 0000 0000 0000 0000 0000  ............
    337 .br
    338 *
    339 .br
    340 0000fffc: 0000 0000 41                   ....A
    341 .PP
    342 Creare un file di 1 byte che contiene il solo carattere 'A'.
    343 Il numero dopo '\-r \-s' viene aggiunto a quello trovato nel file;
    344 in pratica, i byte precedenti non sono stampati.
    345 .br
    346 \fI% echo "010000: 41" | xxd \-r \-s \-0x10000 > file\fR
    347 .PP
    348 Usare xxd come filtro all'interno di un editor come
    349 .B vim(1)
    350 per ottenere l'immagine esadecimale della parte di file fra i marcatori `a' e `z'.
    351 .br
    352 \fI:'a,'z!xxd\fR
    353 .PP
    354 Usare xxd come filtro all'interno di un editor come
    355 .B vim(1)
    356 per ricostruire un pezzo di file binario da un'immagine esadecimale fra i marcatori `a' e `z'.
    357 .br
    358 \fI:'a,'z!xxd \-r\fR
    359 .PP
    360 Usare xxd come filtro all'interno di un editor come
    361 .B vim(1)
    362 per ricostruire una sola riga di file binario da un'immagine esadecimale. Portare il cursore sopra la riga e battere:
    363 .br
    364 \fI!!xxd \-r\fR
    365 .PP
    366 Leggere singoli caratteri da una linea seriale
    367 .br
    368 \fI% xxd \-c1 < /dev/term/b &\fR
    369 .br
    370 \fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR
    371 .br
    372 \fI% echo \-n foo > /dev/term/b\fR
    373 .PP
    374 Output nello stile delle `include' di C (opzione \-i ) con uno zero binario a fine stringa
    375 .br
    376 \fI% echo -n \&"0123456789\&" > cifre\fR
    377 .br
    378 \fI% xxd -i -t cifre\fR
    379 .br
    380 unsigned char cifre[] = {
    381 .br
    382   0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x00
    383 .br
    384 };
    385 .br
    386 unsigned int cifre_len = 10;
    387 .PP
    388 .SH CODICI DI RITORNO
    389 Il programma può restituire questi codici di errore:
    390 .TP
    391 0
    392 nessun errore rilevato.
    393 .TP
    394 \-1
    395 operazione non supportata
    396 \%(\c
    397 .I xxd \-r \-i
    398 non ancora possible).
    399 .TP
    400 1
    401 errore durante la scansione parametri.
    402 .TP
    403 2
    404 problemi con il file di input.
    405 .TP
    406 3
    407 problemi con il file di output.
    408 .TP
    409 4,5
    410 posizione `seek' specificata non raggiungibile all'interno del file.
    411 .SH VEDERE ANCHE
    412 uuencode(1), uudecode(1), patch(1)
    413 .br
    414 .SH AVVERTIMENTI
    415 La stranezza dello strumento rispecchia la mente del suo creatore.
    416 Usate a vostro rischio e pericolo. Copiate i file. Tracciate l'esecuzione. Diventate un mago.
    417 .br
    418 .SH VERSIONE
    419 Questa pagina di manuale documenta la versione 1.7 di xxd del maggio 2024.
    420 .SH AUTORE
    421 .br
    422 (c) 1990-1997 Juergen Weigert
    423 .br
    424 <jnweiger@informatik.uni\-erlangen.de>
    425 .LP
    426 Distribuite liberamente ed attribuitemi il credito,
    427 .br
    428 fate soldi e condivideteli con me
    429 .br
    430 perdete soldi e non venite a chiederli a me.
    431 .PP
    432 Pagina di manuale iniziata da Tony Nugent
    433 .br
    434 <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>
    435 .br
    436 Piccole modifiche di Bram Moolenaar.
    437 Modificato da Juergen Weigert.
    438 .PP