# User manual for GHex

GHex is a simple binary editor. It lets users view and edit a binary file in both hex and ascii with a multiple level undo/redo mechanism. Features include find and replace functions, conversion between binary, octal, decimal and hexadecimal values, and use of an alternative, user-configurable MDI concept that lets users edit multiple documents with multiple views of each.

2002
2003
2004
Sun Microsystems
1998-2000
Jaka Mocnik
GNOME Documentation Project
Sun
GNOME Documentation Team
Sun Microsystems

Jaka
Mocnik
GNOME Documentation Project

     jaka@gnu.org

GHex Manual V2.5
December 2005

Sun GNOME Documentation Team

GNOME Documentation Project

GHex Manual V2.4
April 2003

Sun GNOME Documentation Team

GNOME Documentation Project

GHex Manual V2.3
August 2002

Sun GNOME Documentation Team

GNOME Documentation Project

GHex Manual V2.2
August 2002

Sun GNOME Documentation Team

GNOME Documentation Project

GHex Manual V2.1
July 2002

Sun GNOME Documentation Team

GNOME Documentation Project

GHex Manual V2.0
March 2002

Sun GNOME Documentation Team

GNOME Documentation Project

GHex Manual V1.0
2000

Jaka Mocnik jaka@gnu.org

GNOME Documentation Project

This manual describes version 2.19 of GHex.

## Commenti

To report a bug or make a suggestion regarding the GHex application or this manual, follow the directions in the GNOME Feedback Page.

## Introduzione

L'applicazione GHex permette di eseguire le seguenti azioni:

- Visualizzare un file simultaneamente in formato ASCII e esadecimale.

- Modificare un file in formato ASCII o esadecimale.

## Per iniziare

### Avviare GHex

Sono disponibili i seguenti metodi per avviare GHex:

Menu Programmi

  Scegliere Accessori Editor esadecimale.

Riga di comando

  Execute the following command: `ghex`

### Avvio di GHex

All'avvio di GHex viene visualizzata la finestra seguente.

#### La finestra di GHex prima dell'apertura di un file

Shows GHex main window before you open a file.

### Aprire un file

Per aprire un file, scegliere File Apri. Selezionare il file da aprire e fare clic su OK. GHex consente di aprire contemporaneamente più file. GHex visualizza ogni file in una nuova finestra.

Dopo avere aperto un file in GHex, l'applicazione visualizza il file nella finestra seguente.

#### Finestra di GHex con un file aperto

Shows GHex main window with an open file

La finestra di GHex contiene i seguenti elementi:

Barra dei menu

  I menu contengono tutti i comandi utilizzati per eseguire le varie attività sui file in GHex.

Colonna della posizione del cursore

  La posizione del cursore rappresenta la distanza tra l'inizio del file e il primo byte di ogni riga. Nell'impostazione predefinita, GHex visualizza la colonna delle posizioni alla sinistra della visualizzazione esadecimale.

Riquadro di visualizzazione di sinistra

  Il riquadro di visualizzazione posto nella parte sinistra dello schermo contiene una vista del file in formato esadecimale.

Riquadro di visualizzazione di destra

  Il riquadro di visualizzazione posto nella parte destra dello schermo contiene una vista del file in formato ASCII.

Type conversion dialog

  The type conversion dialog below the display area displays the value of the selected character in several different numeric types.

## Utilizzo

### Modificare un file

Per modificare un file, procedere come segue:

1. Fare clic nell'area della visualizzazione ASCII o esadecimale del file. Nella visualizzazione in cui il cursore è attivo compare un cursore completo. Nella visualizzazione in cui il cursore non è attivo, compare solo il contorno del cursore.

2. Usare uno dei metodi seguenti per spostare il cursore all'interno del file:

   - Use the scrollbar on the window or the arrow keys on the keyboard to scroll through the file.

   - Scegliere Modifica Vai al byte, digitare il valore decimale o esadecimale della posizione e fare clic su OK. Per indicare un valore esadecimale, utilizzare il formato 0x seguito dalla posizione, ad esempio 0x3.

3. Edit the ASCII format in the same way you edit a normal text file. To edit the hexadecimal format, use the values 0 to 9 and a to f.

To insert data and not overwrite existing data, choose Edit Insert Mode.

To cut, copy, and paste data, choose Edit Cut, Edit Copy, and Edit Paste.

To undo an edit, choose Edit Undo. To redo an edit, choose Edit Redo. The number of previous edits that you can undo is determined by the Maximum number of undo levels setting in the tabbed section of the Preferences dialog.

### Salvare un file

Sono disponibili i seguenti metodi per salvare un file:

- Per salvare le modifiche al file corrente, scegliere File Salva.

- Per salvare il file corrente con un nuovo nome, scegliere File Salva con nome. Inserire il nome del file nella finestra di dialogo Selezionare un file in cui salvare il buffer e fare clic su OK.

### To Revert to the Last Saved Version of a File

To revert to the last version of the current file that you saved and undo all of the edits that you made to the file since you last saved the file, choose File Revert, then click Yes in the Question dialog.

### Trovare le informazioni all'interno di un file

Per ricercare una stringa esadecimale o ASCII all'interno di un file, procedere come segue:

1. Scegliere Modifica Trova.

2. Nella finestra di dialogo Trova dati, scegliere una delle seguenti opzioni:

   - Search for hex data

   - Search for ASCII data

3. Digitare la stringa da trovare.

4. Per trovare la successiva occorrenza, fare clic su Trova successivo.

5. Fare clic su Trova precedente per trovare la precedente occorrenza della stringa.

6. Click Cancel to close the Find Data dialog.

### To Perform an Advanced Find

To perform an advanced find, perform the following steps:

1. Choose Edit Advanced Find.

2. In the Find Data dialog, select the required search criteria. For information about how to add new search criteria, see .

3. Per trovare la successiva occorrenza, fare clic su Trova successivo.

4. Fare clic su Trova precedente per trovare la precedente occorrenza della stringa.

5. Click Close to close the Find Data dialog.

### To Add Search Criteria

To add search criteria, perform the following steps:

1. Choose Edit Advanced Find.

2. In the Find Data dialog, click Add New.

3. In the Find Data: Add Search dialog, choose one of the following options:

   - Search for hex data

   - Search for ASCII data

4. Digitare la stringa da trovare.

5. Use the color wheel or the spin boxes to select a color to highlight the search criteria.

6. Click Add.

7. Click Cancel to close the Find Data dialog.

### To Remove Search Criteria

To remove search criteria, perform the following steps:

1. Choose Edit Advanced Find.

2. In the Find Data dialog, select the search criteria that you want to remove.

3. Click Remove Selected.

4. Click Cancel to close the Find Data dialog.

### Trovare e sostituire i dati in un file

Per ricercare una stringa esadecimale o ASCII all'interno di un file e sostituirla con una differente, procedere come segue:

1. Scegliere Modifica Sostituisci.

2. Nella finestra di dialogo Cerca e sostituisci dati, scegliere una delle seguenti opzioni:

   - Replace hex data

   - Replace ASCII data

3. Nella prima casella di testo, digitare la stringa da trovare.

4. Nella seconda casella di testo, digitare la stringa con cui sostituire la stringa trovata.

5. Fare clic su Trova successivo.

6. Fare clic su Sostituisci per sostituire la prima stringa individuata, o fare clic su Sostituisci tutto per sostituire la stringa in tutto il file.

7. Click Cancel to close the Find & Replace Data dialog.

### Aggiungere o rimuovere visualizzazioni supplementari di un file

To add another view of the current file to your GHex window, choose View Add View.

Per rimuovere una visualizzazione del file corrente, scegliere Visualizzazione Rimuovi visualizzazione. Quando viene rimossa l'ultima vista aperta, l'applicazione si chiude.

### To Change the Data Group Type

To change how GHex displays the hexadecimal content of a file in the GHex window, choose View Group Data As, then select one of the following menu items:

- Bytes - single bytes

- Words - groups of two bytes

- Longwords - groups of four bytes

### Esportare la visualizzazione di GHex in formato HTML

To export the data contained in the GHex window to HTML, choose File Save As HTML. Choose a directory and specify a filename for the HTML file, then click OK. GHex implements the following actions:

- Creates a separate HTML file for each page of data that is displayed in the GHex window.

- Uses the HTML filename that you specify as the basis for the filename.

- Appends a page number to the filename to differentiate the files.

For example, if you specify the filename `log.html`, GHex creates a series of HTML files named `log00000000.html`, `log00000001.html`, `log00000002.html`, and so on.

### Visualizzare una tabella caratteri

Per visualizzare una tabella che contiene le rappresentazioni ASCII, esadecimale, decimale, ottale e binaria dei valori da 0 a 255, scegliere Finestre Tabella caratteri.

### Visualizzare le conversioni di dati

Per visualizzare le conversioni binaria, decimale, esadecimale e ASCII per un gruppo di dati (fino a 4 byte), procedere come segue:

1. Scegliere Finestre Convertitore basi.

2. Eseguire una delle seguenti azioni:

   - Digitare i dati da convertire in uno dei campi della finestra di dialogo Convertitore basi, quindi premere Return.

   - Per visualizzare il valore di conversione dei dati relativi alla posizione del cursore nel file corrente, fare clic sul pulsante Ottieni valore al cursore.

   GHex aggiorna i valori degli altri campi per visualizzare le conversioni.

3. Click Close to close the Base Converter dialog.

### To Show or Hide the Type Conversion Dialog

To show or hide the type conversion dialog, choose Windows Type Conversion Dialog.

The type conversion dialog displays the value of the selected character in the following representations:

- Signed 8 bit

- Unsigned 8 bit

- Signed 16 bit

- Unsigned 16 bit

- Signed 32 bit

- Unsigned 32 bit

- 32 bit float

- 64 bit float

- Hexadecimal

- Octal

- Binary

- Stream Length

The type conversion dialog also contains the following options:

Show little endian decoding

  Select this option to show little endian decoding.

Show unsigned and float as hexadecimal

  Select this option to show unsigned and float numbers as hexadecimal numbers.

### Stampare un file

Per stampare un file, scegliere File Stampa. Selezionare le opzioni di stampa appropriate nella finestra di dialogo Stampa, quindi fare clic su OK.

Per visualizzare un'anteprima di stampa del file, scegliere File Anteprima di stampa.

## Preferenze

Per configurare GHex, scegliere Modifica Preferenze. La finestra di dialogo Preferenze contiene le seguenti schede:

### Editing

Maximum number of undo levels

  Use this spin box to specify the maximum number of edits that you can undo.

Show cursor offset in statusbar as

  Use this drop-down list to select the format in which the cursor offset is displayed. The format can be decimal, hexadecimal, or a custom print style string that only contains the format specifiers x, o, and s.

Show offsets column

  Selezionare questa opzione per visualizzare la posizione del cursore in una colonna posta a sinistra della visualizzazione esadecimale della finestra di GHex.

### Visualizzazione

Font

  Use the font selector list boxes to edit the existing font information or type new font information. Specify a font type, style, and size to display the contents of files in GHex.

Default Group Type

  Select one of the following options to specify how GHex displays the hexadecimal content of a file in the GHex window:

  - Bytes - single bytes

  - Words - groups of two bytes

  - Longwords - groups of four bytes

### Stampa

Data font

  Click on the Data font button to specify the font type, style, and size to use to print the data contained in a file.

Header font

  Click on the Header font button to specify the font type, style, and size to use to print the header information that is contained in the file.

Print shaded box over

  Use this spin box to specify the number of lines that GHex alternately prints with a surrounding shaded box. If the value of the spin box is 10, GHex prints the first 10 lines of the file without a shaded box, the next 10 lines with a shaded box, and so on. If the value of the spin box is 0, GHex does not print any shaded box.