xxd-it.UTF-8.1 (14089B)
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